GET, POST, PUT, PATCH, DELETE).
Base URL
Todas as chamadas partem desta base:/public, então uma chamada completa fica assim:
Valores monetários
Todo valor monetário atravessa a API como string, nunca como número: umfloat de JSON perde centavos em valores grandes.
São duas convenções, e a diferença importa:
Nos endpoints de métricas e de resumo de vendas,
"19990" em USD são 199,90 dólares. Divida pelo fator da moeda antes de exibir.
O corpo que você envia é o oposto: price e shipping_cost vão como número decimal (199.9).
Primeiros passos
1
Crie uma chave de API
No painel, na seção Desenvolvedores, gere uma chave e escolha os escopos. Veja Chaves de API.
2
Autentique a chamada
Envie a chave no header HTTP
Authorization como Bearer token. Veja Autenticação.3
Faça a primeira chamada
Liste seus produtos com um
GET /public/products e confira a resposta.Conceitos
O que mudou
Para quem já integrava com o endereço antigo.
Autenticação
Chaves de API enviadas como Bearer token.
Ambientes
Chaves de teste (
sk_test_) e de produção (sk_live_).Idempotência
Repita operações que alteram dados com segurança usando
Idempotency-Key.Paginação
Resultados em páginas de 15 por padrão.
Rate limits
Limites por chave, por minuto.
Erros
Envelope de erro e a tabela de tipos.