Primeiros passos

Do zero à primeira requisição autenticada em poucos minutos.

1. Crie uma API Key

No painel da Pitra, acesse API e crie uma chave. Escolha o ambiente (test ou live) e marque apenas os scopes de que a sua integração precisa. A secret completa aparece uma única vez — copie e guarde num cofre de segredos.

2. Faça sua primeira requisição

curl https://pitra.com.br/api/public/v1/products?limit=2 \
  -H "Authorization: Bearer sk_live_..."

Resposta:

{
  "object": "list",
  "data": [ { "object": "product", "id": "..." } ],
  "has_more": false,
  "next_cursor": null
}

3. Configure seus webhooks

Registre um endpoint https público e escolha os eventos. A Pitra devolve o secret de assinatura uma única vez. Veja Webhooks.

4. Comece a integrar

Sincronize catálogo e checkouts pelos endpoints de escrita, leia vendas pelo endpoint somente-leitura e reaja em tempo real aos eventos entregues no seu endpoint.

Toda resposta traz o header X-Request-Id. Guarde esse valor nos seus logs: ele identifica a requisição em qualquer investigação de suporte.