ForHosting KIT · Documents et PDF

Compter les pages d’un PDF

Obtenez le total des pages et le format de la première à partir des mesures relevées par votre lecteur PDF : trois pages, la première de 612 × 792 points. Chaque page est contrôlée d'abord : une liste abîmée ne passe jamais pour valable. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Obtenez un nombre de pages fiable et les dimensions de la première à partir de métadonnées déjà produites par un lecteur PDF. Fournissez un descripteur ordonné pour chaque page, avec une largeur et une hauteur mesurées en points PDF. La capacité valide tous les descripteurs, compte les entrées et renvoie les dimensions de la première page avec une unité explicite. Elle convient lorsqu’un processus a déjà analysé un PDF et nécessite un résumé court et prévisible avant d’orienter, d’afficher, de contrôler ou d’enregistrer le document.

Préparez les descripteurs de page

Fournissez un tableau pages dans le même ordre que les pages du PDF. Chaque entrée doit être un objet comportant les champs width et height, tous deux exprimés en points PDF. Un point correspond à un soixante-douzième de pouce et constitue l’unité de coordonnées habituelle des bibliothèques PDF.

Les mesures décimales sont acceptées, car les zones de rognage et de support ne sont pas toujours définies par des nombres entiers. Utilisez la taille effective indiquée par votre analyseur et appliquez un traitement cohérent de la rotation dans tout le tableau. La capacité n’ouvre pas les octets du PDF, ne déduit aucune dimension et ne choisit pas entre plusieurs zones de page : elle résume les descripteurs que vous fournissez.

Incluez toutes les pages, même si les suivantes changent d’orientation ou de taille, puisque le nombre de descripteurs devient le total déclaré. La première entrée représente la première page. Un tableau vide est refusé, car il ne permet d’indiquer ni un total pertinent ni une taille initiale.

Interprétez le total et la taille initiale

La précision numérique d’origine est conservée : la capacité n’arrondit pas, ne redimensionne pas, ne normalise pas l’orientation et ne convertit pas les valeurs en pouces ou en millimètres. Seules les dimensions de la première page sont renvoyées, même si le document mélange ensuite des formats Lettre, A4, paysage, portrait ou personnalisés. Tous les descripteurs sont néanmoins validés avant la création du résultat.

Ainsi, un total fondé sur une liste partiellement incorrecte ne peut pas sembler fiable tout en masquant une sortie incomplète de l’analyseur. L’opération ne conserve aucun état et produit toujours le même résultat pour la même entrée.

Validez les métadonnées avant d’orienter le PDF

Servez-vous du résumé comme point de contrôle compact entre l’analyse du PDF et l’action suivante. Un service de réception peut refuser les fichiers dépassant une limite de pages, choisir une mise en page d’aperçu selon l’orientation initiale ou joindre le total et les dimensions à une fiche d’indexation. Un processus d’impression peut comparer la taille de la première page à un modèle attendu avant de transmettre le fichier original.

La validation est volontairement stricte : pages doit être un tableau non vide, chaque entrée doit être un objet, et chaque width et height doit être un nombre fini positif. Les zéros, valeurs négatives, champs absents, chaînes, infinis et valeurs NaN provoquent une erreur au lieu d’être corrigés silencieusement. Une requête est également limitée à cent mille descripteurs.

Aucun accès réseau, téléversement, décodage du PDF ou stockage persistant n’a lieu.

Cas d’usage

Appliquez des limites de pages

Comptez les descripteurs validés avant d’accepter un PDF dans un processus soumis à un minimum ou un maximum de pages.

Choisissez l’orientation de l’aperçu

Comparez la largeur et la hauteur initiales afin de sélectionner un cadre portrait, paysage ou carré.

Enregistrez des métadonnées PDF compactes

Ajoutez le total et les dimensions initiales à un index de recherche, une fiche de ressource ou un journal de traitement.

Questions fréquentes

Cette capacité lit-elle directement le fichier PDF ?

Non. Elle reçoit des descripteurs ordonnés déjà produits par un lecteur ou un analyseur PDF.

Quelle unité faut-il employer pour width et height ?

Fournissez les deux mesures en points PDF. La réponse désigne l’unité par pt.

La taille de chaque page est-elle indiquée ?

Non. Tous les descripteurs sont validés et comptés, mais seules les dimensions de la première entrée sont renvoyées.

À quoi sert de connaître le total et le format de la première page ?

À contrôler le document avant l'étape suivante : refuser les fichiers au-delà d'une limite de pages, choisir un aperçu portrait ou paysage d'après la première page, ou vérifier qu'elle correspond au papier attendu par un modèle d'impression.

Pourquoi ma liste de pages est-elle refusée ?

Chaque page doit avoir une largeur et une hauteur supérieures à zéro. Une liste vide, une mesure manquante, un zéro ou une valeur négative arrêtent le décompte, pour qu'une liste incomplète ne donne jamais un total juste en apparence seulement.

Outils associés

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/page-count

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/page-count \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pages":[{"width":612,"height":792},{"width":612,"height":792},{"width":792,"height":612}]}'

const res = await fetch("https://api.kit.forhosting.com/pdf/page-count", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pages": [
      {
        "width": 612,
        "height": 792
      },
      {
        "width": 612,
        "height": 792
      },
      {
        "width": 792,
        "height": 612
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/page-count",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pages": [
        {
            "width": 612,
            "height": 792
        },
        {
            "width": 612,
            "height": 792
        },
        {
            "width": 792,
            "height": 612
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/page-count", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"pages":[{"width":612,"height":792},{"width":612,"height":792},{"width":792,"height":612}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pages":[{"width":612,"height":792},{"width":612,"height":792},{"width":792,"height":612}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/page-count", 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

{
  "pages": [
    {
      "width": 612,
      "height": 792
    },
    {
      "width": 612,
      "height": 792
    },
    {
      "width": 792,
      "height": 612
    }
  ]
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.page_count",
  "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.002

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

Limites

max_pages 100000

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.

Notes techniques

Interprétez le total et la taille initiale

La réponse comprend deux champs principaux. page_count correspond au nombre d’entrées validées dans le tableau pages. first_page contient width et height copiés depuis le premier descripteur, ainsi que unit défini sur pt, afin que le système destinataire n’ait pas à deviner l’unité. L’ordre du tableau détermine donc à lui seul les dimensions placées dans first_page.

Validez les métadonnées avant d’orienter le PDF

Pour un contrôle interactif, exécutez l’opération dans le navigateur ; pour un processus automatisé, l’API coûte $0.002 par requête et renvoie la même structure JSON déterministe.

Questions techniques

Les pages peuvent-elles avoir des tailles différentes ?

Oui. Les descripteurs suivants peuvent varier ; la longueur du tableau fixe le total et le premier détermine first_page.

Que se passe-t-il si le tableau pages est vide ?

La requête échoue avec une erreur invalid_input, car aucune première page ne peut être décrite.

Consulter la documentation complète du KIT →

Lancer gratuitement

Préparez les descripteurs de page

Interprétez le total et la taille initiale

Validez les métadonnées avant d’orienter le PDF

Cas d’usage

Appliquez des limites de pages

Choisissez l’orientation de l’aperçu

Enregistrez des métadonnées PDF compactes

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Limites

Erreurs

Notes techniques

Interprétez le total et la taille initiale

Validez les métadonnées avant d’orienter le PDF

Questions techniques

merci