Documentation de l'API

Intégrez le moteur de calcul KDP le plus fiable du marché.

Authentification

Toutes les requêtes à l'API GabaritKDP doivent être authentifiées. Vous pouvez obtenir votre clé API depuis votre tableau de bord après avoir souscrit au plan Pro.

La clé doit être passée dans l'en-tête (header) de chaque requête :

'Authorization': 'Bearer VOTRE_CLÉ_API'

Endpoint Principal : Calculer les Dimensions

Cet endpoint est le cœur de l'API. Il prend les paramètres de votre livre et retourne toutes les dimensions nécessaires pour créer une couverture KDP conforme.

POST https://api.gabaritkdp.com/v1/calculate

Paramètres de la Requête (JSON)

Le corps de votre requête POST doit être un objet JSON contenant les clés suivantes :

Paramètre	Type	Requis	Description
`format`	string	Oui	Le format KDP du livre. Voir les valeurs possibles ci-dessous.
`pageCount`	integer	Oui	Le nombre total de pages du livre (entre 24 et 828).
`paperType`	string	Oui	Le type de papier. Valeurs : 'white', 'cream', 'color_standard', 'color_premium'.
`bindingType`	string	Oui	Le type de reliure. Valeurs : 'paperback', 'hardcover'.

Valeurs possibles pour 'format'

                        
                            '5x8'
                            '5.25x8'
                            '5.5x8.5'
                            '6x9'
                            '6.14x9.21'
                            '6.69x9.61'
                            '7x10'
                            '8x10'
                            '8.5x11'
                            '6x9-hc'
                            '7x10-hc'
                            '8.25x11-hc'
                        
                    

Exemple de Requête (JavaScript)


fetch('https://api.gabaritkdp.com/v1/calculate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer VOTRE_CLÉ_API',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "format": "6x9",
    "pageCount": 120,
    "paperType": "white",
    "bindingType": "paperback"
  })
})
.then(res => res.json())
.then(console.log);

Exemple de Réponse (Succès)


{
  "total_width_mm": 314.96,
  "total_height_mm": 234.95,
  "spine_mm": 7.62,
  "bleed_mm": 3.175,
  "canva_width_px": 3719,
  "canva_height_px": 2775,
  "source": "API"
}

Codes d'Erreur

L'API utilise les codes de statut HTTP standards pour indiquer le succès ou l'échec d'une requête.

Code	Signification	Cause Possible
`200 OK`	Succès	La requête a été traitée avec succès.
`400 Bad Request`	Mauvaise Requête	Un paramètre est manquant, invalide ou hors des limites (ex: 10 pages).
`401 Unauthorized`	Non Autorisé	La clé API est manquante ou invalide.
`403 Forbidden`	Interdit	Votre plan ne vous donne pas accès à l'API ou votre quota est dépassé.
`500 Internal Server Error`	Erreur Serveur	Un problème est survenu de notre côté. Veuillez réessayer plus tard.