Справочник эндпоинтов

Каждый маршрут партнёрского API. Все требуют bearer-ключ и ограничены вашими доменами. Base URL: /api/v1.

примечание

Денежные поля — USD/ваша валюта, округление до 2 знаков. Времена — ISO-8601 (UTC). Поля конверсий — доли (например, 0.12 = 12%).

Идентичность

GET /v1/me

Возвращает идентичность аккаунта и число доменов — удобный health-check ключа.

Запрос
curl -s https://your-host/api/v1/me -H "Authorization: Bearer wk_live_xxxx"

Ответ
{
  "ok": true,
  "data": { "workerId": "…", "displayName": "Acme Media", "domains": 3 }
}

Статистика

GET /v1/stats

Воронка + закупочные деньги + ваш заработок за диапазон дат.

Query	Тип	Описание
`from`	ISO-дата	Начало диапазона. По умолчанию: 30 дней назад.
`to`	ISO-дата	Конец диапазона. По умолчанию: сейчас. Максимум 92 дня.

Запрос
curl -s "https://your-host/api/v1/stats?from=2026-06-01&to=2026-06-19" \
  -H "Authorization: Bearer wk_live_xxxx"

Ответ
{
  "ok": true,
  "data": {
    "range": { "from": "2026-06-01T00:00:00.000Z", "to": "2026-06-19T00:00:00.000Z" },
    "funnel": {
      "visits": 12840, "leads": 980, "registrations": 910,
      "ftd": 142, "depositors": 156, "deposits": 233, "repeatDeposits": 77
    },
    "money": {
      "depositSum": 11620.50, "avgDeposit": 49.87,
      "arpu": 12.77, "arppu": 74.49, "earnings": 3486.15
    },
    "conversion": { "crVisitReg": 0.0709, "crRegDep": 0.1714, "crVisitDep": 0.0121 },
    "earningsLifecycle": { "pendingUsd": 1240.00, "inFlightUsd": 0, "paidUsd": 2246.15 }
  }
}

Разбивка статистики

GET /v1/stats/breakdown

Та же воронка в разрезе измерения закупки.

Query	Тип	Описание
`dim`	enum	`clickId` \| `utm_source` \| `utm_campaign` \| `utm_medium` \| `utm_content` \| `geo` \| `domain` \| `landing`. По умолчанию `clickId`.
`from` / `to`	ISO-дата	Диапазон (правила как у `/stats`).

Запрос
curl -s "https://your-host/api/v1/stats/breakdown?dim=utm_campaign" \
  -H "Authorization: Bearer wk_live_xxxx"

Ответ
{
  "ok": true,
  "data": {
    "dim": "utm_campaign",
    "range": { "from": "…", "to": "…" },
    "items": [
      {
        "key": "camp1", "label": "camp1",
        "registrations": 320, "ftd": 51, "depositors": 60,
        "deposits": 88, "depositSum": 4310.00, "arppu": 71.83,
        "crRegDep": 0.1875, "visits": null
      }
    ]
  }
}

visits заполняется только при dim=domain; иначе null.

Лента конверсий

GET /v1/conversions

Источник для CAPI: единая восходящая лента регистраций и депозитов. Поллите вперёд через nextCursor. Каждый элемент несёт атрибуцию и match-сигналы.

Query	Тип	Описание
`type`	enum	`all` \| `registration` \| `deposit`. По умолчанию `all`.
`from` / `to`	ISO-дата	Диапазон (максимум 92 дня).
`limit`	int	Размер страницы. По умолчанию 100, максимум 500.
`cursor`	string	Opaque-курсор с предыдущей страницы.

Запрос
curl -s "https://your-host/api/v1/conversions?type=deposit&limit=100" \
  -H "Authorization: Bearer wk_live_xxxx"

Ответ
{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "dep:9f2c…", "type": "deposit",
        "occurredAt": "2026-06-18T20:14:03.000Z",
        "leadId": "…", "eventId": "dep:9f2c…", "externalId": "…",
        "pixelId": "123456789",
        "geo": "DE", "locale": "es", "timezone": "America/Mexico_City",
        "domain": "play.example.com",
        "eventSourceUrl": "https://play.example.com/?subid=abc123",
        "value": 50.00, "currency": "USDT",
        "clickId": "abc123", "utmSource": "fb", "utmMedium": null,
        "utmCampaign": "camp1", "utmContent": null, "utmTerm": null,
        "sub2": "adset_7", "sub3": null,
        "ip": "203.0.113.7", "userAgent": "Mozilla/5.0 …",
        "fbp": "fb.1.…", "fbc": "fb.1.…", "fbclid": "IwAR…"
      }
    ],
    "nextCursor": "eyJ0cyI6…"
  }
}

У регистраций value и currency равны null. id стабилен (reg:<leadId> / dep:<depositId>) — используйте его для дедупликации на своей стороне.

:::note Контракт дедупликации CAPI Наш браузерный Pixel отправляет Lead / Purchase с eventID, равным eventId из этой ленты. Передавайте то же значение как event_id (с соответствующим event_name: registration → Lead, deposit → Purchase) в вашем POST к Conversions API — Meta схлопнет оба в одно событие. Используйте externalId как user_data.external_id, ip / userAgent / fbp / fbc для качества матчинга, geo как user_data.country (в нижнем регистре, хэшированно) и eventSourceUrl как event_source_url. Для сумм депозитов передавайте currency USD, когда лента говорит USDT (учёт 1:1). :::

Лиды

GET /v1/leads

Ваши зарегистрированные игроки с атрибуцией и сводкой депозитов по лиду, от новых к старым.

Query	Тип	Описание
`from` / `to`	ISO-дата	Диапазон дат регистрации.
`limit`	int	По умолчанию 100, максимум 500.
`cursor`	string	Opaque-курсор следующей страницы.
`deposited`	bool	`deposited=true` → только лиды с депозитом.

Запрос
curl -s "https://your-host/api/v1/leads?deposited=true&limit=50" \
  -H "Authorization: Bearer wk_live_xxxx"

Ответ
{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "…", "createdAt": "2026-06-18T19:55:00.000Z",
        "geo": "DE", "locale": "es", "timezone": "America/Mexico_City",
        "domain": "play.example.com",
        "clickId": "abc123", "utmSource": "fb", "utmMedium": null,
        "utmCampaign": "camp1", "utmContent": null, "utmTerm": null,
        "sub2": "adset_7", "sub3": null,
        "hasDeposited": true, "depositCount": 2,
        "depositSum": 100.00, "firstDepositAt": "2026-06-18T20:14:03.000Z"
      }
    ],
    "nextCursor": "eyJ0cyI6…"
  }
}

Карточка лида

GET /v1/leads/{id}

Полный профиль одного из ваших лидов. 404, если лид не с ваших доменов. Включает всё из спискового элемента плюс match-сигналы, ваш накопленный доход по лиду и историю депозитов/событий.

Запрос
curl -s https://your-host/api/v1/leads/<id> -H "Authorization: Bearer wk_live_xxxx"

Ответ (дополнительные поля)
{
  "ok": true,
  "data": {
    "id": "…", "createdAt": "…", "geo": "DE", "locale": "es",
    "timezone": "America/Mexico_City", "domain": "play.example.com",
    "clickId": "abc123", "utmSource": "fb", "sub2": "adset_7",
    "hasDeposited": true, "depositCount": 2, "depositSum": 100.00,
    "firstDepositAt": "…",
    "pixelId": "123456789", "fbp": "fb.1.…", "fbc": "fb.1.…",
    "fbclid": "IwAR…", "landingUrl": "https://play.example.com/?subid=abc123",
    "ip": "203.0.113.7", "userAgent": "Mozilla/5.0 …",
    "earning": 30.00,
    "deposits": [
      { "id": "…", "createdAt": "…", "amount": 50.00, "currency": "USDT", "status": "APPROVED" }
    ],
    "events": [
      { "id": "…", "createdAt": "…", "eventName": "Purchase", "url": "https://…" }
    ]
  }
}

Ссылка входа (восстановление сессии)

POST /v1/leads/{id}/login-link

Выпускает одноразовую ссылку входа для ВАШЕГО лида. Используйте, когда игрок потерял сессию (регистрировался в инкогнито, почистил куки): отправьте ему URL — он вернётся тем же пользователем: баланс, депозиты и прогресс на месте. Посоветуйте игроку не открывать её снова в инкогнито.

Запрос
curl -s -X POST https://your-host/api/v1/leads/<id>/login-link \
  -H "Authorization: Bearer wk_live_xxxx"

Ответ
{
  "ok": true,
  "data": {
    "url": "https://play.example.com/r/6vJq…",
    "expiresAt": "2026-06-21T20:14:03.000Z",
    "ttlHours": 72,
    "singleUse": true
  }
}

Ссылки одноразовые, живут 72 часа и лимитированы на аккаунт. 404, если лид не с ваших доменов, 400 — если лид не подходит (например, забанен).

Заработок

GET /v1/earnings

Суммы жизненного цикла вашего заработка плюс последние выплаты.

Запрос
curl -s https://your-host/api/v1/earnings -H "Authorization: Bearer wk_live_xxxx"

Ответ
{
  "ok": true,
  "data": {
    "pendingUsd": 1240.00, "inFlightUsd": 0, "paidUsd": 2246.15,
    "payouts": [
      {
        "id": "…", "createdAt": "2026-06-10T12:00:00.000Z",
        "chain": "TRON", "currency": "USDT", "amount": 2246.15,
        "txHash": "0x…", "status": "CONFIRMED"
      }
    ]
  }
}

Домены

GET /v1/domains

Ваши домены и их статус провижининга/здоровья.

Запрос
curl -s https://your-host/api/v1/domains -H "Authorization: Bearer wk_live_xxxx"

Ответ
{
  "ok": true,
  "data": {
    "domains": [
      {
        "id": "…", "host": "play.example.com", "label": "EU",
        "enabled": true, "status": "ACTIVE",
        "dnsVerifiedAt": "2026-05-01T10:00:00.000Z",
        "currency": "USDT", "landingVariant": "default",
        "pixelDefault": "123456789", "createdAt": "2026-04-28T09:00:00.000Z"
      }
    ]
  }
}

Идентичность​

Статистика​

Разбивка статистики​

Лента конверсий​

Лиды​

Карточка лида​

Ссылка входа (восстановление сессии)​

Заработок​

Домены​