Write API

​

Что входит

​

Правила

• Ключ с полным доступом. Ключ из Tools -> API должен быть ключом Full. Ключи Read-only получают error_code 403 с сообщением This API key is read-only.
• POST с JSON-телом. Отправляйте Content-Type: application/json. Тела в формате формы тоже принимаются.
• Только публичные id. campaign_id — это id вида revc_…, order_id — id CPL-кампании вида cplo_…, ровно в том виде, в каком их возвращают списочные эндпоинты. Числовые внутренние id отклоняются с 404.
• Лимит: 30 запросов в минуту на аккаунт (общий для всех его ключей), отдельно от 120 в минуту для чтений. При превышении вы получаете error_code 429 и заголовок Retry-After.
• Каждая запись возвращает обновлённый объект в data, в том же формате, что и соответствующий списочный эндпоинт (/api/marketer/revshare/campaigns для кампаний, /api/marketer/cpl/campaigns для CPL-кампаний), так что локальную копию можно обновить без второго запроса. Некоторые ответы также содержат message с текстом подтверждения от платформы.

​

Формат ответа

{
  "status": "success",
  "data": { "campaign_id": "revc_abc123", "status": "completed", ... }
}

{
  "status": "error",
  "error_code": 422,
  "message": "Please fill in all campaign fields"
}

​

Запуски кампаний

{
  "status": "error",
  "error_code": 429,
  "message": "Another campaign start is still running. Wait a few seconds and try again"
}

​

503: сервис временно недоступен

​

Пример

curl -X POST "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/stop" \
  -H "Authorization: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"campaign_id": "revc_abc123"}'

import requests

response = requests.post(
    "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/stop",
    headers={"Authorization": "your-api-key-here"},
    json={"campaign_id": "revc_abc123"}
)
data = response.json()

const response = await fetch(
  "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/stop",
  {
    method: "POST",
    headers: {
      "Authorization": "your-api-key-here",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ campaign_id: "revc_abc123" })
  }
);
const data = await response.json();