ForHosting KIT · Outils pour développeurs

Lecteur de code-barres

Ce lecteur décode un code-barres présent sur une photo ou une image : vous fournissez le visuel, il renvoie la référence encodée, quel que soit le format — EAN-13, UPC, Code 128 ou QR. Pratique pour saisir un article sans douchette, contrôler une étiquette ou récupérer un numéro de lot depuis un cliché.

Temporairement retiréepar requête + par image$0.002

Cette tâche n'est pas disponible pour le moment et ne peut donc pas être achetée. Rien n'est facturé.

Voir l’API

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

Décoder sans douchette

Une douchette laser coûte cher et n’est pas toujours à portée. Un téléphone, lui, prend une photo. Ce lecteur part de cette photo pour identifier le motif et renvoyer la donnée qu’il contient : le numéro d’un EAN, la référence d’un Code 128, l’adresse d’un QR code. Il reconnaît les principaux formats et distingue automatiquement lequel il a sous les yeux, sans que vous ayez à le préciser vous-même.

Ce qui aide à une bonne lecture

La qualité de l’image fait la lecture. Un code bien éclairé, cadré droit et net se décode sans difficulté. Les ennemis sont le flou de bougé, les reflets sur un emballage plastifié et une résolution trop faible où les barres se confondent. Un léger recadrage sur le code, sans l’écraser, améliore nettement le résultat. Les codes abîmés ou partiellement déchirés peuvent rester illisibles, comme ils le seraient pour une caisse.

Un traitement hébergé, facturé à l’usage

À la différence de la génération de code-barres, la lecture d’une image s’appuie sur un traitement côté serveur ; elle est donc facturée à l’usage : $0.002 la requête plus $0.005 par image, en dollars US, sans abonnement ni compte. Votre photo transite par un canal chiffré le temps du décodage, puis est effacée. L’outil s’utilise depuis cette page comme par API, pour une image isolée ou toute une série.

Cas d’usage

Réception de marchandise

Un magasin contrôle les EAN d’une livraison en photographiant les cartons, sans sortir la douchette.

Inventaire au téléphone

Sophie Nguyen relève les références d’un rayon à partir de photos, pour recaler son stock.

Numéro de lot illisible à l’œil

Un artisan récupère le numéro de lot d’un Code 128 trop fin pour être lu à la main.

Vérification d’étiquette

Menuiserie Rousseau et Fils confirme qu’une étiquette imprimée renvoie bien la bonne référence avant expédition.

Questions fréquentes

Quels formats le lecteur reconnaît-il ?

Les principaux : EAN-13, UPC, Code 128 et QR code. Il détecte seul le format présent sur l’image, sans que vous ayez à l’indiquer au préalable.

Pourquoi ce service est-il payant alors que la génération est gratuite ?

Parce que décoder une image demande un traitement côté serveur, là où générer un code se fait dans le navigateur. Le tarif est de $0.002 la requête plus $0.005 par image, en dollars US.

Ma photo est-elle conservée ?

Non. Elle transite par un canal chiffré le temps du décodage, puis est effacée sans copie gardée. Seule la référence décodée vous est renvoyée.

Que faire si le code n’est pas reconnu ?

Reprenez la photo : plus de lumière, un cadrage droit, moins de reflets. Un code net et bien éclairé se lit presque toujours ; un motif déchiré peut rester illisible.

Puis-je décoder plusieurs images d’un coup ?

Oui. Au-delà d’une image isolée sur cette page, l’API traite des séries, facturées au même tarif par image, en dollars US.

L’assistance est-elle disponible en français ?

Non. Une vraie personne vous répond, mais en espagnol ou en anglais. Nous préférons vous le dire clairement plutôt que de promettre un support français qui n’existe pas.

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/dev/barcode-decode

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/dev/barcode-decode \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"image":"https://ejemplo.com/imagen.jpg"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/barcode-decode",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "image": "https://ejemplo.com/imagen.jpg"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/barcode-decode", 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

{
  "image": "https://ejemplo.com/imagen.jpg"
}

Exemple de réponse

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

par image$0.005

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 →