Le chiavi di API
Ogni KPainter OpenAPI endpoint, ad eccezione di GET /Health, utilizza la chiave API dell'utente:
Authorization: Bearer <your_api_key>Attivare e copiare una chiave dal Pagina chiave API.
Verificare la connessione prima
curl -s "https://api.kpainter.ai/openapi/v1/me" \ -H "Authorization: Bearer $KPAINTER_API_KEY"Una risposta di successo restituisce un conto sicuro e una sintesi del piano. Verifica questo prima di creare contenuti.
Trovare le chiavi in sicurezza
- Mantenere ogni chiave in un negozio segreto sul server o una connessione di agente affidabile.
- Non mettere mai una chiave nel codice del browser, un pacchetto mobile, una screenshot o i log.
- Non utilizzare una chiave condivisa per utenti finali non correlati.
- Non esprimere mai la chiave completa in un messaggio di errore.
- Chiedi all'utente di ri-connettersi dopo una riavviazione della chiave.
Risposte comuni
- 401: la chiave è mancante, invalida o inattiva.
- 403: il conto non può utilizzare la capacità richiesta.
- 422: un campo o una combinazione di parametri è invalida.
- 429: le domande sono troppo frequenti; seguire le linee guida di risposta prima di ritirarsi.
- Insufficiente bilancio: la creazione riferisce uno stato riposato, crediti stimati e un'azione disponibile. Non creare un duplicato.
L'attivazione, la ristrutturazione e la cancellazione delle chiavi API rimangono sul sito web di KPainter; l'OpenAPI non gestisce le chiavi.