Примеры API-запросов

Введение

Кроме получения сводных отчётов (описано в руководстве AIO API — Pivot Report Endpoint), через API можно выполнять и другие действия. В этом руководстве собрано несколько примеров.

Прежде чем работать с API, убедитесь, что у вас есть API token: его можно запросить у нашей поддержки. Токен наследует роль и права пользователя AIO, для которого он выпущен. Например, если у пользователя нет доступа к Campaigns, API-запросы, связанные с Campaigns, для этого токена будут недоступны.

Запросы можно посмотреть в DevTools → Network → Data и переиспользовать их, добавив API-токен как параметр запроса (?token=xxx). Обратите внимание: эти запросы не являются частью публичного API и могут измениться без предупреждения.

Запрос сводного отчёта

Подробнее в руководстве AIO API — Pivot Report Endpoint.

curl --location 'https://app.aio.tech/api/v1/pivot-report/data?token=XXX' \
--header 'Content-Type: application/json' \
--data '{
"dates": [
"2026-04-01 00:00:00",
"2026-04-31 23:59:59"
],
"back_fix_attribution": false,
"event_time_attribution": false,
"hide_bots": true,
"hide_empty_metrics": true,
"hide_trash": true,
"conditions": [],
"definitions": [
{"key": "campaign_owner_uuid"},
{"key": "location_country_code"}
]
}'

Запросы таблиц

Получить домены:

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
"request": {
"MTK\\Domains": {
"table": "MTK\\Domains",
"page": 1,
"limit": 100,
"search": "",
"sort_key": "",
"sort_direction": "asc",
"analytics_position": 1,
"filters": [],
"dates": [],
"hide_empty_metrics": true,
"hide_bots": true,
"unwrap_tree": false,
"hide_trash": true,
"event_time_attribution": false,
"back_fix_attribution": false,
"metric_filters": [],
"metric_definition": null,
"metric_definitions": []
}
}
}

Получить серверы

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
"request": {
"MTK\Settings\Servers": {
"table": "MTK\Settings\Servers",
"page": 1,
"limit": 100,
"search": "",
"sort_key": "",
"sort_direction": "asc",
"analytics_position": 1,
"filters": [],
"dates": [],
"hide_empty_metrics": true,
"hide_bots": true,
"unwrap_tree": false,
"hide_trash": true,
"event_time_attribution": false,
"back_fix_attribution": false,
"metric_filters": [],
"metric_definition": null,
"metric_definitions": []
}
}
}

Получить DNS-провайдеров

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
"request": {
"MTK\Settings\DnsProviders": {
"table": "MTK\Settings\DnsProviders",
"page": 1,
"limit": 100,
"search": "",
"sort_key": "",
"sort_direction": "asc",
"analytics_position": 1,
"filters": [],
"dates": [],
"hide_empty_metrics": true,
"hide_bots": true,
"unwrap_tree": false,
"hide_trash": true,
"event_time_attribution": false,
"back_fix_attribution": false,
"metric_filters": [],
"metric_definition": null,
"metric_definitions": []
}
}
}

Получить лендинги

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
"request": {
"MTK\\Landers": {
"table": "MTK\\Landers",
"page": 1,
"limit": 100,
"search": "",
"sort_key": "updated_at",
"sort_direction": "desc",
"analytics_position": 1,
"filters": [],
"dates": [
"2025-08-25 00:00:00",
"2025-08-25 23:59:59",
"Europe/Moscow"
],
"hide_empty_metrics": false,
"event_time_attribution": false,
"metric_filters": [],
"metric_definition": null
}
}
}

Получить пользователей

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
"request": {
"MTK\Settings\Users": {
"table": "MTK\Settings\Users",
"page": 1,
"limit": 100,
"search": "",
"sort_key": "",
"sort_direction": "asc",
"analytics_position": 1,
"filters": [],
"dates": [],
"hide_empty_metrics": true,
"hide_bots": true,
"unwrap_tree": false,
"hide_trash": true,
"event_time_attribution": false,
"back_fix_attribution": false,
"metric_filters": [],
"metric_definition": null,
"metric_definitions": []
}
}
}

Получить теги

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
"request": {
"Settings\\Tags": {
"table": "Settings\\Tags",
"page": 1,
"limit": 100,
"search": "",
"sort_key": "",
"sort_direction": "asc",
"analytics_position": 1,
"filters": [],
"dates": [],
"hide_empty_metrics": true,
"hide_bots": true,
"unwrap_tree": false,
"hide_trash": true,
"event_time_attribution": false,
"back_fix_attribution": false,
"metric_filters": [],
"metric_definition": null,
"metric_definitions": []
}
}
}

Получить визиты

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
    "request": {
        "MTK\\Visits": {
            "table": "MTK\\Visits",
            "page": 1,
            "limit": 100,
            "search": "",
            "sort_key": "",
            "sort_direction": "asc",
            "analytics_position": 1,
            "filters": [],
            "dates": [
                "2026-04-08 00:00:00",
                "2026-04-08 23:59:59",
                "Africa/Addis_Ababa"
            ],
            "hide_empty_metrics": false,
            "hide_bots": true,
            "unwrap_tree": false,
            "hide_trash": true,
            "event_time_attribution": false,
            "back_fix_attribution": false,
            "metric_filters": [],
            "metric_definition": null,
            "metric_definitions": []
        }
    }
}

Действия

Купить новый домен

Используйте этот запрос для покупки доменов в AIO.

curl --location 'https://app.aio.tech/api/v1/actions/process?token=xxx' \
--header 'Content-Type: application/json' \
--data '{
    "action": "Domain\\Create",
    "repository": "Eloquent\\DomainRepository",
    "arguments": {
        "domain_provider_uuid": "XXX" // uuid of domain provider
        "domain_url": "testdomain.com", // url
        "server_uuid": "XXX" // uuid of server to which domain is pointed ( a record )
        "dns_provider_uuid": "XXX", // uuid of dns provider
        "monitoring_user_uuid": "XXX", // uuid of user who will receive notifications
        "settings": "{\"robots\":{\"allow\":false}}"
    }
}'

Добавить домен вручную

Используйте этот запрос для доменов, купленных вне AIO.

POST https://app.aio.tech/api/v1/actions/process?token=XXX
{
"action": "Domain\\CreateManually",
"repository": "Eloquent\\DomainRepository",
"arguments": {
"domain_url": "testdomain.com", // url
"server_uuids": [
"XXX" // uuid of server to which domain is pointed ( a record )
],
"dns_provider_uuid": "XXX", // uuid of dns provider
"monitoring_user_uuid": "XXX", // uuid of user who will receive notifications
"settings": "{\"robots\":{\"allow\":false}}" // generate robots.txt or not
}
}

Обновить затраты

POST https://app.aio.tech/api/v1/actions/process?token=XXX

{
  "action" : "Campaign\UpdateCosts",
  "repository" : "MassiveEloquent\CampaignRepository",
  "uuids" : ["CAMPAIGN_UUID"], // array of campaign uuids
  "arguments" : {
    "from" : "2025-03-17 00:00:00", // from data
    "to" : "2025-03-17 23:59:59", // to date
    "timezone" : "Africa/Abidjan", // timezone
    "value" : 100, // 100$ (USD)
    "is_cpc" : false,
    "field_uuid" : "FIELD_UUID", // uuid of required field
    "field_value" : "FIELD_VALUE" // value of required field
  }
}