ForHosting KIT · Documents et PDF

Miniature d’un PDF

Cette capacité produit une vignette d’aperçu d’un PDF : une petite image, tirée de la première page, qui représente le document dans une liste ou une galerie. De quoi montrer à quoi ressemble un fichier avant de l’ouvrir, comme une couverture qui donne un visage à chaque document.

● Stablepar requête + par document$0.040

Lancer — $0.040 + $0.001/document Voir l’API

Utilisez-le depuis WebAPIE-mailApp bientôtTelegram bientôt

Exécuter en ligne

Exécutez cette tâche sur nos serveurs, avec votre compte. Les outils gratuits tournent dans votre navigateur ; celui-ci est facturé sur votre solde KIT au prix affiché ci-dessus.

Un visage pour chaque document

Une liste de PDF identiques, réduits à leur nom de fichier, ne dit rien à l’œil. Une miniature change tout : d’un regard, on reconnaît une facture, un contrat, une notice ou une couverture. La vignette est une image légère, calquée sur la première page, qui sert d’aperçu dans une interface. C’est le petit détail qui rend une bibliothèque de documents navigable au lieu d’être une colonne de liens tous pareils.

Léger, calibré pour l’affichage

La miniature vise l’écran, pas l’impression : une image compacte, nette aux petites dimensions, dont vous fixez la taille selon la grille où elle s’insère. Le moteur de rendu respecte la mise en page réelle de la page de garde, couleurs et polices comprises, pour que l’aperçu soit fidèle. Le résultat se charge vite, ce qui compte quand une page en affiche des dizaines côte à côte.

Automatiser une galerie

L’intérêt se révèle à l’échelle : générer la vignette de chaque document déposé pour peupler une bibliothèque ou un espace client. La capacité s’exécute depuis cette page pour un fichier isolé, et via l’API (alias /pdf/thumbnail) pour un flux continu. Le tarif est de $0.040 par requête, en dollars US, sans abonnement : chaque nouveau document reçoit son aperçu à coût fixe et prévisible.

Cas d’usage

Espace client d’une agence

Studio Lumen SAS affiche les livrables de chaque client sous forme de vignettes. Le client repère sa maquette d’un coup d’œil, sans ouvrir dix PDF pour retrouver le bon, ce qui allège aussi les demandes au support.

Bibliothèque de modèles

Atelier Garnier SARL propose au téléchargement une série de fiches techniques. Chaque fiche est représentée par sa miniature, si bien que le visiteur choisit le bon document avant même de le télécharger.

Aperçu dans une messagerie interne

Menuiserie Rousseau & Fils joint des devis à ses échanges internes avec, en tête, une vignette. L’équipe distingue les pièces d’un fil de discussion sans les ouvrir une à une.

Questions fréquentes

La miniature vient-elle toujours de la première page ?

Par défaut, oui : la première page fait office de couverture et représente le document. C’est le repère visuel le plus attendu dans une liste ou une galerie.

Puis-je choisir la taille de la vignette ?

Oui, vous fixez les dimensions selon la grille d’affichage visée. Une vignette se veut compacte et rapide à charger ; inutile de viser une résolution d’impression pour un simple aperçu.

En quoi est-ce différent d’une conversion en images ?

La miniature produit un seul aperçu représentatif, pensé pour l’affichage en liste. La conversion en images, elle, rend chaque page en fichier exploitable. Les deux répondent à des besoins distincts.

La qualité est-elle suffisante pour un site web ?

Oui, le rendu est net aux dimensions d’une vignette et respecte la mise en page réelle de la page de garde. Il est calibré pour l’écran, où la légèreté prime sur la haute définition.

Combien coûte une miniature ?

$0.040 par requête, en dollars US, réglés à l’usage par PayPal, sans compte ni abonnement. Une facture est fournie sur demande pour une utilisation professionnelle.

Mes documents sont-ils conservés après coup ?

Non. Le PDF transite chiffré, sert à produire la vignette, puis est supprimé de nos serveurs. Seule l’image que vous récupérez subsiste, chez vous.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/pdf/thumbnail

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/pdf/thumbnail \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"pdf":"https://ejemplo.com/documento.pdf"}'

const res = await fetch("https://api.kit.forhosting.com/pdf/thumbnail", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pdf": "https://ejemplo.com/documento.pdf"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/thumbnail",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "pdf": "https://ejemplo.com/documento.pdf"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/thumbnail", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"pdf":"https://ejemplo.com/documento.pdf"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/thumbnail", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "pdf": "https://ejemplo.com/documento.pdf"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.thumbnail",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.040

par document$0.001

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Limites

`max_mb`	25
`max_pages`	200

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.
`422`	`task_failed`	La tâche a échoué : elle ne vous est pas facturée.

Consulter la documentation complète du KIT →