Url Правила
Материал из Hivext Wiki
Содержание |
Правила формирования адресов
Правила для HTTP протоколов
Путь полностью формируется в нижнем регистре.
http://api.hivext.ru/{версия сервиса}/{пространство имен}/{имя сервиса}/{протокол}/{название метода}
где,
| Версия сервиса | Указано в секции Общая информация для каждого сервиса. |
| Пространство имен | Указано в секции Общая информация для каждого сервиса. |
| Имя сервиса | Указано в секции Общая информация для каждого сервиса. |
| Протокол | Может принимать значения: rest, soap, cross, amf, amfx |
| Название метода | Указано в секции Методы для каждого сервиса. |
Примеры адресов
Примеры формирования адресов на которые отправляются запросы. На примере сервиса Идентификация и аутентификация, метод CheckSign.
Базовые протоколы
Подходят для большинства языков программирования и сред.
HTTP GET | POST, UrlEncoding
http://api.hivext.ru/1.0/users/authentication/rest/checksign?appid=1234567890abcdef&session=1234567890
HTTP POST, application/x-www-form-urlencoded (параметры передаются через форму)
http://api.hivext.ru/1.0/users/authentication/rest/checksign
Javascript
Протокол CROSS используется для кроссдоменных запросов. Ответ приходит в формате JSONP. Класс HttpRequest для осуществления кроссдоменных запросов.
HTTP GET, UrlEncoding
http://api.hivext.ru/1.0/users/authentication/cross/checksign?appid=1234567890abcdef&session=1234567890&cb=mycallback
HTTP POST, application/x-www-form-urlencoded (параметры передаются через форму)
http://api.hivext.ru/1.0/users/authentication/cross/checksign
Actionscript [Flash, Flex]
HTTP GET | POST, AMF (параметры кодируются в формате AMF)
http://api.hivext.ru/1.0/users/authentication/amf/checksign
HTTP GET | POST, AMFX (параметры кодируются в формате AMFX)
http://api.hivext.ru/1.0/users/authentication/amfx/checksign
