API по продажам в JSON
Инструмент для получения расширенных отчетов по продажам вашего аккаунта (server to server). JSON — текстовый формат обмена данными, основанный на JavaScript.
Основная функция этого раздела — отдавать партнёрам данные о продажах и их статусах в удобном формате.
Возможности применения практически безграничны, но лучше всего эти отчёты подойдут для очень крупных партнёров, которым необходимо оперировать большим объемом данных.
Пример запроса
curl -L --user '777:ABC123' -H "Content-Type: application/json" -d '{"confirmed_at": {"date":"2014-04-30", "period": 30}, "merchant_id":2573,"state":[3,4], "type": 0, "sub_id":123}' -X POST https://www.gdeslon.ru/api/orders/
Он говорит о следующем: для пользователя с ID 777 ключ доступа ABC123 нужно получить статистику по заказам магазина 2573 (Sotmarket.ru) за период 30 дней (с 1-го по 30-е апреля), находящимся в статусе 3 и 4 (подтверждён и оплачен) с sub_id 123.
Вот перечень всех возможных параметров и их значений, которые можно указывать в запросе:
| ПАРАМЕТР | ЗНАЧЕНИЕ |
|---|---|
| gdeslon_order_id | Идентификатор заказа |
| merchant_order_id | Идентификатор заказа на стороне магазина |
| sub_id | Идентификатор заказа |
| merchant_id | Идентификатор магазина в системе Gdeslon |
| merchant_name | Название магазина |
| affiliate_id | Идентификатор партнера |
| state | Статус: 0 - новый 1 - отменен 2 - отложен 3 - подтвержден 4 - выплачен |
| type | Тип: 0 - товарный заказ 1 - лид |
| partner_payment | Вознаграждение партнера |
| order_payment | Сумма заказа |
| currency | Валюта заказа и платежа |
| items_in_order | Количество товаров в заказе |
| transition_at | Дата и время перехода |
| created_at | Дата и время создания |
| last_updated_at | Дата и время последнего обновления |
| confirmed_at | Дата и время подтверждения |
| accrued_at | Дата и время выплаты партнеру |
| keywords | Ключевые слова |
Ещё важное замечание: если статус заказа был изменён сегодня, то в отчётах его статус поменяется только на следующий день.
Чтобы закрепить информацию, попробуем получить данные о всех наших заказах за последние 30 дней, которые так или иначе были обновлены. Для этого используем такой запрос:
curl -L --user 'ID пользователя:его ключ' -H "Content-Type: application/json" -d '{"last_updated_at": {"date":"2014-05-30", "period": 30}}' -X POST https://www.gdeslon.ru/api/orders/
В выдаче получаем список всех транзакций с их изменениями. Перечень возможного использования ограничен только вашей фантазией: от возможности настраивать кампании в контекстной рекламе с расчётом на эффективность до создания субпартнёрской сети.
