Supporto

Contatti

Email sviluppatori: [email protected]
Dashboard: gestisci chiavi, consumo e webhooks su my.kinmu.app → Sviluppatori .

Per le segnalazioni includi sempre il code dell’errore, l’endpoint, il webhook-id (se applicabile) e l’orario approssimativo. Non condividere mai la tua chiave API in un ticket.

Prima di aprire un ticket

La tabella dei codici spiega ogni code e la sua causa.

Rivedi gli errori

Un 403 invalid_scope è quasi sempre uno scope mancante.

Controlla i tuoi scopes

Un 429 indica burst o quota; controlla gli header X-RateLimit-*.

Guarda i limiti

Diagnosi rapida

Sintomo	Prima verifica
`401 unauthenticated`	Header `Authorization: Bearer …`; chiave non revocata né scaduta.
`403 invalid_scope`	La chiave ha lo scope richiesto dall’endpoint.
`403 addon_disabled`	L’addon Public API è attivo per l’azienda.
`403 subscription_inactive`	L’abbonamento è in regola.
`404 not_found`	La risorsa esiste e appartiene alla tua azienda.
`409 idempotency_conflict`	Hai riusato una `Idempotency-Key` con un altro body.
`429`	Attendi i secondi di `Retry-After`; distanzia le richieste.
Il webhook non arriva	Endpoint attivo, risponde `2xx` in < 10 s e firma verificata.

Sicurezza

Pensi che una chiave sia compromessa? Revocala subito dalla dashboard e controlla il last_used_ip nel dettaglio della chiave. Per segnalare una vulnerabilità, scrivi a [email protected] con oggetto [SECURITY].

Stato del servizio

Gli avvisi di manutenzione, incidenti e deprecazioni vengono comunicati via email alla mailing list degli sviluppatori e registrati nel changelog.