Parcourir la documentation
S’authentifier avec des clés API Bearer
Les requêtes de développement utilisent des clés API générées depuis l’espace de travail TurnitPass.
Auth console
Gardez les clés API hors du navigateur.
Les appels API TurnitPass utilisent une clé Bearer appartenant à l’espace de travail. La clé reste dans du code serveur uniquement ; le tableau de bord reste le lieu pour créer, faire tourner, révoquer et inspecter l’usage.
Garde-fous de clé
Comment sécuriser l’accès
Serveur uniquement
Envoyez les clés depuis des routes backend, workers, jobs ou server actions sécurisées.
Affichée une fois
Copiez immédiatement la clé générée et stockez-la dans votre gestionnaire de secrets.
Rotation sûre
Déployez la clé de remplacement avant de révoquer l’ancienne clé de production.
Portée compte
L’usage se consolide sur le solde de mots et les contrôles de facturation de l’espace de travail.
Requête Bearer
Contrat d’en-tête
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"
}
Clés API
Envoyez `Authorization: Bearer tp_your_api_key` avec chaque requête. Les clés sont affichées une seule fois, stockées de façon sécurisée et peuvent être révoquées depuis l’espace de travail.
Authorization: Bearer tp_live_your_api_key
Content-Type: application/json
POST /api/v1/humanize
Managing keys
Créer
Générez une clé nommée depuis l’espace de travail et copiez-la immédiatement.
Révoquer
Désactivez une clé instantanément. Les clés révoquées ne peuvent plus authentifier de nouvelles requêtes.
Limites de débit
Chaque clé peut être limitée indépendamment, tandis que l’usage se consolide sur le compte.
Facturation
Toutes les clés partagent le solde de mots et les limites d’abonnement du compte.
Propriété de l’espace de travail
Key lifecycle
Créer une clé nommée
Choisissez un nom qui décrit l’environnement ou la surface, par exemple Production backend, Staging worker ou Internal QA.
La copier une fois dans un magasin de secrets
TurnitPass n’affiche la clé qu’à la création. Stockez-la dans votre fournisseur de déploiement, le gestionnaire de secrets CI ou un fichier .env local.
Suivre l’usage via status et facturation
Toutes les clés partagent le solde de mots ; les noms de clé aident à identifier l’intégration active.
Faire tourner avant de révoquer
Créez une clé de remplacement, déployez-la, confirmez que le trafic est sain, puis révoquez l’ancienne clé depuis l’espace de travail.
Environment setup
Stockez les clés TurnitPass comme secrets serveur uniquement. Les exemples ci-dessous utilisent des noms génériques pour Next.js, Workers, jobs serveur ou tout 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"
}