Все методы API доступны только по защищенному https-каналу и расположены по адресу https://api.pyrus.com.

В каждом запросе к API должен быть указан HTTP заголовок Authorization:

Authorization: Bearer access_token.

Как получить access_token, описано в разделе Авторизация.

Параметры GET запросов передаются в URL, и в случае наличия специальных символов должны быть экранированы с помощью urlencode.

Параметры POST запросов и все ответы сервера передаются в формате JSON.

Даты передаются в формате ISO 8601. Ответ от сервера всегда приходит с нулевой временной зоной.

При передаче чисел в качестве разделителя целой и дробной части используется точка.

Пустые поля в ответе не возвращаются.

В случае ошибочного вызова возвращается наиболее подходящий HTTP Status Code. Также в случае ошибки предоставляется дополнительная информация, включающая поля error — сообщение об ошибке и error_code — код ошибки.

В разделе Ошибки и ограничения вы найдете описание наиболее распространенных ошибок.