Passer au contenu principal

​
Vue d’ensemble

Cette page explique authentification, autorisations, expiration et stockage des clés Developer Platform. Chaque clé est liée à un projet et n’autorise que les opérations sélectionnées.

​
Utiliser une clé Developer Platform

Envoyez cet en-tête Authorization avec chaque requête.
Les clés des paramètres d’équipe NoimosAI habituels utilisent les espaces de travail, leurs autorisations et les crédits NoimosAI. Les clés Developer Platform utilisent des projets, autorisations et soldes prépayés en USD distincts.
Les clés ne sont pas interchangeables. Une clé invalide, un manque d’autorisations ou de solde ne déclenche aucun changement automatique d’authentification ou de facturation.

​
Définir les autorisations

À la création, sélectionnez les autorisations requises. Séparez les clés de test de connexion des clés d’exécution payante pour limiter les erreurs. Vérifiez les autorisations nécessaires au projet, devis, exécution et résultat.

​
Qui peut créer des clés

Les membres ADMIN ou DEVELOPER du projet peuvent créer des clés. Même un administrateur d’organisation doit être explicitement membre du projet pour y accéder. Les autorisations du créateur et du projet s’appliquent. La clé cesse de fonctionner si le créateur est désactivé ou retiré du projet, ou si la clé est révoquée.

​
Gérer l’expiration

Choisissez l’expiration dans l’écran de création de clé de Developer Platform, puis vérifiez-la dans la liste des clés. La clé complète ne s’affiche qu’une fois : enregistrez-la en lieu sûr avant de fermer l’écran. Avant expiration, créez une nouvelle clé, migrez les usages puis révoquez l’ancienne. Révoquez immédiatement une clé potentiellement divulguée.

​
Stocker les clés en sécurité

Traitez les clés comme des secrets côté serveur, jamais distribués aux navigateurs des utilisateurs.
  • Stockez-les dans des variables d’environnement ou un gestionnaire de secrets.
  • Ne les écrivez pas dans Git, journaux, écrans d’erreur ou événements analytiques.
  • Ne les intégrez pas aux applications web ou mobiles.
  • Séparez clés et projets de production, validation et développement.
  • Créez des clés par usage avec les seules autorisations nécessaires.

​
Résoudre les erreurs d’authentification

Vérifiez le statut HTTP et l’état de la clé.
  • 401 — Vérifiez Authorization, clé complète, expiration et révocation.
  • 403 — Vérifiez autorisations requises et accès du propriétaire au projet.
  • 429 — Vérifiez limites de requêtes, solde et plafonds mensuels d’organisation ou de projet.
En cas de doute sur l’association clé-endpoint, appelez GET /tools/project avant tout traitement payant.

​
Pages associées

Ces pages expliquent la création des clés et les spécifications communes.