Trimiteți o înregistrare în directorul de numere de telefon

Trimiteți o înregistrare în directorul operatorului

Trimiteți numele și adresa care vor fi folosite pentru înregistrarea în director a unui număr de telefon eligibil pe care îl dețineți în MultiTEL. Aceasta este o actualizare cu plată la operator, nu o căutare a numelui apelantului, o înregistrare într-o agendă privată sau o actualizare generală a câmpului LIDB din inventarul portalului.

Trimiteți numai datele pe care clientul le-a autorizat pentru înregistrarea în director. Confirmați că operatorul acceptă acest serviciu pentru număr înainte de a utiliza această rută veche. Componenta de procesare analizată nu validează eligibilitatea furnizorului sau formatul internațional al numărului; solicitarea sa către operator presupune un număr nord-american și elimină prima cifră stocată.

Cerințe privind contul și numărul

Utilizați un cont API activat, prin HTTPS, de la o adresă IP sursă permisă. Numărul exact trebuie să corespundă unei înregistrări neanulate de număr achiziționat, care aparține acelui cont. Utilizați toate cifrele numărului în format internațional din inventar, de exemplu formatul cu indicativul de țară 1 pentru un număr nord-american acceptat. Nu utilizați identificatorul unui plan tarifar, un UUID al numărului sau un număr care aparține altui cont.

Solicitare POST cu date de formular

Setați NUMBER la numărul pe care îl dețineți. Înlocuiți exemplul fictiv cu informațiile autorizate pentru înregistrare. Această rută citește câmpurile formularului din POST; nu interpretează un corp de solicitare application/json.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode "lastname=EXAMPLE" \
  --data-urlencode "firstname=EXAMPLE" \
  --data-urlencode "streetnum=1" \
  --data-urlencode "streetname=Example" \
  --data-urlencode "streetpredir=N" \
  --data-urlencode "streetpostdir=W" \
  --data-urlencode "city=Example City" \
  --data-urlencode "state=NY" \
  --data-urlencode "postalcode=10001" \
  "https://api.multitel.net/v3/directory/$NUMBER"

Indicațiile de orientare și adresa din exemplu sunt valori ilustrative, nu o adresă poștală recomandată. Nu adăugați o indicație de orientare fictivă la datele reale ale clientului. Verificările câmpurilor obligatorii efectuate de API sunt superficiale: nu stabilesc dacă o adresă este validă sau acceptată de operator, iar vechiul site aplica cerințe diferite pentru formular.

Implementarea poate emite un avertisment privind o cheie lipsă dintr-un tablou atunci când o componentă opțională de orientare lipsește sau este goală. Dacă răspunsul are un format incorect sau operatorul respinge adresa, păstrați referința solicitării și cereți asistenței să confirme înregistrarea, în loc să trimiteți repetat variante de adresă modificate pe baza unor presupuneri.

Comportamentul taxării și al reîncercărilor

Componenta de procesare analizată verifică existența a cel puțin 10.00 unități de sold înainte de a contacta operatorul. După ce operatorul raportează succesul și actualizarea locală a numărului raportează succesul, aceasta scade 10.00 din soldul contului și înregistrează o tranzacție de configurare a înregistrării în director. Acestea sunt sumele aplicate de implementarea actuală, nu o nouă propunere de preț; înainte de trimitere, verificați moneda de facturare aplicabilă și serviciul acceptat în condițiile contului dumneavoastră.

Operațiunea nu are o cheie de idempotență, protecție împotriva comenzilor duplicate sau o tranzacție care să cuprindă trimiterea către operator, actualizarea locală și facturarea. O solicitare repetată care reușește poate duce la o nouă trimitere către operator și la o nouă taxare. Depășirea timpului de așteptare sau o eroare API nu dovedește că operatorul a respins solicitarea anterioară: furnizorul este posibil să o fi acceptat înainte ca o actualizare locală să eșueze.

Răspuns

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": ""
}

Răspunsul normal de succes conține un șir gol în câmpul response și nu returnează un identificator al înregistrării sau detalii despre finalizare. Acest lucru înseamnă că fluxurile operatorului și ale actualizării locale au raportat succesul; nu dovedește publicarea în fiecare director extern, propagarea imediată sau afișarea viitoare a identificării apelantului.

Erori ale sistemului vechi

Citiți atât starea HTTP, cât și câmpurile din JSON status.code/status.msg. Autentificarea și restricțiile privind adresa IP sursă pot, de asemenea, împiedica obținerea unui răspuns utilizabil. Nu utilizați GET sau parametri de interogare pentru a solicita o actualizare doar pentru că vechea componentă de procesare nu are o verificare explicită a metodei HTTP.

Verificați înainte de a reîncerca

1. Confirmați numărul pe care îl dețineți, eligibilitatea operatorului, datele autorizate pentru înregistrare și taxa înainte de a trimite solicitarea.
2. Trimiteți o singură dată și păstrați rezultatul din cont fără a expune adresa clientului în jurnale publice sau în sisteme de analiză.
3. Verificați înregistrarea salvată și istoricul tranzacțiilor prin fluxul de lucru acceptat al contului sau prin serviciul de asistență. Așteptați intervalul de procesare confirmat de operator; această API nu stabilește niciun termen garantat pentru propagare.
4. Când rezultatul este incert, cereți asistenței să verifice concordanța dintre comanda către operator și facturarea locală înainte de a reîncerca. O solicitare repetată nu este o verificare idempotentă a stării.