Toegang tot account en project
Gebruik een ingeschakeld API-account via HTTPS vanaf een toegestaan IP-adres. Het project moet bij dat account horen en mag niet verwijderd zijn. Gebruik de unieke project-ID uit het proces voor de porteringsaanvraag, niet de numerieke database-ID of een telefoonnummer. Pas URL-codering toe op de project-ID wanneer u een verzoek samenstelt.
Verzoek
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID"Behandel dit antwoord als vertrouwelijk
Het volledige antwoord bevat facturatiegegevens van de vertrekkende provider, waaronder de opgeslagen waarde voor billing_pin, het facturatieaccount, het telefoonnummer, het adres, het bedrijf en de gegevens van de bevoegde contactpersoon. De API maskeert deze velden niet. Vraag alleen de status of nummerlijst op als dat voldoende is voor uw werkproces. Bewaar het volledige detailantwoord niet in browseropslag, analysesystemen, openbare logboeken of schermafbeeldingen voor ondersteuning, en toon alleen de velden die een bevoegde klant nodig heeft.
Structuur van het antwoord
Fictief voorbeeld met geselecteerde velden; het antwoord kan aanvullende velden bevatten.
{
"status": {
"code": 200,
"msg": "Project Detail"
},
"response": {
"project": {
"id": 11,
"uniqueid": "PROJECT_EXAMPLE",
"project_name": "Example transfer",
"location": "US",
"status": 0,
"status_str": "Pending"
},
"counts": {
"total": 0,
"pending": 0,
"in_progress": 0,
"completed": 0,
"rejected": 0
},
"numbers": [],
"events": [],
"uploads": []
}
}In dit bewust onvolledige voorbeeld zijn alle authenticatiegegevens voor facturatie en persoonlijke contactgegevens weggelaten. Dat ze in het voorbeeld ontbreken, betekent niet dat ze in het werkelijke antwoord worden afgeschermd.
| Onderdeel | Inhoud |
|---|---|
| project | Numerieke rij-ID, unieke project-ID, projectnaam, locatie, opgeslagen facturatie-, contact- en adresgegevens, aanmaaktijd en afgeleide status. Het verouderde veld voor de vertrekkende provider heeft de spelling loosing_carrier. |
| counts | Het totale aantal nummerrijen en tellers voor Pending, In Progress, Completed en Rejected. |
| numbers | Dezelfde selectie van nummergegevens als bij het eindpunt voor de nummerlijst van het project, inclusief opmerkingen van klanten en opgeslagen planningswaarden. |
| events | Opgeslagen gebeurtenisrijen en velden met onbewerkte en geparste berichtinhoud, onder de zichtbaarheids- en formaatbeperkingen van het gebeurteniseindpunt. |
| uploads | Documentmetadata: numerieke ID, upload_type, file_name, file_extension, date_created en een relatieve download_url. Voor toegang via de URL blijft accountauthenticatie vereist. |
De samenvatting en metadata interpreteren
Bij het afleiden van de status krijgt In Progress voorrang, gevolgd door Pending, daarna Completed en vervolgens Rejected, met Pending als terugvalwaarde. Een samenvattende status Completed kan ook voorkomen als er afgewezen nummers zijn. Controleer de tellers en nummerstatussen in plaats van aan te nemen dat de portering van elk nummer is voltooid.
Het antwoord bevat documentmetadata, geen bestandsbytes. Het heeft geen paginering of incrementele cursor. De detail- en lijstquery's zijn afzonderlijke leesbewerkingen en vormen geen gegarandeerd transactioneel consistente momentopname. Datums blijven de opgeslagen waarden, zonder gedocumenteerde tijdzoneconversie. Gebruik uniqueid voor projectroutes; de numerieke project-ID kan daar niet voor in de plaats worden gebruikt.
Fouten en beperkingen
Controleer zowel het HTTP-antwoord als status.code/status.msg. Een ontbrekend of verwijderd project, of een project dat niet bij het account hoort, levert API-code 404 op met een melding dat het project niet is gevonden. Ook authenticatievereisten en beperkingen voor het bron-IP-adres zijn van toepassing. De voorbeelden voeren geen daadwerkelijk verzoek uit, en een geslaagd antwoord bewijst niet dat een provider een portering heeft geaccepteerd of voltooid.
Effecten en werkproces
Dit is de canonieke detailroute die de weergave van porteringsaanvragen in het huidige portaal gebruikt. Het portaal koppelt velden aan zijn gebruikersinterface en past een eigen selectie en vormgeving van klantgegevens toe; ga er niet van uit dat het onbewerkte API-antwoord identiek is aan de JSON of de weergave van het portaal. De beoordeelde detailhandler wijzigt het project niet en start niet rechtstreeks een verzoek aan de provider of een afschrijving.