Изберете поддържан префикс
Използвайте актуален индивидуален мобилен префикс от откриването. Тази крайна точка е предназначена за NANPA централи: NPA обозначава областния код, а NXX обозначава централата. Префикс само с областен код е твърде широк. Не изпращайте групирани идентификатори за показване и не предполагайте поддръжка за друга държава само защото нейният префикс съдържа достатъчно цифри.
Използвайте бройката като указание
Прочетете response.count, с response.npa и response.nxx, които идентифицират централата. Това е моментна снимка на услугата за покритие, а не наличност, заделена за вашия акаунт. Потвърдете действителните номера, приложимите оферти и всички изисквания за регистрация, преди да поръчате. Успешна бройка никога не упълномощава покупка.
Разграничете нулевата наличност от неуспешно търсене
Успешна бройка нула се различава от грешка в API. Проверете status.code и status.msg, както и HTTP статуса. Приемете изтичането на времето или неуспешното търсене като неизвестна наличност и опитайте отново по-късно с нарастващо изчакване.
Заявка
Използвайте идентификационните данни на вашия активиран API акаунт през HTTPS. Поддържат се удостоверяване Basic и bearer токени на активиран API акаунт; прилагат се ограничения на акаунта.
GET с идентификатора на префикса в пътя на URL адреса. Няма документирани параметри на заявката или тялото.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Име | Тип | Задължителен | Описание |
|---|---|---|---|
prefix_id | string | Да | Копирайте идентификатора на индивидуалния префикс от отговора на откриването. Използвайте поддържан NANPA мобилен префикс, съдържащ областен код (NPA) и централа (NXX), а не само областен код или групиран обобщаващ идентификатор. Приемайте идентификатора като непрозрачен. |
Отговор
Проверете status.code в JSON тялото, както и HTTP статуса. Успешен response има status.code 200 и status.msg Results. response е обект, а не списък: count е целочислена моментна снимка на инвентара; npa и nxx са низове от три знака. status.results не присъства за този асоциативен обект. Бройка 0 означава, че търсенето на покритие не е намерило съответстваща централа или е върнало нулева наличност; това не доказва, че всички доставчици или други маршрути за откриване нямат номера.
Илюстративна форма на отговора; не са реални данни за акаунта или актуална оферта.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Грешки
- 404: Доставчикът е деактивиран: покритието на мобилния инвентар не е налично в услугата.
- 404: Невалиден идентификатор на префикс: получете актуален идентификатор на индивидуален префикс от откриването.
- 404: Невалиден префикс: съхраненият префикс не съдържа достатъчно цифри за търсене по NPA/NXX.
- 500: Неуспешно покритие на инвентара: търсенето в горния слой не върна успешен резултат за покритие. Опитайте отново по-късно с нарастващо изчакване; неуспехът не е бройка на нулева наличност.
Наличност и странични ефекти
- Операцията проверява инвентара и не прави поръчка, не резервира номера и не удържа средства за покупка.
- Наличността може да се промени веднага. Бройката на покритието не е коригирана така, че да обещава възможност за покупка, специфична за акаунта, или същата дължина като следващия отговор при търсене на номера.
- Едно търсене се свързва с услугата за покритие и може да отнеме време. Не правете повторни заявки за всеки префикс и не приемайте изтичане на времето/грешка като успешна нулева наличност.