Dostęp do konta i projektu
Używaj aktywnego konta API przez HTTPS z dozwolonego adresu IP. Projekt musi należeć do tego konta i nie może być usunięty. Użyj unikalnego identyfikatora projektu z procesu składania zamówienia na przeniesienie numerów, a nie jego numerycznego identyfikatora w bazie danych ani numeru telefonu. Podczas tworzenia żądania zastosuj kodowanie URL do identyfikatora projektu.
Żądanie
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Odpowiedź
Fikcyjny przykład odpowiedzi.
{
"status": {
"code": 200,
"msg": "Project Numbers",
"results": 1
},
"response": [
{
"id": 21,
"number": "12025550123",
"status": 0,
"status_str": "Pending",
"isocode": "US",
"updated": "2026-10-23 12:00:00",
"foc": "",
"comment": "Example customer-visible note",
"date_created": "2026-10-23 12:00:00",
"date_completed": ""
}
]
}response jest listą. Istniejący projekt bez numerów zwraca pustą listę z kodem API 200 i wartością status.results równą 0. Nieistniejące projekty zwracają natomiast kod API 404.
Pola numerów
| Pole | Znaczenie |
|---|---|
| id, number, isocode | Numeryczny identyfikator wiersza, zapisany tekst numeru telefonu i kod kraju. Identyfikator wiersza nie jest identyfikatorem projektu. |
| status, status_str | Numeryczny status i jego znana etykieta. |
| foc | Zapisana wartość harmonogramu wiążącego potwierdzenia zamówienia. Może być pusta; procedura obsługi nie przekształca jej do udokumentowanej strefy czasowej ani formatu znacznika czasu. |
| updated, date_created, date_completed | Zapisane wartości aktualizacji, utworzenia i zakończenia. Obsługuj puste wartości wprost; nie zakładaj formatu ISO8601 ani nie wnioskuj o strefie czasowej na podstawie fikcyjnego przykładu. |
| comment | Zapisany komentarz przeznaczony dla klienta. Wyświetlaj go jako tekst, a nie wykonywalny HTML. |
Ta reprezentacja pomija pole internal_comment przeznaczone wyłącznie dla pracowników. Nie oznacza to, że odrębne starsze wyszukiwanie pojedynczego numeru używa tej samej reprezentacji.
Sortowanie i monitorowanie
Zapytanie sortuje wyniki rosnąco według czasu utworzenia. W przypadku wierszy o takim samym czasie utworzenia nie ma gwarancji żadnej dodatkowej kolejności. Nie ma stronicowania, kursora przyrostowego ani filtra daty. Odczytaj pełną listę, aby uzgodnić dane projektu, i nie traktuj jego bieżącej liczby wierszy jako stałego katalogu.
Interpretacja statusu przenoszenia numerów
| Wartość | Etykieta |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Zachowaj numeryczny status i obsługuj nieznane wartości. Przy nieznanych etykietach używana jest zapisana wartość, zamiast gwarancji nowej etykiety. Zapisany status zakończenia lub zaplanowana data same w sobie nie stanowią testu routingu połączeń przychodzących ani wszystkich usług numeru.
Błędy i ograniczenia
Sprawdź zarówno odpowiedź HTTP, jak i status.code/status.msg. Nieistniejący, usunięty lub nienależący do konta projekt zwraca kod API 404 z komunikatem o nieznalezieniu projektu. Obowiązują również ograniczenia uwierzytelniania i źródłowego adresu IP. Przykłady nie wykonują rzeczywistego żądania, a pomyślna odpowiedź nie dowodzi, że operator zaakceptował lub zakończył przeniesienie.
Skutki
Sprawdzona procedura obsługi jedynie odczytuje projekt i zapisane w nim wiersze numerów. Odpowiedź jest migawką danych, a nie potwierdzeniem operatora ani testem usługi na żywo. Nie inicjuje przeniesienia numeru, nie zmienia routingu ani nie obciąża konta.