Авторизация проводится методом HTTP Authentication: Basic
user: Ваш логин
pass: Ваш api_token


Базовый адрес для обращений к API - https://api.foxyads.ru/v1/

Пример использования:

GET https://api.foxyads.ru/v1/ping

Пример ответа:

{
  "message": "Pong",
  "login": "your_login",
  "time": "2015-12-31 23:59:59"
}

messageСтрока "Pong"
loginВаш логин
timeТекущие дата и время

Пример использования:

GET https://api.foxyads.ru/v1/order/9002423

Пример ответа:

{
  "id": 9002423,
  "offer_id": 9,
  "price": 1300,
  "earn": ​560,
  "name": "Иванов Иван",
  "phone": "71234567890",
  "country": "RU",
  "user_agent": "Mozilla/5.0 (Windows NT 6.1) ...",
  "time": "2015-12-31 23:59:59",
  "status": "approved",
  "reason": "1.Одобрено",
  "external_id": 101,
  "web_id": 4,
  "stream_id": 92,
  "subid1": vk,
  "subid2": fb,
  "subid3": 2356,
  "subid4": null
{

idid заказа
offer_idid оффера заказа
priceЦена для клиента в валюте гео
earnВаш заработок
nameИмя клиента
phoneТелефон клиента
country2-х значный код страны клиента
user_agentuser_agent клиента
timeВремя заказа
statusСтатаус заказа (wait, hold, approved, rejected, trash)
reasonПричина (доп. информация о статусе)
external_idВаш id заказа
web_idВаш id вебмастера
stream_idВаш id потока
subid1Ваш SubID1 потока
subid2Ваш SubID2 потока
subid3Ваш SubID3 потока
subid4Ваш SubID4 потока

Доступные GET параметры:

offer_idid оффреа, по которому фильтровать заказы
dateдата в формате YYYY-MM-DD
date2дата в формате YYYY-MM-DD. Для указания периода выборки совместно с date
idsСписок id заказов через запятую
ext_idsСписок id заказов (ваших) через запятую

Если параметры не указаны, то отдает список заказов за сегодняшний день.

Примеры использования:

GET https://api.foxyads.ru/v1/orders

GET https://api.foxyads.ru/v1/orders?date=2015-12-31&date2=2016-01-07&offer_id=9

GET https://api.foxyads.ru/v1/orders?ids=1020000,1020001,1020002,1020003

Пример ответа:

[
  {
    "id": 9002423,
    "offer_id": 9,
    "price": 1300,
    ...
  {
  },
    "id": 9002434,
    "offer_id": 12,
    "price": 1200,
    ...
  }
]

В запросе необходимо передать следующие параметры (* - обязательные):

offer_id *id оффера заказа
name *Имя клиента
phone *Телефон клиента
country *2-х значный код страны клиента
addressАдресс доставки
user_agentuser_agent клиента
external_idВаш id заказа. В Postback'е можно будет использовать подстановку {external_id}
web_idВаш id вебмастера
stream_idВаш id потока
refererАдрес лендинга, с которого заказ (желательно указывать, чтоб при обзвоне была информация, которую видит клиент)
subid1Ваш SubID1 потока
subid2Ваш SubID2 потока
subid3Ваш SubID3 потока
subid4Ваш SubID4 потока

При принятии заказа в ответ будет отдан новосозданный заказ.

Пример использования:

POST https://api.foxyads.ru/v1/order
offer_id=9&name=Ivan&phone=71234567890&country=RU&external_id=101&web_id=4 &stream_id=92&subid1=vk&subid2=fb&subid3=2356&subid4=mailRU

Пример ответа:

{
  "id":9002423,
  "offer_id": 9,
  "price": 1300,
  "earn": ​560,
  "name": "Ivan",
  "phone": "71234567890",
  "country": "RU",
  "user_agent": null,
  "time": "2015-12-31 23:59:59",
  "status": "wait",
  "reason": null,
  "external_id": 101,
  "web_id": 4,
  "stream_id": 92,
  "subid1": vk,
  "subid2": fb,
  "subid3": 2356,
  "subid4": mailRU
}

Пример использования:

GET https://api.foxyads.ru/v1/offer/9

Пример ответа:

{
  "id": ​9,
  "title": "Шоколад Chokolate Slim",
  "description": "Шоколад для похудения.",
  "category": "Красота",
  "targets":
  {
    "KG": ​0,
    "AM": ​0,
    "AZ": ​0,
    "MD": ​0,
    "KZ": ​560,
    "BY": ​0,
    "UA": ​580,
    "RU": ​560
  },
  "mob_targets":
  {
    "KG": ​0,
    "AM": ​0,
    "AZ": ​0,
    "MD": ​0,
    "KZ": ​560,
    "BY": ​0,
    "UA": ​580,
    "RU": ​560
  },
  "prices":
  {
    "KG": ​0,
    "AM": ​0,
    "AZ": ​0,
    "MD": ​0,
    "KZ": ​4990,
    "BY": ​0,
    "UA": ​379,
    "RU": ​970
  },
  "is_active": true
}

idid оффера
titleНазвание оффера
descriptionОписание оффера
categoryКатегория оффера
targetsОбъект сумм выплат за лид в соответствии с гео
mob_targetsОбъект сумм выплат за мобильный лид в соответствии с гео
pricesОбъект цен за товар для разных гео
is_activeАктивен ли оффер

Пример использования:

GET https://api.foxyads.ru/v1/offers

Пример ответа:

[
  {
    "id": 9,
    "title": "Шоколад Chokolate Slim",
    ...
  {
  },
    "price": 15,
    "title": "Монастырский чай против паразитов",
    ...
  }
]

SKYPE: foxyads EMAIL: info@foxyads.ru TELEGRAM: @Foxyads