documentation:adsl-fdn

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
Prochaine révision Les deux révisions suivantes
documentation:adsl-fdn [2019/08/10 12:56]
sthibaul [Éligibilité des lignes]
documentation:adsl-fdn [2019/08/20 21:06]
sthibaul
Ligne 14: Ligne 14:
     * la config apache /etc/apache2/conf.d/adsl.conf: (require group yyy pour *-yyy.cgi), et faire reload pour que ce soit pris en compte     * la config apache /etc/apache2/conf.d/adsl.conf: (require group yyy pour *-yyy.cgi), et faire reload pour que ce soit pris en compte
     * le type d'adhérent pour le tarif: marque blanche ou collecte     * le type d'adhérent pour le tarif: marque blanche ou collecte
-    * vérifier la grille tarifaire associée au compte+    * vérifier la grille tarifaire associée au compte (<<< où est-ce ? y a-t-il vraiment quelque chose à faire ?)
  
 ==== Authentification des lignes ADSL ==== ==== Authentification des lignes ADSL ====
Ligne 25: Ligne 25:
 ==== Retrouver une ligne ==== ==== Retrouver une ligne ====
  
-Si un adhérent ne connait que l'adresse, on peut utiliser ''https://vador.fdn.fr/souscription/souscription.cgi?etape=ndinconnu'' pour retrouver les numéros correspondant.+Si un adhérent ne connait que l'adresse, on peut utiliser ''https://vador.fdn.fr/souscription/souscription.cgi?etape=ndinconnu'' pour retrouver les numéros correspondant. On peut aussi utiliser les APIs documentées ci-dessous pour faire son propre formulaire de recherche de ND 
 + 
 +=== Recherche d'un ND === 
 + 
 +Les gens qui déménagent ne connaissent souvent pas le numéro de téléphone de la ligne du nouveau logement, seulement l'adresse. L'interface en JSON à ''https://vador.fdn.fr/souscription/cherche-nd.cgi'' permet de récupérer un numéro à partir d'une adresse, en passant en paramètres: 
 + 
 +  * ''?etape=cherche\_nd&city=paris&zip=75002&street=mandar&street\_nb=10'' 
 + 
 +Le paramètre ''street\_nb'' est optionnel. 
 + 
 +Cela ne retourne par contre pas les numéros en liste rouge, seulement leur nombre dans nb_rouges 
 + 
 +=== Recherche de noms de villes / de rues === 
 + 
 +Pour limiter les problèmes de saisie, il est utile de mettre un peu de javascript pour montrer une liste de villes et de rues pendant la saisie. Pour ça on peut utiliser l'interface ''https://vador.fdn.fr/souscription/cherche-ville.cgi'', en passant en paramètres: 
 + 
 +  * ''?etape=cherche\_ville&query=test'' 
 + 
 +On peut ajouter le paramètre ''&zip=33400'' pour limiter à un code postal. 
 + 
 +De même, l'interface ''https://vador.fdn.fr/souscription/cherche-rue.cgi'' retourne des rues, en passant en paramètres: 
 + 
 +  * ''?etape=cherche\_rue&query=toto&city=bla&zip=12345'' 
 + 
 +Note: il faut mettre à la fois la ville et le code postal pour que le filtrage puisse fonctionner, sinon il retourne pour toute la France. 
 + 
 +Seuls 100 résultats au plus sont retournés pour éviter de surcharger le tout. 
 + 
 +Pour un exemple d'utilisation de ces interfaces, cf par exemple le site de FDN: https://vador.fdn.fr/souscription/souscription.cgi?numadh=&etape=ndinconnu et surtout son script de branchement de typeahead: https://vador.fdn.fr/souscription/typeahead-link.js 
 + 
 ====Éligibilité des lignes==== ====Éligibilité des lignes====
  
Ligne 65: Ligne 95:
 Avec la possibilité de dégroupage total, il y a une valse des numéros de désignation d'installation (NDI). Avant, c'était simple, on prenait juste le numéro actif correspondant à l'abonnement France Télécom. Maintenant, c'est plus compliqué, car un numéro peut correspondre à la fois à un abonnement que quelqu'un a emmené avec lui lors d'un déménagement (NDI actif) **et** à une ligne téléphonique qui n'a pas d'abonnement (NDI inactif). Le hic, c'est que c'est l'adhérent seulement qui peut savoir distinguer lequel est bon. Pour faciliter la vie, il y a une interface en JSON pour récupérer l'adresse: ''https://vador.fdn.fr/souscription/nd-info.cgi'' avec en paramètre Avec la possibilité de dégroupage total, il y a une valse des numéros de désignation d'installation (NDI). Avant, c'était simple, on prenait juste le numéro actif correspondant à l'abonnement France Télécom. Maintenant, c'est plus compliqué, car un numéro peut correspondre à la fois à un abonnement que quelqu'un a emmené avec lui lors d'un déménagement (NDI actif) **et** à une ligne téléphonique qui n'a pas d'abonnement (NDI inactif). Le hic, c'est que c'est l'adhérent seulement qui peut savoir distinguer lequel est bon. Pour faciliter la vie, il y a une interface en JSON pour récupérer l'adresse: ''https://vador.fdn.fr/souscription/nd-info.cgi'' avec en paramètre
  
-  * ''?etape=nd_info&tel=0123456789''+  * ''?etape=nd\_info&tel=0123456789''
  
 cela vous retourne l'adresse du NDI, selon qu'il est considéré comme actif, inactif, ou précâblé. Si plusieurs adresses sont retournées, il vous faut faire choisir la bonne par l'abonné. Dans tous les cas, il faut ajouter à la demande d'éligibilité le paramètre ''&typend=inactif'' par exemple pour préciser que c'est le numéro inactif qu'il faut tester, sinon c'est possiblement la mauvaise ligne qui sera testée ! Il faudra également choisir le bon type au moment de la commande, sinon, la commande sera livrée au mauvais endroit ! En principe le suivi ADSL de FDN vérifie l'adresse, mais l'erreur est humaine. cela vous retourne l'adresse du NDI, selon qu'il est considéré comme actif, inactif, ou précâblé. Si plusieurs adresses sont retournées, il vous faut faire choisir la bonne par l'abonné. Dans tous les cas, il faut ajouter à la demande d'éligibilité le paramètre ''&typend=inactif'' par exemple pour préciser que c'est le numéro inactif qu'il faut tester, sinon c'est possiblement la mauvaise ligne qui sera testée ! Il faudra également choisir le bon type au moment de la commande, sinon, la commande sera livrée au mauvais endroit ! En principe le suivi ADSL de FDN vérifie l'adresse, mais l'erreur est humaine.
Ligne 71: Ligne 101:
 Pour les numéros de pré-câblés, indiquez le numéro à 20 caractères 42CXN0000... comme numéro de téléphone, et utilisez ''&typend=precab'' . Pour les numéros de pré-câblés, indiquez le numéro à 20 caractères 42CXN0000... comme numéro de téléphone, et utilisez ''&typend=precab'' .
  
-=== Recherche d'un ND === 
- 
-Inversement, les gens qui déménagent ne connaissent souvent pas le numéro de téléphone de la ligne du nouveau logement, seulement l'adresse. L'interface en JSON à ''https://vador.fdn.fr/souscription/cherche-nd.cgi'' permet de récupérer un numéro à partir d'une adresse, en passant en paramètres: 
- 
-  * ''?etape=cherche_nd&city=paris&zip=75002&street=mandar&street_nb=10'' 
- 
-Cela ne retourne par contre pas les numéros en liste rouge, seulement leur nombre dans nb_rouges 
- 
-=== Recherche de noms de villes / de rues === 
- 
-Pour limiter les problèmes de saisie, il est utile de mettre un peu de javascript pour montrer une liste de villes et de rues pendant la saisie. Pour ça on peut utiliser l'interface ''https://vador.fdn.fr/souscription/cherche-ville.cgi'', en passant en paramètres: 
- 
-  * ''?etape=cherche_ville&query=test'' 
- 
-On peut ajouter le paramètre ''&dept=33'' pour limiter à la gironde par exemple. 
- 
-De même, l'interface ''https://vador.fdn.fr/souscription/cherche-rue.cgi'' retourne des rues, en passant en paramètres: 
- 
-  * ''?etape=cherche_rue&query=toto&city=bla'' 
- 
-(note: pour l'instant le filtrage par ville ne fonctionne pas :/ ) 
- 
-Seuls 100 résultats au plus sont retournés pour éviter de surcharger le tout. 
 ====Commande de ligne==== ====Commande de ligne====
  
  • documentation/adsl-fdn.txt
  • Dernière modification: 2022/04/25 23:29
  • de sthibaul