Válasszon támogatott előtagot
Használjon aktuális, egyedi mobil előtagot a felderítésből. Ez a végpont NANPA központokra készült: az NPA a körzetszámot azonosítja, az NXX pedig a központot. A csak körzetszámot tartalmazó előtag túl tág. Ne küldjön csoportosított megjelenítési azonosítókat, és ne következtessen más ország támogatására abból, hogy annak előtagja elég számjegyet tartalmaz.
Használja a darabszámot támpontként
Olvassa el a response.count mezőt, a response.npa és response.nxx mezőkkel, amelyek azonosítják a központot. Ez a lefedettségi szolgáltatás pillanatképe, nem az Ön fiókjának fenntartott készlet. Erősítse meg a tényleges számokat, az alkalmazandó árajánlatokat és minden regisztrációs követelményt, mielőtt megrendel. A sikeres darabszám soha nem jogosít fel vásárlásra.
Különítse el a nulla készletet a sikertelen lekérdezéstől
A nulla értékű sikeres darabszám eltér egy API-hibától. Vizsgálja meg status.code és status.msg mellett a HTTP-állapotot is. Kezelje az időtúllépést vagy a sikertelen lekérdezést ismeretlen elérhetőségként, és később, a próbálkozások között várakozva próbálja újra (backoff).
Kérés
Használja az engedélyezett API-fiók hitelesítő adatait HTTPS-en keresztül. A Basic hitelesítés és az engedélyezett API-fiók bearer tokenjei támogatottak; a fiókkorlátozások érvényesek.
GET az előtag azonosítójával az URL elérési útjában. Nincsenek dokumentált lekérdezési vagy törzsparaméterek.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Név | Típus | Kötelező | Leírás |
|---|---|---|---|
prefix_id | string | Igen | Másolja az egyedi előtag azonosítóját a felderítési válaszból. Használjon támogatott NANPA mobil előtagot, amely körzetszámot (NPA) és központot (NXX) tartalmaz, ne csak körzetszámot vagy csoportosított összesítő azonosítót. Kezelje az azonosítót átlátszatlanként. |
Válasz
Ellenőrizze a status.code mezőt a JSON-törzsben, valamint a HTTP-állapotot. A sikeres response esetén status.code 200 és status.msg Results szerepel. A response objektum, nem lista: a count egy egész számú készletpillanatkép; az npa és az nxx három karakterből álló karakterláncok. A status.results nem szerepel ennél az asszociatív objektumnál. A 0 darabszám azt jelenti, hogy a lefedettségi lekérdezés nem talált egyező központot, vagy nulla készletet adott vissza; ez nem bizonyítja, hogy minden szállítónál vagy más felderítési útvonalon ne lennének számok.
Illusztratív válaszforma; nem élő fiókadat és nem aktuális árajánlat.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Hibák
- 404: Szolgáltató letiltva: a mobilkészlet-lefedettség nem érhető el a szolgáltatásban.
- 404: Érvénytelen előtag-azonosító: szerezzen be aktuális, egyedi előtag-azonosítót a felderítésből.
- 404: Érvénytelen előtag: a tárolt előtag nem tartalmaz elég számjegyet egy NPA/NXX kereséshez.
- 500: Készletlefedettség sikertelen: a felsőbb réteg felé indított lekérdezés nem adott vissza sikeres lefedettségi eredményt. Próbálja újra később, a próbálkozások között várakozva (backoff); a hiba nem jelenti a készlet nulla darabszámát.
Elérhetőség és mellékhatások
- A művelet ellenőrzi a készletet, és nem ad le megrendelést, nem foglal le számokat, és nem terhel meg vásárlási összeget.
- A készlet azonnal változhat. A lefedettségi darabszám nincs úgy beállítva, hogy fiókspecifikus megvásárolhatóságot vagy a következő számkeresési válaszzal azonos hosszt ígérjen.
- Egy lekérdezés kapcsolatba lép a lefedettségi szolgáltatással, és időbe telhet. Ne kérdezzen le ismételten minden előtagot, és ne kezelje az időtúllépést/hibát sikeres nulla készletként.