EN
Copied
Modules

Informations sur le numéro

Enrichit une liste de numéros de téléphone avec opérateur, type de ligne, portabilité et métadonnées opérateur — registre officiel ARCEP plus vérification live de portabilité.

Informations sur le numéro

Le module phone_info prend une liste de numéros de téléphone et renvoie une ligne enrichie par numéro. Pour chaque numéro français, il identifie l'opérateur attributaire de la tranche selon l'ARCEP (Orange, SFR, Bouygues, Free, MVNO), avec son nom commercial, son SIRET, son siège, son RCS et sa date de déclaration ARCEP. Quand c'est disponible, il renvoie aussi l'opérateur actuel après portabilité et un indicateur de joignabilité.

Module d'enrichissement pipelinable : à chaîner après un job de discovery, un import, ou toute liste qui transporte une colonne téléphone.

Entrées

Une liste d'items, chacun portant au moins un champ téléphone. Les autres colonnes sont préservées telles quelles.

Champ Requis Notes
phone (ou telephone, phone_number, numero, number) oui Numéro français ou international. Accepte espaces, +, 00 et 10 chiffres bruts.
nom (ou name) non Repris en sortie pour l'affichage.
toute autre colonne non Préservée à l'identique.

Taille batch : 1 à 10 000 items par job.

Options du job :

Option Défaut Notes
live_mode "cache_only" "cache_only" lit seulement le cache de portabilité existant. "with_live" tente une vérification live pour les mobiles français pas encore en cache.
source_job_id aucune ID du job amont pour la lineage dans les pipelines.

Sorties

Chaque ligne en entrée est renvoyée enrichie des colonnes ci-dessous.

Colonne Type Description
phone_e164 string Format international canonique.
phone_national string Format national lisible.
phone_country string ISO 3166-1 alpha-2.
phone_line_type string mobile, fixed_line, fixed_or_mobile, other.
phone_carrier_original string Opérateur attributaire de la tranche ARCEP.
phone_operator_siret string SIRET de l'opérateur d'origine.
phone_operator_rcs string Ville RCS.
phone_operator_address string Adresse du siège.
phone_operator_registered_since string Date de déclaration ARCEP de l'opérateur.
phone_tranche_attribution_date string Date d'attribution de la tranche.
phone_territory string Métropole, La Réunion, Mayotte, etc.
phone_carrier_current string Opérateur actuel après portabilité (quand disponible).
phone_is_ported string yes, no, unknown.
phone_is_reachable string yes, no, unknown.
phone_is_valid string yes, no.
phone_status string ok, not_french, invalid, no_match.

Pipeline

needs:    telephone
produces: phone_e164, phone_carrier_original, phone_carrier_current, phone_is_ported, ...

Chaînes typiques :

scrap → phone_info → filter (par opérateur) → sms_campaign
import → phone_info → enrichissement emails …

Endpoints

POST /api/jobs/phone-info

Crée un nouveau job phone-info à partir d'une liste d'items.

Corps

Champ Type Requis Description
items array oui 1 à 10 000 éléments. Chacun doit porter un champ téléphone.
live_mode string non "cache_only" (défaut) ou "with_live".
source_job_id string (uuid) non ID du job amont en pipeline.

Réponse

Enveloppe JobPublic standard.

Exemple

POST /api/jobs/phone-info
Content-Type: application/json

{
  "items": [
    { "nom": "Acme",  "phone": "+33612345678" },
    { "nom": "Beta",  "phone": "0142868828"  }
  ],
  "live_mode": "cache_only"
}

Sources de données