Authentification API

Dernière mise à jour le 23 mars 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, régénérez-la depuis la page Clé API.

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."
    }
  ]
}

É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 ?
Régénérez-la immédiatement depuis la page Clé API du Dashboard. L’ancienne clé cessera de fonctionner et une nouvelle sera émise.
Navigation