Документация, с которой можно начать сегодня.

GET /api/v1/offers/catalog?category=telegram_bots&payoutModel=cpl&geo=RU&access=available&page=1&pageSize=12
Authorization: Bearer <access_token>

// access: all | available | requires_request | requested
// sort: recommended | newest | updated

GET /api/v1/offers/management?status=pending_review&category=telegram_bots&payoutModel=cpa_first_purchase&page=1&pageSize=12
Authorization: Bearer <platform_access_token>

PATCH /api/v1/offers/:offerId
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "status": "active",
  "visibility": "affiliate_list",
  "approvalMode": "manual",
  "payoutRules": [{
    "name": "Первая оплата",
    "eventType": "first_purchase",
    "payoutModel": "cpa_first_purchase",
    "fixedAmount": "12.00",
    "currency": "USD",
    "isDefault": true,
    "priority": 10
  }]
}

PATCH /api/v1/offers/categories/:categoryId
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{ "name": "Telegram-продукты", "slug": "telegram_products", "active": true, "sortOrder": 20 }

POST /api/v1/offers/:offerId/moderation
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "decision": "return_to_draft",
  "note": "Добавьте ссылку с макросом click_id и уточните разрешённые источники трафика."
}

// decision: approve | return_to_draft | pause | archive

GET /api/v1/offers/:offerId/moderation-history
Authorization: Bearer <platform_or_advertiser_access_token>

GET /api/v1/offers/moderation-queue?sort=priority&category=telegram_products&payoutModel=hybrid&slaStatus=overdue&page=1&pageSize=12
Authorization: Bearer <platform_access_token>

// Нужна роль платформы с правом moderation.read.
// slaStatus: on_track | due_soon | overdue.
// Ответ содержит время ожидания, приоритет, границы SLA, CR, AR, eCPC и чек-лист готовности.
// sort: priority | newest

PATCH /api/v1/admin/platform-configuration
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "offerModerationSlaWarningHours": 24,
  "offerModerationSlaCriticalHours": 48
}

// criticalHours должен быть строго больше warningHours.
// Worker открывает сигнал после warningHours и повышает его после criticalHours.
// Экран команды: /admin/offers/review/sla

GET /api/v1/offers/:offerId/moderation-readiness
Authorization: Bearer <advertiser_or_platform_access_token>

POST /api/v1/offers/moderation/batch
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "offerIds": ["offer_a", "offer_b"],
  "decision": "approve"
}

// Пакетно одобряются только офферы со 100% готовностью.
// На доработку можно вернуть несколько офферов, передав обязательный note.

GET /api/v1/offers/advertiser-management?organizationId=adv_8wm2&status=active&payoutModel=hybrid&page=1&pageSize=12
Authorization: Bearer <advertiser_access_token>

PATCH /api/v1/offers/:offerId
Authorization: Bearer <advertiser_access_token>
Content-Type: application/json

{
  "visibility": "affiliate_list",
  "approvalMode": "manual",
  "allowedGeos": ["RU", "KZ"],
  "forbiddenTrafficSources": ["incent"],
  "payoutModel": "hybrid",
  "payoutRules": [
    {
      "name": "Фикс за первую оплату",
      "eventType": "first_purchase",
      "payoutModel": "cpa_first_purchase",
      "fixedAmount": "8.00",
      "currency": "USD",
      "geo": "RU",
      "planId": "pro_monthly",
      "isDefault": true,
      "priority": 10
    },
    {
      "name": "Доля с продления",
      "eventType": "renewal",
      "payoutModel": "revshare",
      "percentRate": "22.5",
      "currency": "USD",
      "planId": "pro_monthly",
      "priority": 20
    }
  ],
  "caps": [
    { "period": "daily", "metric": "first_purchases", "limit": 50, "active": true },
    { "period": "monthly", "metric": "renewals", "limit": 500, "active": false }
  ]
}

GET /api/v1/admin/manual-review/conversions/queue?slaStatus=overdue&eventType=first_purchase&riskLevel=high&sort=priority&page=1&pageSize=20
Authorization: Bearer <platform_access_token>

// Нужна роль платформы с правом moderation.read.
// Фильтры: q, advertiserId, offerId, conversionId, eventType, riskLevel, slaStatus.
// slaStatus: on_track | due_soon | overdue.
// Ответ не содержит S2S-payload, HMAC, click_id, внешние ID пользователей или платежей.

PATCH /api/v1/admin/conversions/:conversionId/review
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "decision": "approve",
  "affiliateOrganizationId": "partner_team_id",
  "note": "Атрибуция подтверждена по согласованным данным."
}

POST /api/v1/admin/manual-review/conversions/batch
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "conversionIds": ["conv_1", "conv_2"],
  "decision": "reject",
  "reason": "Не удалось подтвердить источник привлечения"
}

// decision: approve | reject.
// При reject поле reason обязательно. В batch допускается до 100 конверсий.
// affiliateOrganizationId указывайте только для конверсии без атрибуции.
// Уже найденного партнера нельзя заменить через этот endpoint: API вернет 400.
// После финального решения повторный review невозможен: API вернет 409.
// В batch каждая конверсия проверяется отдельно: неподходящая строка не меняет остальные.

PATCH /api/v1/admin/platform-configuration
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "conversionModerationSlaWarningHours": 12,
  "conversionModerationSlaCriticalHours": 24
}

// criticalHours должен быть строго больше warningHours.
// Экран команды: /admin/moderation/sla.
// Настройка требует права settings.manage.

POST /api/v1/support/requests
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "organizationId": "aff_123",
  "category": "integration",
  "priority": "high",
  "subject": "Тестовое S2S-событие не проходит проверку",
  "description": "Проверили URL и время запроса. Нужна помощь с event_time."
}

GET /api/v1/affiliate/support/requests?status=open&sort=sla
Authorization: Bearer <access_token>

POST /api/v1/support/requests/<request_id>/messages
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "body": "Проверяем mapping и вернемся с ответом в этом диалоге.",
  "visibility": "participants"
}

GET /api/v1/admin/support/automation
Authorization: Bearer <platform_access_token>

PATCH /api/v1/admin/support/automation
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "autoAssignmentEnabled": true,
  "businessTimezone": "Europe/Moscow",
  "businessDays": [1, 2, 3, 4, 5],
  "businessStartHour": 9,
  "businessEndHour": 21,
  "maxActiveRequestsPerAssignee": 20,
  "escalationEnabled": true,
  "escalationRepeatHours": 4
}

PATCH /api/v1/admin/support/automation/team/<user_id>
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "autoAssignmentEnabled": true,
  "useGlobalCapacity": false,
  "maxActiveRequests": 8,
  "supportedCategories": ["integration", "offers", "traffic"],
  "useGlobalBusinessHours": false,
  "weeklySchedule": [
    {"weekday": 1, "startHour": 9, "endHour": 18},
    {"weekday": 2, "startHour": 9, "endHour": 18}
  ],
  "pausedUntil": "2026-08-27T16:00:00.000Z"
}

// Вернуть специалиста в автоматический поток:
{"clearPause": true, "useGlobalCapacity": true}

// Вернуть общий график команды:
{"useGlobalBusinessHours": true}

// Компетенции обязательны для новых автоназначений.
// Личная смена дополнительно сужает общее рабочее окно.
// Ручное назначение не ограничивается этими правилами.

POST /api/v1/affiliate/traffic-sources
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "affiliateOrganizationId": "aff_123",
  "name": "Telegram Ads RU",
  "code": "telegram_ads_ru",
  "channel": "telegram_ads",
  "status": "active",
  "note": "Основной тестовый кабинет"
}

POST /api/v1/affiliate/campaigns
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "affiliateOrganizationId": "aff_123",
  "offerId": "offer_123",
  "name": "Telegram Ads · сентябрь",
  "trafficSourceId": "source_123",
  "status": "active"
}

POST /api/v1/affiliate/traffic-source-label-aliases
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "affiliateOrganizationId": "aff_123",
  "trafficSourceId": "source_123",
  "name": "Короткая ссылка для посева",
  "code": "tg_short_ru",
  "note": "Ее добавляет согласованный сокращатель ссылок"
}

PATCH /api/v1/admin/traffic-source-label-aliases/alias_123
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "status": "archived"
}

GET /api/v1/affiliate/traffic-source-discrepancies?affiliateOrganizationId=aff_123&status=open
Authorization: Bearer <access_token>

GET /api/v1/admin/traffic-source-discrepancies?status=open
Authorization: Bearer <platform_access_token>

PATCH /api/v1/admin/traffic-source-discrepancies/discrepancy_123
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "status": "reviewed",
  "reviewNote": "Партнер обновляет шаблон ссылки"
}

GET /api/v1/affiliate/traffic-source-discrepancies/analytics?affiliateOrganizationId=aff_123&period=last_30_days&campaignId=camp_123
Authorization: Bearer <access_token>

GET /api/v1/admin/traffic-source-discrepancies/analytics?affiliateOrganizationId=aff_123&trafficSourceId=source_123&period=last_7_days
Authorization: Bearer <platform_access_token>

// Произвольный диапазон: не более 93 дней
GET /api/v1/affiliate/traffic-source-discrepancies/analytics?affiliateOrganizationId=aff_123&dateFrom=2026-08-01&dateTo=2026-08-28

PATCH /api/v1/admin/platform-configuration
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "intelligenceInsightsEnabled": true,
  "intelligenceSourceLabelMismatchMinEvents": 5,
  "intelligenceSourceLabelMismatchRatePercent": 20
}

GET /api/v1/affiliate/intelligence?type=traffic_source_label_mismatch
Authorization: Bearer <access_token>

GET /api/v1/admin/intelligence?type=traffic_source_label_mismatch
Authorization: Bearer <platform_access_token>

POST /api/v1/affiliate/smart-links
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "affiliateOrganizationId": "aff_123",
  "name": "Telegram Ads · сентябрь",
  "routes": [
    { "campaignId": "camp_main", "weight": 70 },
    { "campaignId": "camp_test", "weight": 30 }
  ]
}

GET /api/v1/affiliate/smart-links/analytics?affiliateOrganizationId=aff_123&period=last_30_days
Authorization: Bearer <access_token>

GET /api/v1/admin/smart-links/analytics?affiliateOrganizationId=aff_123&smartLinkId=slk_123&period=last_7_days
Authorization: Bearer <platform_access_token>

GET /api/v1/affiliate/intelligence?type=smart_link_route_underperformance&take=100
Authorization: Bearer <access_token>

PATCH /api/v1/admin/platform-configuration
Authorization: Bearer <platform_access_token>
Content-Type: application/json

{
  "intelligenceSmartLinkMinClicks": 30,
  "intelligenceSmartLinkPerformanceGapPercent": 50
}

POST /api/v1/affiliate/smart-links/slk_123/experiments
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "affiliateOrganizationId": "aff_123",
  "name": "Сравнение двух воронок",
  "minimumClicksPerVariant": 100,
  "variants": [
    { "routeId": "route_control", "weight": 100, "isControl": true },
    { "routeId": "route_variant_b", "weight": 100, "isControl": false }
  ]
}

POST /api/v1/affiliate/smart-links/slk_123/experiments/exp_123/transition
Authorization: Bearer <access_token>
Content-Type: application/json

{ "action": "start" }

POST /api/v1/affiliate/smart-links/slk_123/experiments/exp_123/decision
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "affiliateOrganizationId": "aff_123",
  "type": "apply_experiment_weights",
  "confirmed": true,
  "routeWeights": [
    { "routeId": "route_control", "weight": 35 },
    { "routeId": "route_variant_b", "weight": 65 }
  ]
}

GET /api/v1/affiliate/smart-link-experiment-decisions?affiliateOrganizationId=aff_123

GET /api/v1/affiliate/smart-link-experiments?affiliateOrganizationId=aff_123&smartLinkId=slk_123&take=100
Authorization: Bearer <access_token>

// result.evidence:
{
  "state": "directional_signal",
  "label": "Есть направленный сигнал",
  "confidenceLevel": 95,
  "method": "Интервалы Уилсона",
  "intervalsOverlap": false
}

GET /api/v1/affiliate/smart-link-experiments?affiliateOrganizationId=aff_123&smartLinkId=slk_123&take=100
Authorization: Bearer <access_token>

// result.deliveryQuality:
{
  "state": "potential_mismatch",
  "label": "Нужно проверить распределение",
  "confidenceLevel": 95,
  "method": "Критерий согласия Пирсона (χ²)",
  "chiSquare": 6.6667,
  "criticalValue": 3.8415
}

GET /api/v1/affiliate/smart-link-experiments?affiliateOrganizationId=aff_123&smartLinkId=slk_123&take=100
Authorization: Bearer <access_token>

// result.segmentBreakdown:
{
  "key": "country",
  "label": "Страны",
  "minimumSegmentClicks": 10,
  "entries": [{
    "label": "RU",
    "totalClicks": 20,
    "totalFirstPurchases": 12,
    "variants": [/* CR по каждому варианту */]
  }]
}

GET /api/v1/affiliate/smart-link-experiments?affiliateOrganizationId=aff_123&smartLinkId=slk_123&take=100
Authorization: Bearer <access_token>

// result.dataFreshness:
{
  "state": "awaiting_settlement_window",
  "label": "В выборке есть свежий трафик",
  "settlementWindowHours": 24,
  "totalClicks": 40,
  "recentClicks": 18,
  "recentClickShare": 45,
  "lastClickAt": "2026-08-27T09:15:00.000Z",
  "lastConversionReceivedAt": "2026-08-27T08:42:00.000Z",
  "lastConversionEventTime": "2026-08-27T08:40:00.000Z"
}

GET /api/v1/affiliate/smart-link-experiments?affiliateOrganizationId=aff_123&smartLinkId=slk_123&take=100
Authorization: Bearer <access_token>

// result.freshnessComparison:
{
  "state": "asymmetric_freshness",
  "label": "Зрелость трафика различается между вариантами",
  "settlementWindowHours": 24,
  "minimumComparableClicksPerVariant": 10,
  "asymmetryThresholdPercentagePoints": 25,
  "recentClickShareGapPercentagePoints": 100,
  "variants": [
    { "campaignName": "Контроль", "recentClicks": 0, "matureClicks": 20, "recentClickShare": 0 },
    { "campaignName": "Вариант B", "recentClicks": 20, "matureClicks": 0, "recentClickShare": 100 }
  ]
}

GET /api/v1/affiliate/smart-link-experiments?affiliateOrganizationId=aff_123&smartLinkId=slk_123&take=100
Authorization: Bearer <access_token>

// result.matureCohort:
{
  "state": "ready",
  "label": "Зрелая когорта готова к сравнению",
  "settlementWindowHours": 24,
  "minimumClicksPerVariant": 20,
  "totalClicks": 60,
  "totalFirstPurchases": 9,
  "conversionRate": 15,
  "variants": [
    { "campaignName": "Контроль", "clicks": 30, "firstPurchases": 3, "conversionRate": 10, "ready": true },
    { "campaignName": "Вариант B", "clicks": 30, "firstPurchases": 6, "conversionRate": 20, "ready": true }
  ]
}

POST /api/v1/ingest/advertiser-events/validate
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "advertiserId": "adv_8wm2",
  "payload": {
    "event_id": "check-order-100023",
    "event_type": "first_purchase",
    "event_time": "2026-08-26T12:30:00.000Z",
    "advertiser_id": "adv_8wm2",
    "offer_id": "offer_premium_bot",
    "click_id": "clk_01J9...",
    "external_user_id": "tg_123456789",
    "subscription_id": "sub_001",
    "currency": "USD",
    "amount": "9.99",
    "status": "approved"
  }
}

curl -X POST \
  https://spa.ditrixdev.ru/api/v1/ingest/advertiser-events/:advertiserId \
  -H "Content-Type: application/json" \
  -H "X-Integration-Key: lki_..." \
  -H "X-Timestamp: 1787747400" \
  -H "X-Signature: <HMAC-SHA256 от event.json>" \
  --data-binary @event.json

{
  "event_id": "bot-evt-100023",
  "event_type": "first_purchase",
  "event_time": "2026-08-26T12:30:00.000Z",
  "advertiser_id": "adv_8wm2",
  "offer_id": "offer_premium_bot",
  "click_id": "clk_01J9...",
  "external_user_id": "tg_123456789",
  "subscription_id": "sub_001",
  "payment_id": "payment_001",
  "currency": "USD",
  "amount": "9.99",
  "status": "approved"
}

curl -X POST \
  https://spa.ditrixdev.ru/api/v1/ingest/advertiser-events/:advertiserId \
  -H "Content-Type: application/json" \
  -H "X-Timestamp: 1787747400" \
  -H "X-Signature: <HMAC-SHA256>" \
  --data-binary @event.json

POST /api/v1/affiliate/payout-methods
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "type": "bank_transfer",
  "label": "Основной расчетный счет",
  "details": "Банк: ...\nПолучатель: ...\nСчет: ...",
  "isDefault": true
}

GET /api/v1/affiliate/payout-balance?affiliateOrganizationId=<organization_id>
Authorization: Bearer <access_token>

POST /api/v1/affiliate/campaign-spend
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "campaignId": "camp_123",
  "spendDate": "2026-08-26",
  "currency": "USD",
  "amount": "27.50",
  "source": "Telegram Ads",
  "note": "Тест двух креативов"
}

POST /api/v1/affiliate/campaign-goals
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "campaignId": "camp_123",
  "currency": "USD",
  "budgetAmount": "1000.00",
  "budgetAlertPercent": 80,
  "autoPauseOnBudgetExceeded": false,
  "targetRoiPercent": "35.00",
  "maxCostPerClick": "0.80",
  "active": true
}

GET /api/v1/affiliate/campaign-goal-signals?state=open
Authorization: Bearer <access_token>

PATCH /api/v1/affiliate/campaign-goals/goal_123
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "budgetAmount": "1500.00",
  "autoPauseOnBudgetExceeded": true
}

PATCH /api/v1/affiliate/campaigns/camp_123
Authorization: Bearer <access_token>
Content-Type: application/json

{ "status": "active" }

POST /api/v1/affiliate/report-digest-schedules
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "reportViewId": "report_view_123",
  "frequency": "daily",
  "period": "last_7_days",
  "timeZone": "Europe/Moscow",
  "hour": 9
}

POST /api/v1/affiliate/report-views
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "name": "Первые оплаты за неделю",
  "organizationId": "org_123",
  "isShared": true,
  "isPinned": true,
  "filters": {
    "eventType": "first_purchase",
    "currency": "USD",
    "sourceId": "telegram_ads"
  }
}

[
  {
    "kind": "click",
    "external_click_id": "legacy-click-1001",
    "offer_id": "offer_abc",
    "affiliate_organization_id": "aff_123",
    "clicked_at": "2026-07-10T09:15:00Z"
  },
  {
    "kind": "event",
    "event_id": "legacy-event-1001",
    "event_type": "first_purchase",
    "event_time": "2026-07-10T09:20:00Z",
    "offer_id": "offer_abc",
    "click_id": "legacy-click-1001",
    "external_user_id": "user_42",
    "subscription_id": "sub_42",
    "currency": "USD",
    "amount": "9.99",
    "status": "approved"
  }
]

POST /api/v1/historical-imports/dry-run
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "advertiserOrganizationId": "adv_123",
  "name": "История июля",
  "idempotencyKey": "july-history-v1-2026",
  "format": "json",
  "rows": [/* строки из примера */]
}

curl "https://spa.ditrixdev.ru/api/v1/public/analytics/summary?dateFrom=2026-08-01T00:00:00.000Z&take=100" \
  -H "X-Linkora-API-Key: lsk_<public_id>.<secret>"

import { createHmac, timingSafeEqual } from 'node:crypto';

function verifyLinkoraWebhook(rawBody, headers, signingSecret) {
  const timestamp = headers['x-linkora-webhook-timestamp'];
  const signature = headers['x-linkora-webhook-signature'];
  const expected = createHmac('sha256', signingSecret)
    .update(timestamp + '.' + rawBody)
    .digest('hex');

  return Boolean(timestamp && signature)
    && timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}

POST /api/v1/reconciliation/cases
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "organizationId": "aff_123",
  "type": "conversion",
  "title": "Не совпадает статус регистрации",
  "description": "Просим сверить событие за 26 августа.",
  "conversionId": "conv_123"
}