Sfoglia la documentazione
Autenticarsi con chiavi API Bearer
Le richieste degli sviluppatori utilizzano chiavi API generate dall’area di lavoro TurnitPass.
Auth console
Tieni le chiavi API fuori dal browser.
Le chiamate API TurnitPass usano una chiave Bearer dello spazio di lavoro. La chiave sta nel codice solo server; la dashboard resta il luogo per creare, ruotare, revocare e ispezionare l’uso.
Protezioni della chiave
Come mantenere l’accesso sicuro
Solo server
Invia le chiavi da route backend, worker, job o server action sicure.
Mostrata una volta
Copia subito la chiave generata e conservala nel secret manager.
Ruota in sicurezza
Distribuisci la chiave di sostituzione prima di revocare la vecchia chiave di produzione.
Ambito account
L’uso confluisce nel saldo parole e nei controlli di fatturazione dello spazio di lavoro.
Richiesta Bearer
Contratto dell’header
fetch('https://turnitpass.com/api/v1/humanize', {
method: 'POST',
headers: {
Authorization: 'Bearer tp_live_your_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({ text: draft, language: 'en' })
})
{
"error": "Invalid or revoked API key.",
"code": "invalid_api_key"
}
Chiavi API
Invia `Authorization: Bearer tp_your_api_key` con ogni richiesta. Le chiavi vengono mostrate una sola volta e possono essere revocate dall’area di lavoro.
Authorization: Bearer tp_live_your_api_key
Content-Type: application/json
POST /api/v1/humanize
Managing keys
Crea
Genera una chiave con nome dallo spazio di lavoro e copiala subito.
Revoca
Disattiva una chiave all’istante. Le chiavi revocate non possono autenticare nuove richieste.
Rate limit
Ogni chiave può essere limitata in modo indipendente, mentre l’uso confluisce sull’account.
Fatturazione
Tutte le chiavi condividono il saldo parole e i limiti di abbonamento dell’account.
Di proprietà dello spazio di lavoro
Key lifecycle
Crea una chiave con nome
Usa un nome che descriva l’ambiente o la superficie, ad esempio Production backend, Staging worker o Internal QA.
Copiala una volta in un secret store
TurnitPass mostra la chiave solo alla creazione. Conservala nel provider di deploy, nel secret manager CI o nel file .env locale.
Monitora l’uso con status e fatturazione
Tutte le chiavi condividono il saldo parole; i nomi aiutano a capire quale integrazione è attiva.
Ruota prima di revocare
Crea una chiave di sostituzione, distribuiscila, conferma che il traffico è sano, poi revoca la vecchia chiave dallo spazio di lavoro.
Environment setup
Conserva le chiavi TurnitPass come secret solo server. Gli esempi sotto usano nomi generici per Next.js, Workers, job server o qualsiasi runtime backend.
TURNITPASS_API_KEY=tp_live_your_api_key
TURNITPASS_API_BASE_URL=https://turnitpass.com/api/v1
Security best practices
Authentication errors
{
"error": "Invalid or revoked API key.",
"code": "invalid_api_key"
}