Ваш api_token
 

Авторизация проводится методом 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
{

id id заказа
offer_id id оффера заказа
price Цена для клиента в валюте гео
earn Ваш заработок
name Имя клиента
phone Телефон клиента
country 2-х значный код страны клиента
user_agent user_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_id id оффреа, по которому фильтровать заказы
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_agent user_agent клиента
external_id Ваш id заказа. В Postback'е можно будет использовать подстановку {external_id}
web_id Ваш id вебмастера
stream_id Ваш id потока
referer Адрес лендинга, с которого заказ (желательно указывать, чтоб при обзвоне была информация, которую видит клиент)
subid1 Ваш SubID1 потока
subid2 Ваш SubID2 потока
subid3 Ваш SubID3 потока
subid4 Ваш SubID4 потока
ip IP адрес клиента

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

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

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 параметры:

aim цель оффера, для которой отобразить цены и выплаты

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

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,
  "aims":
  [
    "approved",
    "install"
  ],
  "current_aim": "approved"
}

id id оффера
title Название оффера
description Описание оффера
category Категория оффера
targets Объект сумм выплат за лид в соответствии с гео
mob_targets Объект сумм выплат за мобильный лид в соответствии с гео
prices Объект цен за товар для разных гео
is_active Активен ли оффер
aims Доступные цели в оффере
current_aim Цель, для которой в текущем запросе отображаются цены и выплаты

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

aim цель оффера, для которой отобразить цены и выплаты

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

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

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

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

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