API

Создавайте ссылки AffKeeper и управляйте ими программно через простой JSON API.

AffKeeper предоставляет JSON API, чтобы вы могли создавать ссылки и управлять ими из собственного кода или инструментов. Это тот же API, который использует плагин WordPress.

Интерактивный справочник

Полный, всегда актуальный справочник эндпоинтов (схемы, параметры, try-it-out) генерируется из работающего сервиса:

Интерактивная документация: https://affkeeper.com/api/reference
Схема OpenAPI: https://affkeeper.com/openapi.json

Аутентификация

API аутентифицируется через bearer-ключ API.

В панели откройте Настройки → Ключи API и создайте ключ. Скопируйте его — он показывается один раз.
Передавайте его в каждом запросе в заголовке Authorization:
```
Authorization: Bearer YOUR_API_KEY
```

Держите ключ в секрете. На том же экране ключ можно в любой момент отозвать или удалить; отозванный ключ перестаёт работать немедленно.

Базовый URL

https://affkeeper.com/api

Пример

Создание ссылки (точную схему запроса/ответа см. в интерактивном справочнике):

curl -X POST https://affkeeper.com/api/v1/links \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destination_url": "https://example.com/product", "domain_id": null}'

Ограничения частоты и ошибки

Запросы ограничиваются по частоте на каждый IP; корректные клиенты в лимит не упрутся.
Ошибки возвращают JSON-тело с сообщением error и соответствующим HTTP-статусом (400 неверные данные, 401 неверный/отсутствующий ключ, 429 слишком много запросов).