Introdução
Bem-vindo à thinkStore api! Você pode utilizar a nossa API para aceder aos pontos finais da API thinkStore. Uma api com o objectivo de criar soluções de comércio eletrónico.
Temos exemplos da utilização da api em varias linguagem de programação, em Shell, JavaScript, PHP! Podem visualizar exemplos de código na área escura para a direita e podem alternar a linguagem de programação dos exemplos com as abas no canto superior direito.
A thinkStore API é organizada em torno de REST. A nossa API possui URLs previsíveis, orientados a recursos e usa códigos de resposta HTTP para indicar erros de API. Usamos recursos HTTP incorporados, como autenticação HTTP e verbos HTTP, que são entendidos por clientes HTTP convencionais.
Comece já a utilizar a thinkStore API, se ainda não possui uma chave de Authenticação, entre em contacto connosco.
Autenticação
Para obter autorização, use este código:
curl -X POST
-F "email=test@thinknew.pt"
-F "password=AsdFgh#56jk"
"http://api.thinkstore.pt/api/v1/auth/login"
Brevemente
Brevemente
Brevemente
Na resposta obtera a sua chave token:
{
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}
Nos restantantes pedidos de recurso, use esta código:
curl "api_endpoint_here"
-H "Authorization: Bearer yourtokenwhere"
Brevemente
Brevemente
Brevemente
Certifique-se que substitui
yourtokenwherepela sua chave API.
A thinkStore API utiliza chave Token para permitir o acesso à API. Para obter uma chave Token é necessário validar as credenciais de um utilizador. Se ainda não possui credenciais de autenticação, entre em contacto connosco.
Após ter as credenciais, utilizador e a respetiva palavra-chave é necessário fazer um pedido POST para https://api.thinkstore.pt/api/v1/auth/login para obter a chave token para validar os restantes pedidos.
A thinkStore API espera que a chave da API seja incluída em todas as solicitações da API para o servidor em um cabeçalho que se pareça com o seguinte:
Authorization: Bearer yourtokenwhere
Erros
A ThinkStore API usa os seguintes códigos de erro:
| Cod. | Designação |
|---|---|
| 400 | Requisição inválida – O pedido não pode ser entregue devido à sintaxe incorreta. |
| 401 | Não autorizado – Solicitou informação que necessita de credenciais de acesso. |
| 403 | Proibido – Solicitou informação que as suas credenciais não premitem o acesso. |
| 404 | Não encontrado – O recurso requisitado não foi encontrado. |
| 405 | Método não permitido – Foi feita uma solicitação de um recurso usando um método de pedido que não é compatível com esse recurso. |
| 406 | Não Aceitável – O recurso solicitado é apenas capaz de gerar conteúdo não aceitáveis de acordo com os cabeçalhos Accept enviados na solicitação. |
| 410 | Gone – Indica que o recurso solicitado não está mais disponível e não estará disponível novamente. |
| 429 | Muitos pedidos – Foram solicitados demasiados recursos num pequeno intervalo de tempo. |
| 500 | Erro interno do servidor – Indica um erro do servidor ao processar a solicitação. |
| 501 | Não implementado – O servidor ainda não suporta a funcionalidade ativada. |
| 503 | Serviço indisponível – servidor está em manutenção ou não consegue dar conta dos processamentos de recursos devido à sobrecarga do sistema. |