Authentification API

Dernière mise à jour le 2 novembre 2026

Chaque requête envoyée à l’API PDFMonkey doit inclure votre clé API secrète. Cette page explique comment trouver votre clé, l’envoyer avec vos requêtes et vérifier que l’authentification fonctionne.

Trouver votre clé API secrète #

Votre clé API secrète est disponible sur la page dédiée Clé API du Dashboard PDFMonkey, accessible directement depuis la barre latérale.

Gardez votre clé secrète

Votre clé API secrète dispose des mêmes privilèges que votre compte. Ne la partagez pas publiquement et ne la versionnez pas dans votre dépôt de code. Si vous pensez que votre clé a été compromise, renouvelez-la et révoquez immédiatement la clé précédente.

Envoyer votre clé avec les requêtes #

Transmettez votre clé dans l’en-tête HTTP Authorization, préfixée par Bearer :

Authorization: Bearer VOTRE_CLE_SECRETE

Effectuer un appel API de test #

Pour vérifier que l’authentification fonctionne, appelez l’endpoint current_user :

GET https://api.pdfmonkey.io/api/v1/current_user
Authorization: Bearer VOTRE_CLE_SECRETE

Avec curl, la requête ressemble à ceci :

curl https://api.pdfmonkey.io/api/v1/current_user \
  -H "Authorization: Bearer VOTRE_CLE_SECRETE"

Une réponse réussie renvoie les informations de votre compte :

{
  "current_user": {
    "id": "12345678-90ab-cdef-1234-567890abcdef",
    "auth_token": "1234567890ABCDEF1234",
    "available_documents": 300,
    "created_at": "2022-01-01T12:34:56.123+00:00",
    "current_plan": "free",
    "current_plan_interval": "month",
    "desired_name": "Marie Dupont",
    "email": "marie.dupont@example.com",
    "lang": "fr",
    "paying_customer": false,
    "trial_ends_on": "2022-01-15",
    "updated_at": "2022-01-01T12:34:56.123+00:00",
    "block_resources": true,
    "share_links": false
  }
}

Erreurs d’authentification #

Si la clé est manquante ou invalide, l’API renvoie une réponse 401 Unauthorized :

{
  "errors": [
    {
      "status": "401",
      "title": "Unauthorized",
      "detail": "We were unable to authenticate you based on the provided API key. Please verify that you provided the intended key."
    }
  ]
}

Renouveler votre clé API #

Pour remplacer votre clé, cliquez sur Renouveler la clé d’API sur la page Clé API. Vous obtenez tout de suite une nouvelle clé, et votre clé précédente reste valable 2 jours : de quoi mettre à jour vos intégrations sans interruption.

Une fois que tout utilise la nouvelle clé, cliquez sur Révoquer la clé précédente pour désactiver l’ancienne clé immédiatement. Sinon, elle expire d’elle-même au bout de 2 jours. Vous pourrez la renouveler à nouveau une fois la clé précédente expirée ou révoquée.

Si votre clé a été compromise, n’attendez pas : renouvelez-la et révoquez aussitôt la clé précédente.

Étapes suivantes #

Maintenant que vous pouvez vous authentifier, vous pouvez :

Questions fréquentes

Comment s’authentifier avec l’API PDFMonkey ?
Passez votre clé API secrète dans l’en-tête HTTP Authorization sous forme de token Bearer. Le format est : Authorization: Bearer VOTRE_CLÉ_SECRÈTE. Chaque requête à l’API PDFMonkey nécessite cet en-tête.
Où trouver ma clé API PDFMonkey ?
Votre clé API secrète est disponible sur la page Clé API du tableau de bord PDFMonkey, accessible directement depuis la barre latérale.
Que faire si ma clé API PDFMonkey est compromise ?
Renouvelez-la depuis la page Clé API du Dashboard, puis cliquez sur Révoquer la clé précédente pour que l’ancienne clé cesse aussitôt de fonctionner. Sans révocation, la clé précédente reste valable 2 jours.
Comment renouveler ma clé API PDFMonkey sans interruption ?
Cliquez sur Renouveler la clé d’API depuis la page Clé API du Dashboard. Vous obtenez tout de suite une nouvelle clé, et la précédente reste valable 2 jours, le temps de mettre à jour vos intégrations.
Navigation