ForHosting KIT · Outils pour développeurs

Vérifier le poids d’un bagage et sa tranche d’excédent

Vérifiez avant votre départ si une valise, un bagage enregistré ou un bagage cabine respecte la franchise de poids annoncée.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez le poids mesuré et la limite applicable pour connaître l’excédent éventuel et sa tranche estimée. Vous pouvez aussi adapter la largeur des tranches à la politique consultée. Le résultat facilite la préparation, mais ne constitue pas un tarif confirmé : les frais varient selon le trajet, le billet, l’aéroport et le moment du paiement.

Comparez la mesure à la bonne franchise

Utilisez une mesure récente obtenue avec un pèse-bagage et la franchise figurant dans votre réservation ou les règles de bagages. Indiquez les deux valeurs en kilogrammes : mélanger livres et kilogrammes donnerait un résultat trompeur. Un bagage pesant exactement la limite est accepté par le calculateur. Au-delà, la différence est affichée en kilogrammes excédentaires. Cette comparaison vous aide à refaire une valise chez vous, à contrôler les bagages d’une famille ou à déplacer un objet vers un bagage cabine. Choisissez toujours la franchise correspondant au bagage et au billet concernés. Une valise en classe affaires, un bagage cabine en classe économique et un équipement sportif peuvent avoir des limites distinctes sur le même vol. Sur un partage de code, les règles du transporteur effectif peuvent s’appliquer. L’outil ne recherche ni ne devine une règle à partir du nom d’une compagnie : vous gardez la maîtrise de la limite saisie. Vérifiez-la dans les documents à jour de la réservation.

Interprétez la tranche d’excédent estimée

Si le bagage dépasse la limite, l’excédent est réparti en tranches de poids égales. Par défaut, chaque tranche couvre cinq kilogrammes : plus de zéro à cinq correspond au niveau 1, plus de cinq à dix au niveau 2, puis le principe continue. Vous pouvez modifier cette largeur lorsqu’une compagnie publie un autre barème. Le résultat fournit le numéro ainsi que les bornes basse et haute de la tranche afin que le calcul reste vérifiable. Cette indication n’est pas un prix. Certaines compagnies appliquent un forfait unique, d’autres plusieurs intervalles, et d’autres encore modulent leurs frais selon le trajet, la famille tarifaire, l’aéroport ou le paiement en ligne. Un bagage dépassant un maximum absolu peut également être refusé plutôt que soumis à une tranche supplémentaire. Servez-vous du niveau pour repérer une ligne dans le barème officiel, puis confirmez auprès de la compagnie le montant et les conditions d’acceptation.

Pesez soigneusement et prévoyez une marge

Un pèse-bagage domestique et la balance de l’aéroport peuvent différer légèrement, tandis que des ajouts de dernière minute augmentent le poids. Un résultat tout juste inférieur à la limite ne constitue donc pas une garantie. Pesez le bagage entièrement préparé sur une surface ferme et plane, recommencez la mesure et conservez si possible une petite marge. En cas d’excédent, ne déplacez des objets que si le bagage qui les reçoit respecte encore ses propres contraintes de dimensions et de poids. Ne supposez pas que deux voyageurs peuvent cumuler leur franchise inutilisée : les règles dépendent de la compagnie et de la réservation. Les nombres décimaux sont acceptés, ce qui évite d’arrondir la mesure à la baisse. Le calcul est déterministe, sans contact avec une compagnie, conservation de réservation ni consultation de tarifs en direct. Il convient ainsi aux contrôles reproductibles et aux automatisations, tout en vous laissant fournir la franchise et la largeur des tranches issues d’une source officielle récente.

Cas d’usage

Refaites la valise avant le départ

Découvrez combien de kilogrammes retirer et quelle tranche s’applique actuellement.

Contrôlez plusieurs franchises

Relancez le calcul avec les limites propres à différents voyageurs, cabines ou bagages.

Exploitez un barème publié

Réglez la largeur des tranches de la compagnie et utilisez le niveau obtenu pour trouver les frais.

Questions fréquentes

Combien coûte le contrôle du poids ?

Chaque requête API coûte $0.002 ; la version navigateur peut s’exécuter localement sur cette page.

Le résultat indique-t-il les frais exacts ?

Non. Il estime une tranche numérotée. Consultez le barème actuel de la compagnie pour connaître le montant.

Que se passe-t-il si le poids égale la limite ?

Le bagage est déclaré conforme, sans excédent ni tranche de frais.

Puis-je modifier la largeur d’une tranche ?

Oui. Définissez overweight_tier_kg selon le barème de la compagnie ; la valeur par défaut est de cinq kilogrammes.

Puis-je saisir un poids en livres ?

Les champs utilisent les kilogrammes. Convertissez le poids et la franchise avant de lancer le contrôle.

Pourquoi conserver une marge sous la limite ?

Les balances peuvent différer et les ajouts tardifs pèsent davantage ; une marge réduit les surprises à l’aéroport.

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/travel/luggage-weight-check

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/travel/luggage-weight-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bag_weight_kg":27.4,"weight_limit_kg":23}'

const res = await fetch("https://api.kit.forhosting.com/travel/luggage-weight-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "bag_weight_kg": 27.4,
    "weight_limit_kg": 23
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/luggage-weight-check",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "bag_weight_kg": 27.4,
    "weight_limit_kg": 23
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/luggage-weight-check", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"bag_weight_kg":27.4,"weight_limit_kg":23}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"bag_weight_kg":27.4,"weight_limit_kg":23}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/luggage-weight-check", 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

{
  "bag_weight_kg": 27.4,
  "weight_limit_kg": 23
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel.luggage_weight_check",
  "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.

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.

Consulter la documentation complète du KIT →