API: errori, limiti e tentativi ripetuti

Come funziona, passo dopo passo

1. Controlla sia lo stato HTTP sia il JSON. Gli errori applicativi possono usare HTTP 200 con campo error. Una chiave non valida usa 401; la verifica email può bloccare add con 403 e codice EMAIL_NOT_VERIFIED.
2. Un 429 indica limite raggiunto: rispetta Retry-After. I limiti per chiave ogni 60 secondi sono 30 services, 60 balance, 120 add, 300 status e 60 refill.
3. Se service non è attivo, aggiorna il catalogo. Correggi link e quantità secondo i requisiti; per saldo insufficiente consulta il wallet. Non trattare una risposta error come un ordine riuscito.
4. Un timeout o 503 può lasciare un ordine in verifica. Conserva idempotency_key, controlla gli ordini e contatta l’assistenza prima di ripetere un acquisto di esito incerto.
5. Conserva i segreti in variabili d’ambiente, oscura chiavi e dati personali nei log e revoca le chiavi esposte. Non inserire segreti nel repository o nel frontend.

Esempi API

curl --request POST https://nexwa.store/api/v2 \
  --header "Authorization: Bearer ${NEXWA_API_KEY}" \
  --data-urlencode "action=status" \
  --data-urlencode "order=${NEXWA_ORDER_ID}"

Vai alla funzione

Articoli correlati

• API: servizi, prezzi, ordini, stato e refill
• Come contattare l’assistenza