Início rápido
Do token à primeira key em quatro passos.
Crie um token
No painel, em API › Tokens, crie um token com as permissões que o seu sistema precisa. Copie na hora: ele aparece uma vez só.
Na mesma tela, o exemplo de uso mostra o endereço da API. Copie também.
Guarde o token no servidor
Coloque o endereço e o token em variáveis de ambiente do servidor que vai chamar a API:
export PROJECT_API_URL="cole aqui o endereço do painel"
export PROJECT_TOKEN="prj_live_..."Nunca coloque o token em site, aplicativo ou programa que roda no computador do cliente: qualquer um conseguiria ler o token e gastar o seu saldo.
Teste com /me
Se voltar a sua conta e as permissões do token, está tudo certo:
curl -sS "$PROJECT_API_URL/me" \
-H "Authorization: Bearer $PROJECT_TOKEN" \
-H "Accept: application/json"Gere a sua primeira key
Pegue um product_id em Listar produtos e gere uma key:
curl -sS -X POST "$PROJECT_API_URL/keys" \
-H "Authorization: Bearer $PROJECT_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 3f1c9e2a-7b4d-4c1e-9a0f-5d2b8c6e1a47" \
-d '{"product_id":1001,"quantity":1,"days":30}'O cabeçalho Idempotency-Key é o que impede cobrar duas vezes se a conexão cair. Entenda a idempotência.
E depois?
- Veja o fluxo de venda completo, do catálogo à entrega da key.
- Receba avisos no seu sistema com os webhooks.
- Prefere testar sem escrever código? Use a coleção do Postman.