ForHosting KIT · Vérification et validation

Vérification d’adresse

La vérification d’adresse contrôle qu’une adresse postale est cohérente et complète, corrige les fautes courantes et la remet dans un format normalisé : numéro, voie, code postal à cinq chiffres et commune. Elle réduit les retours de courrier et les échecs de livraison dus à une adresse mal saisie, incomplète ou mal ordonnée.

● Betapar requête + par élément$0.003

Lancer — $0.003 + $0.0135/élément 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.

Ce qu’une adresse bien formée contient

Une adresse française lisible par un service de livraison suit un ordre précis : numéro et voie sur une ligne (12 rue de la République), complément éventuel (bâtiment, étage), puis code postal à cinq chiffres et commune (69002 Lyon). La vérification remet chaque élément à sa place, complète ce qui manque quand c’est déductible, et signale ce qui reste ambigu pour que vous tranchiez.

Corriger sans dénaturer

L’analyse comprend le sens d’une adresse, pas seulement sa forme : elle rétablit un « bd » en « boulevard », corrige une commune mal orthographiée, replace un code postal égaré au milieu d’une ligne. Elle s’attache à conserver l’intention de l’adresse d’origine plutôt qu’à la réécrire arbitrairement — l’objectif est une version propre et postable, pas une adresse inventée.

Une adresse propre fait gagner de l’argent

Chaque pli retourné coûte deux fois : l’envoi initial et le réacheminement, sans compter le client déçu. Pour une boutique qui expédie, un fichier d’adresses homogène réduit les non-distribués et fluidifie la préparation des commandes. Normaliser en amont, au moment de la saisie ou avant un envoi groupé, revient bien moins cher que de gérer les retours un à un.

Traitement serveur, tarif et canaux

L’adresse est traitée sur nos serveurs, via une connexion chiffrée, le temps de l’analyse, puis n’est pas conservée pour d’autres usages — une adresse étant une donnée personnelle au sens du RGPD. La vérification se lance depuis cette page ou via l’API, facturée $0.003 par requête plus $0.0135 par élément analysé, en dollars US. Cette capacité est en bêta.

Cas d’usage

Corriger l’adresse d’une commande

Une cliente saisit « 12 r republique 69002 lyon » à la va-vite. La vérification restitue « 12 rue de la République, 69002 Lyon », prête pour l’étiquette d’expédition, sans aller-retour avec le service client.

Formulaire de livraison e-commerce

Studio Lumen SAS branche la vérification sur son tunnel de commande : à la saisie, une adresse incomplète est signalée et proposée corrigée, ce qui fait chuter les colis non distribués.

Base d’adhérents hétérogène

Une association a accumulé des adresses saisies de dix façons différentes. Avant l’envoi de ses convocations, chaque adresse est normalisée pour homogénéiser le fichier et limiter les retours.

Questions fréquentes

Quelles corrections l’outil apporte-t-il ?

Il rétablit les abréviations de voie, corrige les fautes de commune, replace un code postal mal positionné, réordonne les lignes et complète ce qui est déductible. Il vous rend une version normalisée, prête à imprimer sur une étiquette.

Reconnaît-il les adresses étrangères ?

Il est pensé d’abord pour les adresses françaises et leur structure, mais gère les formats internationaux courants. Plus une adresse s’éloigne des conventions habituelles, plus le résultat mérite une relecture de votre part.

Garantit-il que l’adresse existe vraiment ?

Non. Il produit une adresse cohérente et bien formée ; il ne certifie pas qu’un logement s’y trouve ni que la voie est répertoriée au cadastre. C’est un outil de mise en forme et de cohérence, et il est encore en bêta.

Combien coûte une vérification ?

$0.003 par requête, plus $0.0135 par élément analysé, en dollars US et sans abonnement. Sans compte: l’achat de l’accès se règle directement, en une fois.

Mes adresses sont-elles conservées ?

Non. L’adresse est traitée sur nos serveurs, via une connexion chiffrée, le temps de l’analyse, puis n’est pas conservée pour d’autres usages. Une adresse étant une donnée personnelle, elle ne sert qu’à la vérification demandée.

Puis-je obtenir une facture ?

Oui. L’achat de l’accès se fait par PayPal, directement, et vous pouvez demander une facture pour votre comptabilité en écrivant à [email protected]. Une vraie personne vous répond, en espagnol ou en anglais.

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/verify/address

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/verify/address \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/verify/address", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/verify/address",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/verify/address", 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

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "verify.address",
  "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.003

par élément$0.0135

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.
`422`	`task_failed`	La tâche a échoué : elle ne vous est pas facturée.

Consulter la documentation complète du KIT →