Referência da API
Verificar créditos
GET /api/v1/credits: número de experimentações restantes na sua conta.
Os exemplos de código, os pontos de extremidade e os códigos de erro são os mesmos em todas as línguas.
GET https://www.tryoncloud.com/api/v1/credits
Devolve o número de «experiências» que a sua conta ainda pode realizar, a partir do mesmo conjunto de recursos que a chamada POST /generate utiliza.
Pedido
bash
curl https://www.tryoncloud.com/api/v1/credits -H "X-API-KEY: $TRYONCLOUD_API_KEY"Resposta
json
{
"credits_remaining": 4870,
"purchased_remaining": 4870,
"purchased_total": 5000,
"free_remaining": 0,
"spends_from": "purchased"
}| Campo | Significado |
|---|---|
credits_remaining | Experimentações que podes fazer agora mesmo. Usa esta aqui |
purchased_remaining | Créditos adquiridos restantes (não têm prazo de validade) |
purchased_total | Todos os créditos adquiridos até à data |
free_remaining | Crédito gratuito restante (utilizável apenas antes da sua primeira compra) |
spends_from | purchased, assim que tiver comprado créditos; caso contrário, free_allowance |
Dicas
- Verifique antes de processar um lote grande e esteja atento caso o
credits_remainingdesça para um nível inferior a alguns dias de utilização. - Limite de requisições: 60 por minuto por chave. Não o chame antes de cada tentativa; um código de erro
402da API/generatejá indica quando atingiu o limite. - Compre créditos na página «Faturação» do painel de controlo.
Erros
| HTTP | código | Significado |
|---|---|---|
| 401 | NO_KEY, INVALID_KEY | Chave em falta ou errada |
| 429 | RATE_LIMITED | Mais de 60 pedidos por minuto |
| 500 | CREDITS_UNAVAILABLE | Problema temporário, tente novamente |