Общая информация

Обзор

API Recreativ предоставляет доступ к инфраструктуре Recreativ через стандартизированный программный интерфейс. Через API Recreativ Вы можете сделать все то же самое, что доступно при использовании кабинета Recreativ.ru, но при помощи выбранного Вами языка программирования.

API Recreativ это RESTful API, базирующееся на HTTP запросах и ответах в формате XML или JSON(P). Если Вы знакомы с API Twitter, Amazon S3, del.icio.us, или другим web-сервисом, Вам не составит труда начать работу с нашим API.

Эта версия API для авторизации использует механизм токенов. Это значит, что все запросы должны быть зашифрованы и посланы через SSL/TLS на https://. Это также значит, что каждый запрос должен сопровождать специально сформированный заголовок HTTP, в котором будет ключ авторизации. Этот ключ Вы можете узнать в своем личном кабинете на странице профиля.

Пример кода

user@localhost:~$ curl 'https://recreativ.ru/api/advertiser/campaigns?filter[id]=111,222' \
     -H 'Content-Type: application/json; charset=UTF-8' \
     -H 'Accept: application/json' \
     -H 'Auth-Token: eNldKDZHFuemaotqp6166WhZ0nximcHz'
     -v
> GET /api/advertiser/campaigns?filter[id]=111,222 HTTP/1.1
> User-Agent: curl/7.35.0
> Host: recreativ.ru
> Content-Type: application/json; charset=UTF-8
> Accept: application/json
> Auth-Token: eNldKDZHFuemaotqp6166WhZ0nximcHz
> < HTTP/1.1 200 OK< Server: nginx< Date: Wed, 18 Feb 2015 15:34:24 GMT< Content-Type: application/json; charset=UTF-8< Transfer-Encoding: chunked< Connection: keep-alive<
[  
   {  
      "id":111,
      "title":"Первая кампания",
      "active":1,
      "maxclicks":0,
      "maxmoney":"0.0000",
      "isRetarget":0
   },
   {  
      "id":222,
      "title":"Вторая кампания",
      "active":1,
      "maxclicks":1000,
      "maxmoney":"25.0000",
      "isRetarget":0
   }
]

Нужна помощь?

Если у Вас возникли вопросы, задавайте их нашей службе поддержки на почту, icq или через форму на сайте. Все необходимые реквизиты Вы можете найти на странице Контакт.

Точка входа

API доступно через осуществление HTTP запросов на определенный URL, в котором в GET и POST переменных содержится информация о том, что именно Вы хотите сделать. Все точки входа доступны только через зашифрованное HTTPS соединение.  

Стабильная корневая точка входа последней версии:

https://recreativ.ru/api/

Формат ответа API

Для передачи данных используются XML и JSON. Выбор конкретного формата зависит от заголовка Accept в запросе к серверу. Для получения ответа в JSON значение этого заголовка должно содержать MIME тип JSON - application/json, для XML - application/xml. Все общение с сервером происходит по протоколу HTTPS.

Ответ может быть сформирован как в формате JSON, так и в XML. Это поведение зависит от переданного заголовка Accept, который должен содержать тип желаемого ответа.

Авторизация

Авторизация происходит с помощью специального ключа, т.н. access token, который должен сопровождать каждый запрос к серверу в заголовке запроса Auth-Token.

Для подключения API необходимо связаться с нашей службой поддержки, после чего Ваш персональный ключ для авторизации в API будет доступен в настройках личного кабинета.

Ограничение запросов

Число запросов к API в секунду ограничено 5 запросами. При превышении этого числа, вы получите ответ сервера c кодом 429.

Навигация по API