PT-BR
EN
DE
ES
PL
PT-PT
RU
TR
VI
ZH-CN
Informações básicas da API
Introdução
Bem-vindo à API SkinsBack.
Caso tenha alguma dúvida ou sugestão, entre em contato conosco.
A interação com a API SkinsBack é realizada por meio do Endpoint https://skinsback.com/api.php, para o qual os dados devem ser transmitidos por meio de solicitações POST.
Autenticação
Todas as solicitações de API exigem autenticação. Há duas opções de autenticação: via cabeçalhos HTTP ou via assinatura.
Autenticação via cabeçalhos HTTP (mais fácil)
É necessário passar dois parâmetros nos cabeçalhos de requisição HTTP:
X-CLIENT-ID — o valor do ID do Cliente nas configurações do projeto
X-CLIENT-SECRET — o valor do Segredo do Cliente nas configurações do projeto
Autenticação via assinatura (mais complexa)
Ao utilizar o método de autenticação legado, você deve passar dois parâmetros POST:
shopid — o valor do ID do Cliente nas configurações do projeto
sign — a assinatura gerada de acordo com as regras descritas na seção Geração de assinatura.
Estrutura de resposta
Todos os métodos da API têm respostas JSON.
Chamadas de API bem-sucedidas terão a seguinte resposta:
{"status":"success", some data..}
Solicitações malsucedidas conterão error_code e error_message:
{"status":"error", "error_code": 5, "error_message":"some_error"}
Limitando o número de solicitações
Nosso sistema tem um limite de 500 requisições ao servidor por minuto. Se esse limite for excedido, ocorrerá um bloqueio temporário e a resposta da API será a seguinte:
{"status":"error", "error_code": -7, "error_message":"request_limit_reached"}