Informações básicas da API
Introdução
Bem-vindo à API SkinsBack.
Caso tenha alguma dúvida ou sugestão, contacte-nos.
A interação com a API SkinsBack é realizada através do Endpoint https://skinsback.com/api.php, para o qual os dados devem ser transmitidos através de pedidos POST.
Autenticação
Todas as solicitações de API requerem autenticação. Existem duas opções de autenticação: através de cabeçalhos HTTP ou através de assinatura.
Autenticação através de cabeçalhos HTTP (mais fácil)
É necessário passar dois parâmetros nos cabeçalhos de pedido HTTP:
X-CLIENT-ID — o valor do ID do Cliente nas definições do projeto
X-CLIENT-SECRET — o valor do Segredo do Cliente nas definições do projeto
Autenticação através de assinatura (mais complexa)
Quando utilizar o método de autenticação legado, deve passar dois parâmetros POST:
shopid — o valor do ID do Cliente nas definições do projeto
sign — a assinatura gerada de acordo com as regras descritas na secção Geração de assinaturas.
Estrutura de resposta
Todos os métodos da API têm respostas JSON.
As chamadas API bem-sucedidas terão a seguinte resposta:
{"status":"success", some data..}
Os pedidos mal sucedidos conterão error_code e error_message:
{"status":"error", "error_code": 5, "error_message":"some_error"}
Limitando o número de pedidos
O nosso sistema tem um limite de 500 pedidos ao servidor por minuto. Se este 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"}