2.1 (Novembre 2019)

Cette version mineure apporte un certain nombre de correctifs suite à la mise en production de la version 2.0. Elle pose également les bases de l'API de commande unifiée (fibre et cuivre) qui sera prochainement documentée.

Corrections

• L'événement order-completed est de nouveau transmis en fin de commande terminate,

• Le code rejet du fournisseur est transmis dans l'événement order-rejected,

• L'erreur est précisée en cas de VLAN déjà utilisé (produits Entreprise),

• Correction de la vérification du code RIO (portabilité),

• Correction du changement de profil (DSL),

• Corrections diverses sur l'éligibilité.

Changements

Authentification

• Le nom d'utilisateur lors de l'authentification est désormais insensible à la casse (test@kosc-telecom.fr et TEST@kosc-telecom.fr peuvent être utilisés indistinctement),

• L'authentification par cookie (jamais documentée) est supprimée.

Éligibilité

• L'éligibilité vérifie désormais que l'endpoint cuivre fourni est un NDI valide (commence par un 0, suivi d'un chiffre allant de 1 à 5, puis suivi de 8 chiffres)

• Le champ setup_fee (réponse d'éligibilité fibre) est désormais toujours égal à la chaine vide. Référez-vous à vos conditions contractuelles pour connaitre les couts d'installation.

Order

• En cas de données invalides contenues dans une liste ou un dictionnaire, l'erreur est maintenant retournée avec en clef l'index de la valeur fautive.

Exemple de requête :

PATCH /api/v2/orders/84497cb9-afd2-493f-ba38-ab99cb01a614/ HTTP/1.1
Host: extranet.kosc-telecom.fr
Content-Type: application/json

{
   "information":{
      "end_user_premises_phone_number":"0151040368",
      "end_user_premises_product_reference":"VIA1234567890123456",
      "ennis":[
         {
            "reference":"S191031_65114",
            "vlan":3
         }
      ]
   },
}

Exemple de réponse :

HTTP/1.1 400 Bad request
Content-Type: application/json

{
   "apirequest_uuid":"KOSC_7d9a8b85-572d-4392-9743-0f72c3e1f5ce",
   "details":[
      {
         "field":"information.ennis.0.reference",
         "errors":[
            "Object with reference=S191031_65114 does not exist."
         ]
      }
   ],
   "error":"Invalid input"
}

API Événements

• Le champ reject_reason a été ajouté dans l'événement order-rejected.