Telefonszám telefonkönyvi bejegyzésének beküldése

Telefonkönyvi bejegyzés beküldése a szolgáltatónak

Küldje be a MultiTEL rendszerében az Ön tulajdonában lévő, erre jogosult telefonszám telefonkönyvi bejegyzéséhez használandó nevet és címet. Ez díjköteles szolgáltatói frissítés, nem hívónév-lekérdezés, nem privát címjegyzékbejegyzés, és nem a portál nyilvántartásában szereplő LIDB mező általános frissítése.

Csak olyan adatokat küldjön be, amelyek telefonkönyvi közzétételét az ügyfél engedélyezte. A régi végpont használata előtt ellenőrizze, hogy a szolgáltató támogatja-e az adott számot. Az áttekintett kezelő nem ellenőrzi a szolgáltatói jogosultságot vagy a nemzetközi számformátumot; a szolgáltatónak küldött kérelme észak-amerikai számot feltételez, és eltávolítja az első tárolt számjegyet.

A fiókra és a telefonszámra vonatkozó követelmények

Engedélyezett forrás-IP-címről, HTTPS kapcsolaton keresztül használjon egy engedélyezett API-fiókot. A pontos számnak az adott fiókhoz tartozó, megvásárolt számok egyik nem érvénytelenített rekordjában kell szerepelnie. A nyilvántartásában szereplő teljes nemzetközi számsort használja, például támogatott észak-amerikai szám esetén az 1 országkódot tartalmazó formátumot. Ne használjon díjcsomag-azonosítót, a szám UUID-azonosítóját vagy másik fiókhoz tartozó számot.

Űrlapos POST kérés

Állítsa a NUMBER értékét az Ön tulajdonában lévő számra. A kitalált példa helyére a jóváhagyott telefonkönyvi adatokat írja. Ez a végpont a POST kérés űrlapmezőit olvassa be; az application/json formátumú kéréstörzset nem dolgozza fel.

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"

A példában szereplő égtájjelölések és cím helykitöltők, nem ajánlott postai cím. Ne adjon kitalált égtájjelölést valódi ügyféladatokhoz. Az API kötelező mezőkre vonatkozó ellenőrzései felületesek: nem igazolják, hogy a cím érvényes, vagy hogy a szolgáltató elfogadja, a régi webhely pedig eltérő űrlapkövetelményeket alkalmazott.

A megvalósítás hiányzó tömbkulcsra figyelmeztető üzenetet adhat, ha egy nem kötelező égtájjelölés hiányzik vagy üres. Ha a válasz hibás formátumú, vagy a szolgáltató elutasítja a címet, őrizze meg a kérelem hivatkozását, és kérje az ügyfélszolgálattól a bejegyzés megerősítését ahelyett, hogy találgatás alapján módosított címeket küldene be ismételten.

Díjterhelés és újrapróbálkozás

Az áttekintett kezelő ellenőrzi, hogy rendelkezésre áll-e legalább 10.00 egyenlegegység a szolgáltató megkeresése előtt. Miután a szolgáltató és a helyi számfrissítés is sikert jelzett, levon 10.00 összeget a fiók egyenlegéből, és rögzít egy telefonkönyvi beállítási tranzakciót. Ezek a rendszerben jelenleg alkalmazott összegek, nem új árazási javaslatok; beküldés előtt a fiókfeltételek alapján ellenőrizze az alkalmazandó számlázási pénznemet és a támogatott szolgáltatást.

A művelethez nem tartozik idempotenciakulcs, az ismételt megrendelést megakadályozó védelem, illetve a szolgáltatói beküldést, a helyi frissítést és a számlázást összefogó tranzakció. Egy sikeres ismételt kérés újabb szolgáltatói beküldést és újabb díjterhelést eredményezhet. Az időtúllépés vagy az API hibája nem bizonyítja, hogy a szolgáltató elutasította a korábbi kérelmet: előfordulhat, hogy a szolgáltató már elfogadta azt, mielőtt a helyi frissítés meghiúsult.

Válasz

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

A szokásos sikeres válaszban üres karakterlánc a response mező értéke, és nem érkezik vissza bejegyzésazonosító vagy a teljesítésre vonatkozó részlet. Ez azt jelenti, hogy a szolgáltatói és a helyi frissítési útvonal sikert jelzett; nem bizonyítja a közzétételt minden külső telefonkönyvben, az azonnali elterjedést vagy a későbbi hívóazonosító-kijelzést.

A régi rendszer hibái

Olvassa el a HTTP-állapotot és a JSON következő mezőit is: status.code/status.msg. A hitelesítés és a forrás-IP-címre vonatkozó korlátozások szintén megakadályozhatják a használható válasz érkezését. Ne kérjen frissítést GET használatával vagy lekérdezési paraméterekkel pusztán azért, mert a régi kezelő nem ellenőrzi kifejezetten a HTTP-metódust.

Ellenőrzés az újrapróbálkozás előtt

1. A kérés elküldése előtt ellenőrizze a saját tulajdonú számot, a szolgáltatói jogosultságot, a jóváhagyott telefonkönyvi adatokat és a díjat.
2. Egyszer küldje be a kérelmet, és őrizze meg a fiókoldali eredményt anélkül, hogy az ügyfél címét nyilvános naplókban vagy analitikai rendszerekben felfedné.
3. Ellenőrizze a mentett bejegyzést és a tranzakciós előzményeket a támogatott fiókkezelési folyamatban vagy az ügyfélszolgálaton keresztül. Várja meg a szolgáltató által megerősített feldolgozási időt; ez az API nem határoz meg garantált határidőt az adatok elterjedésére.
4. Ha az eredmény bizonytalan, az újrapróbálkozás előtt kérje az ügyfélszolgálattól a szolgáltatói megrendelés és a helyi számlázás egyeztetését. Az ismételt kérés nem idempotens állapotellenőrzés.