Skip to content

L'authentification

On this page

Chaque demande à Curriculo API porte votre clé de console de développement comme jeton porteur:

Authorization: Bearer key_<id>_<secret>
curl -X POST https://api.curriculo.me/public/detect-language/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -H 'Content-Type: application/json' \
  -d '{"text": "Ingeniera de software con diez años de experiencia"}'

Une clé, chaque opération.

Une clé de console fonctionne pour chaque opération dès sa création. Il n'y a pas d'identification par point final, pas de champs d'application et pas de demande par capacité. Il n'y a pas de connexion ATS, pas de cookie de session et pas d'en-tête d'organisation.

J' obtiens les clés API

Connectez-vous à la console de développement et ouvrez les touches API.

  • Chaque clé peut porter un nom et un à expiration facultative. Une clé sans expiration fonctionne jusqu'à ce que vous la révoquiez.
  • La valeur de texte clair est retournée une fois, lors de la création. Seuls un préfixe de 16 caractères et un hash SHA-256 sont stockés, donc une clé perdue est remplacée, jamais récupérée.
  • Le retrait est immédiat. La prochaine demande avec une clé révoquée obtient 401.
  • Un compte peut contenir 25 clés actives.

Qu'est-ce qu'une clé a besoin pour servir le trafic ?

Une clé est acceptée lorsque son compte:

  • a terminé la fourniture (c'est le cas lors de la première connexion);
  • a un solde de crédit prépayé supérieur à zéro (les nouveaux comptes commencent par un crédit gratuit de 5.00 $);
  • n'est pas suspendue.

L'hygiène de base

Traitez une clé API comme un mot de passe. Ne jamais l'engager à la source de contrôle ou le coller dans un client non fiable, et le révoquer dès qu'il est exposé.

  • Émettre des clés séparées par environnement ou équipe pour maintenir l'utilisation attributable et chaque clé révocable indépendamment.
  • Les clés sont envoyées à votre organisation et rien d'autre ne se voit.
  • Une clé ne peut pas gérer le compte. Il ne peut ni fabriquer des clés ni modifier la facturation, de sorte qu'une clé fuite ne peut jamais devenir un contrôle du compte.

Erreurs d'authentification

Le statutLe messageCe qu'il faut faire
401"Le jeton API manquant... "Envoyez l'en-tête Authorization: Bearer .
401"Token API invalide".La clé est inconnue ou révoquée. Créez une nouvelle clé.
401"Le jeton API a expiré".La clé a passé son expiration. Créez une nouvelle clé.
401"point final inconnu de API"Le chemin sous /public/ n'existe pas. Vérifiez l'orthographe et la traîne.
403Aucun crédit prépayé ("... Acheter des crédits dans la console. ")Ajouter du crédit dans la console → facturation.
403Compte suspenduContactez-nous.
403"L'épargne de compte est incomplète"Attendez que les approvisionnements se terminent après la première connexion.

Voir Erreurs pour la liste complète.

Updated