Fundamentos
Autenticação e ambientes
Chaves de API, ambiente de teste e de produção, e como guardar as chaves com segurança.
Toda chamada leva a chave da sua empresa no header x-api-key.
curl https://api.pineplechain.com/v1/me \
-H "x-api-key: ak_mer_••••••••••••••••"Teste e produção
| Teste | Produção | |
|---|---|---|
| Prefixo da chave | ak_mer_ | ak_live_ |
| Rede | XRPL Devnet | XRPL Mainnet |
| Dinheiro | XRP de teste | XRP de verdade |
| Dados | Separados | Separados |
Cada chave pertence ao ambiente em que foi criada. Se o header X-Pineplechain-Mode disser outra coisa, a API responde 409 mode-mismatch. A resposta sempre traz o ambiente no header X-Pineplechain-Mode.
Boas práticas
- A chave aparece uma única vez, na criação. A pineplechain guarda só um hash dela.
- Use a chave só no servidor. Nunca no navegador, no app ou num repositório.
- Crie uma chave por sistema e revogue a que vazar em Integração › Chaves de API. A revogação vale na hora.