Aller au contenu
TurnitPass
DéveloppeursAPI v1Obtenir une clé API
Parcourir la documentation

DéveloppeursClés API

Créer et faire tourner des clés Bearer

Les clés se gèrent dans l’espace de travail. Cette page décrit le cycle de vie, le modèle de sécurité et le schéma de requête pour les intégrations en production.

REST API v1

Votre plateforme

Aperçu

espace de travail
GET/api/v1/status
lié au compte
contrôle de statut
GET /api/v1/status
curl https://turnitpass.com/api/v1/status \
  -H "Authorization: Bearer tp_live_your_api_key"

Notes

01

Format de clé

La clé s’affiche une seule fois à la création et peut être renouvelée depuis l’espace de travail.

02

Stockage

Le secret n’est plus affiché après la première révélation.

03

Limite par défaut

Séparez les clés de production, de préproduction et locales.

Cycle de vie de la clé

Un petit cycle d’exploitation par intégration

1

Nommer l’environnement

Des libellés clairs comme production, préproduction ou démo rendent les journaux d’usage lisibles.

2

Copier une seule fois

Le jeton complet n’apparaît qu’à la création. Rangez-le dans les secrets serveur, pas côté client.

3

Vérifier le statut d’abord

Utilisez GET /api/v1/status pour contrôler la clé, le solde et les limites avant d’envoyer du texte.

4

Rotation sans interruption

Créez la clé de remplacement, déployez, confirmez le trafic, puis révoquez l’ancienne.

Détails de sécurité

Comment fonctionne le système de clés

En-tête
Authorization: Bearer API keyToutes les routes v1 utilisent le même format Bearer.
Stockage
Protégé au reposLe jeton en clair n’est plus renvoyé après la première révélation.
Révocation
ImmédiateUne clé révoquée n’authentifie plus ; le compte et les autres clés restent utilisables.
Portée
Liée au compteUsage, mots, facturation et historique appartiennent au compte de l’espace de travail.
Note d’implémentation. La création et la révocation restent dans l’espace de travail, car elles exigent une connexion. La documentation publique décrit le flux sans exposer de secret.
Ensuite, intégrez-le à votre flux.Continuer la lecture