Åtkomst till konto och projekt
Använd ett aktiverat API-konto via HTTPS från en tillåten IP-adress. Projektet måste tillhöra det kontot och får inte vara raderat. Använd projektets unika ID från arbetsflödet för porteringsbeställningar, inte dess numeriska databas-ID eller ett telefonnummer. URL-koda projektets ID när du skapar en begäran.
Begäran
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Svar
Fiktivt svarsexempel.
{
"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 är en lista. Ett befintligt projekt utan nummer returnerar en tom lista med API-kod 200 och ett värde för status.results som är lika med 0. Projekt som inte finns returnerar däremot API-kod 404.
Nummerfält
| Fält | Betydelse |
|---|---|
| id, number, isocode | Numeriskt rad-ID, lagrad telefonnummertext och landskod. Radens ID är inte projektets ID. |
| status, status_str | Numerisk status och dess kända etikett. |
| foc | Lagrat schemaläggningsvärde för den bindande orderbekräftelsen. Det kan vara tomt; hanteraren omvandlar det inte till en dokumenterad tidszon eller ett dokumenterat tidsstämpelformat. |
| updated, date_created, date_completed | Lagrade värden för uppdatering, skapande och slutförande. Hantera tomma värden uttryckligen; förutsätt inte ISO8601 och härled inte en tidszon från det fiktiva exemplet. |
| comment | Lagrad kommentar avsedd för kunden. Visa den som text, inte som körbar HTML. |
Den här datavyn utelämnar fältet internal_comment som endast är avsett för personalen. Det betyder inte att den separata äldre sökningen efter ett enskilt nummer använder samma datavy.
Sortering och övervakning
Frågan sorterar i stigande ordning efter tidpunkten då raden skapades. Rader med samma skapandetid har ingen ytterligare garanterad ordning. Det finns ingen sidindelning, inkrementell markör eller något datumfilter. Läs hela listan för att stämma av ett projekts data och betrakta inte det aktuella antalet rader som en permanent katalog.
Tolka porteringsstatus
| Värde | Etikett |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Behåll den numeriska statusen och hantera okända värden. För okända etiketter används det lagrade värdet, utan att en ny etikett garanteras. En lagrad slutförandestatus eller ett planerat datum testar inte i sig inkommande dirigering eller alla tjänster på numret.
Fel och begränsningar
Kontrollera både HTTP-svaret och status.code/status.msg. Ett projekt som saknas, är raderat eller inte tillhör kontot returnerar API-kod 404 med ett meddelande om att projektet inte hittades. Begränsningar för autentisering och käll-IP gäller också. Exemplen utför ingen verklig begäran, och ett lyckat svar bevisar inte att en operatör har godkänt eller slutfört en överföring.
Effekter
Den granskade hanteraren läser endast projektet och dess lagrade nummerrader. Svaret är en ögonblicksbild, inte en operatörsbekräftelse eller ett verkligt tjänstetest. Det startar ingen portering, ändrar ingen dirigering och debiterar inte kontot.