API и Go-SDK для CPA-сети: свой интерфейс на учёте Recca

Когда нужен API, а не готовый кабинет

Готовый кабинет закрывает работу сети целиком. API нужен, когда у сети уже есть свой продукт — площадка, приложение, CRM — и партнёры должны работать в нём, а не переходить в отдельный кабинет. Тогда ваш интерфейс зовёт Recca, а Recca считает клики, конверсии, холды и выплаты.

Что доступно через API

Методы CPA-API сгруппированы по тому, что делает сеть:

• каталог офферов, их креативы и условия;
• ссылки для партнёров и запись клика;
• конверсии: создание, отмена, статус;
• партнёры сети, адресуемые вашим внешним идентификатором;
• выплаты и статистика.

Go-SDK

Для Go есть клиент на все методы CPA-API, помощники проверки подписи и тестовый сервер, повторяющий поведение настоящего. Проверка совместимости прогоняет ваш код по сценариям договора до выхода в бой.

import "go.recca.ru/cpa"

c, _ := cpa.New(os.Getenv("RECCA_CPA_KEY"),
    &cpa.ClientOptions{Environment: cpa.Sandbox})

conv, _, err := c.Conversions.Create(ctx, cpa.CreateConversionParams{
    ClickID:    "clk_…",
    ExternalID: "order-1",
    Status:     "approved",
})

Вебхуки

Recca сообщает вашей системе о событиях, а не ждёт, пока вы спросите: конверсия подтверждена, отклонена, возвращена, выплата проведена. Если ваш сервер не ответил, доставка повторяется.

API-ключи

На уровне «CPA-сеть» — до 10 активных ключей. У каждого ключа свой набор прав: ключ, выданный интеграции статистики, не создаёт конверсий.

Песочница

Отдельная площадка для приёмки интеграции: тот же API, свои данные, никаких реальных денег и никаких писем людям. Интеграцию проверяют там, а в бой переключают одной настройкой окружения.

Коды ошибок и лимиты

Ошибка приходит машинным кодом из реестра, а не только текстом — код можно обрабатывать в программе. Персональные данные в запросах API не принимает: почта, телефон или отображаемое имя дают отказ PII_NOT_ACCEPTED.