RU
EN
DE
ES
PL
PT-BR
PT-PT
TR
VI
ZH-CN
Основная информация по API
Вступление
Добро пожаловать в SkinsBack API.
Если у вас есть какие-либо вопросы или предложения, пожалуйста, свяжитесь с нами.
Взаимодействие с API SkinsBack осуществляется через Endpoint https://skinsback.com/api.php, на который необходимо передавать данные через POST запросы.
Аутентификация
Все запросы API требуют аутентификацию. На выбор предоставлено два варианта аутентификации: через HTTP заголовки или через подпись.
Аутентификация через HTTP заголовки (более простая)
Необходимо передавать два параметра в заголовках HTTP запроса:
X-CLIENT-ID — значение Client ID из настроек проекта
X-CLIENT-SECRET — значение Client Secret из настроек проекта
Аутентификация через подпись (более сложная)
При использовании устаревшего метода аутентификации необходимо передавать два POST параметра:
shopid — значение Client ID из настроек проекта
sign — подпись, сгенерированная по правилам, описанным в разделе Генерация подписи.
Структура ответа
Ответы у всех методов API в формате JSON.
Успешные вызовы API будут иметь респонс:
{"status":"success", some data..}
Неуспешные запросы будут содержать error_code и error_message:
{"status":"error", "error_code": 5, "error_message":"some_error"}
Ограничение количества запросов
В нашей системе установлен лимит в 500 запросов к серверу в минуту. Если этот лимит превышен, произойдет временная блокировка, а ответ API будет следующим:
{"status":"error", "error_code": -7, "error_message":"request_limit_reached"}