L'APi de pdf.kiwi propose deux points d'entrée différents. L'un pour la conversion de contenu HTML directement envoyé à l'API sous forme de chaîne de caractère, l'autre pour convertir une page web distante en envoyant à l'API son URL.

1 - https://pdf.kiwi/api/convert/html

Utilisez cette adresse avec la méthode HTTP POST pour convertir n'importe quel contenu HTML en PDF.

Paramètres

Dans le corps de votre requête, vous devrez envoyer les paramètres suivants, au format form-data :

clé type description
email string (requis) Votre adresse email
token string (requis) La clé d'accès (token) à votre abonnement
html string (requis) La chaîne de caractère représentant votre contenu HTML à convertir en PDF
options array (facultatif) Un tableau d'options pour personnaliser au maximum votre document PDF

Exemple de contenu de requête :

{
    "email"   : "votre@email.com",
    "token"   : "1234567890abcdef123456789abcdef",
    "html"    : "<h1>Votre contenu HTML</h1><p>Lorem ipsum dolor sit amet</p>",
    "options" : {
        "header_text_left" : "Essai de conversion HTML en PDF avec pdf.kiwi",
        "orientation"      : "landscape",
        "page_size"        : "A5"
    }
}

Particularités de cette méthode

Suppression des ressources avec URL relatif

Lors de la conversion d'un contenu HTML en PDF, pdf.kiwi va supprimer automatiquement les ressources qui ont un URL relatif, pour des raisons de sécurité, mais aussi pour éviter la génération d'erreurs réseau (network error, voir la liste des erreurs).

Par exemple, si dans votre HTML se trouve un <link rel="stylesheet" href="/css/votre-style.css"> cette balise sera supprimée et votre feuille de style ne sera pas chargée. veillez donc bien à toujours définir l'URL de vos ressources avec un lien absolu, mais aussi à ce que ces URL soient toujours accessibles en HTTP (ou HTTPS) depuis l'extérieur.


2 - https://pdf.kiwi/api/convert/url

Utilisez cette adresse avec la méthode HTTP POST pour convertir n'importe quelle page web en PDF.

Paramètres

Dans le corps de votre requête, vous devrez envoyer les paramètres suivants, au format form-data :

clé type description
email string (requis) Votre adresse email
token string (requis) La clé d'accès (token) à votre abonnement
url string (requis) L'adresse web de la page web à convertir en PDF
options array (facultatif) Un tableau d'options pour personnaliser au maximum votre document PDF

Exemple de contenu de requête :

{
    "email"   : "votre@email.com",
    "token"   : "1234567890abcdef123456789abcdef",
    "url"     : "http://votre-site.com/votre-page/",
    "options" : {
        "header_text_left" : "Essai de conversion d'URL en PDF avec pdf.kiwi",
        "orientation"      : "landscape",
        "page_size"        : "A5"
    }
}

Particularités de cette méthode

Remplacement des URL relatifs par des URL absolus

Lors de la conversion d'une page web en PDF, pdf.kiwi va remplacer automatiquement les URL relatifs par des URL absolu, en utilisant l'URL fourni dans la requête comme base.

Par exemple, si vous donnez comme URL à convertir http://votre-site.com/page-a-convertir/, et que sur cette page se trouve une balise
<link rel="stylesheet" href="/css/votre-style.css">,
alors la balise sera modifiée comme ceci :
<link rel="stylesheet" href="http://votre-site.com/css/votre-style.css">

résultats pour ""

    Aucun résultat pour ""