Éligibilité de masse

L'éligibilité de masse permet de soumettre un lot d'adresses pour obtenir les résultats de couverture FTTx en batch. Idéal pour les migrations de parc, les analyses de couverture ou les imports massifs.

Limites : Maximum 10 000 adresses par batch. Pour des volumes supérieurs, découpez en plusieurs requêtes.

Soumettre le batch

Envoyez la liste d'adresses avec un webhook optionnel pour être notifié à la fin du traitement.

POST/v1/eligibility/batch

Crée un nouveau batch d'éligibilité. Retourne un identifiant de batch pour le suivi.

Paramètres

Nom	Type	Requis	Description
`addresses`	array	requis	Liste d'adresses (max 10 000)
`addresses[].externalId`	string	optionnel	Votre identifiant interne pour chaque adresse
`addresses[].street`	string	requis	Numero et nom de rue
`addresses[].city`	string	requis	Nom de la commune
`addresses[].postalCode`	string	requis	Code postal
`webhookUrl`	string	optionnel	URL de callback notifiée à la fin du traitement

bash

curl -X POST https://api.netwo.io/v1/eligibility/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "addresses": [
      {
        "externalId": "site-001",
        "street": "15 rue de la Paix",
        "city": "Paris",
        "postalCode": "75002"
      },
      {
        "externalId": "site-002",
        "street": "1 place Bellecour",
        "city": "Lyon",
        "postalCode": "69002"
      }
    ],
    "webhookUrl": "https://your-system.com/webhooks/eligibility"
  }'

Suivre la progression

Deux options : polling du statut ou notification par webhook.

Option A : Polling

GET/v1/eligibility/batch/{batchId}

Retourne le statut et la progression du batch.

json

{
  "batchId": "bat_xyz789",
  "status": "PROCESSING",
  "totalAddresses": 150,
  "processedAddresses": 42,
  "progress": 28,
  "createdAt": "2024-01-15T10:30:00Z",
  "estimatedCompletion": "2024-01-15T10:35:00Z"
}

bash

# Verifier le statut du batch
curl https://api.netwo.io/v1/eligibility/batch/bat_xyz789 \
  -H "Authorization: Bearer YOUR_API_KEY"

# Recuperer les resultats (une fois le batch termine)
curl https://api.netwo.io/v1/eligibility/batch/bat_xyz789/results \
  -H "Authorization: Bearer YOUR_API_KEY"

Option B : Webhook

Si vous avez fourni un webhookUrl, un POST est envoyé à cette URL une fois le batch terminé.

json

{
  "event": "batch.completed",
  "batchId": "bat_xyz789",
  "status": "COMPLETED",
  "totalAddresses": 150,
  "processedAddresses": 150,
  "resultsUrl": "https://api.netwo.io/v1/eligibility/batch/bat_xyz789/results"
}

Récupérer les résultats

Une fois le batch terminé, récupérez les résultats complets.

GET/v1/eligibility/batch/{batchId}/results

Retourne les résultats d'éligibilité pour chaque adresse du batch. Supporte la pagination.

Paramètres

Nom	Type	Requis	Description
`page`	number	optionnel	Numéro de page (défaut: 1)
`perPage`	number	optionnel	Résultats par page (défaut: 100, max: 1000)

Guide précédent : Éligibilité unitaire