Éligibilité unitaire

L'éligibilité unitaire permet d'interroger la couverture FTTx pour une localisation précise. Trois modes de recherche sont disponibles : par adresse postale, par coordonnées GPS, ou par identifiant d'immeuble (ref IPE/interopFibre).

Prérequis : Une clé API Netwo valide. Consultez developer.netwo.io pour obtenir vos identifiants.

Par adresse

Recherchez l'éligibilité à partir d'une adresse postale complète.

POST/v1/eligibility/address

Retourne les offres FTTx disponibles pour une adresse postale.

Paramètres

Nom	Type	Requis	Description
`street`	string	requis	Numéro et nom de rue
`city`	string	requis	Nom de la commune
`postalCode`	string	requis	Code postal (5 chiffres)
`country`	string	optionnel	Code ISO pays (défaut: FR)

bash

curl -X POST https://api.netwo.io/v1/eligibility/address \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "street": "15 rue de la Paix",
    "city": "Paris",
    "postalCode": "75002",
    "country": "FR"
  }'

Par coordonnées GPS

Utile pour les applications mobiles ou la géolocalisation automatique.

POST/v1/eligibility/gps

Retourne les offres FTTx disponibles à proximité des coordonnées GPS.

Paramètres

Nom	Type	Requis	Description
`latitude`	number	requis	Latitude (format décimal)
`longitude`	number	requis	Longitude (format décimal)
`radius`	number	optionnel	Rayon de recherche en mètres (défaut: 50)

bash

curl -X POST https://api.netwo.io/v1/eligibility/gps \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": 48.8698,
    "longitude": 2.3311
  }'

Par identifiant d'immeuble

Interrogation directe avec la référence immeuble IPE/interopFibre. Le mode le plus précis.

POST/v1/eligibility/building

Retourne les offres FTTx pour un immeuble identifié par sa référence.

Paramètres

Nom	Type	Requis	Description
`buildingRef`	string	requis	Référence immeuble (format IMB/xxxxx/x/xxxx)

bash

curl -X POST https://api.netwo.io/v1/eligibility/building \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "buildingRef": "IMB/75102/C/00AB"
  }'

Format de réponse

Les trois endpoints retournent le même format de réponse, avec la liste des offres disponibles par opérateur.

json

{
  "requestId": "req_abc123",
  "address": {
    "street": "15 rue de la Paix",
    "city": "Paris",
    "postalCode": "75002"
  },
  "buildingRef": "IMB/75102/C/00AB",
  "offers": [
    {
      "operator": "Orange",
      "protocol": "OI_SPECIFIC",
      "technology": "FTTH",
      "maxDownload": 1000,
      "maxUpload": 600,
      "available": true,
      "activationDelay": "J+5"
    },
    {
      "operator": "Covage",
      "protocol": "INTEROP_FIBRE",
      "technology": "FTTH",
      "maxDownload": 1000,
      "maxUpload": 1000,
      "available": true,
      "activationDelay": "J+10"
    }
  ]
}

Guide suivant : Éligibilité de masse