Risolvere i problemi dell’API
Se incontri problemi con l’API o con la soluzione Terraform di Megaport, segui queste azioni di risoluzione dei problemi.
Per i tutorial dell’API e una guida passo-passo, consulta Panoramica dell’API Megaport. Per un riferimento completo, inclusi esempi funzionanti, consulta https://dev.megaport.com/.
Per provare l’API, consigliamo il client Postman con la collezione importata di Megaport; le informazioni sul download e sull’uso di Postman si trovano nella documentazione.
Azioni di risoluzione dei problemi
| Azione | Passaggi |
|---|---|
| Assicurati che il token di accesso API sia valido | Le chiamate API di Megaport richiedono un token di accesso che puoi generare dopo aver creato una chiave API. Un token di accesso è necessario per autenticare gli utenti dell’API e permette l’accesso temporaneo solo alle parti del Megaport Portal richieste. I token di accesso scadono dopo un massimo di 24 ore, dopodiché devi generare un nuovo token di accesso. Per maggiori informazioni, vedi Creazione di una chiave API. |
| Assicurati che l’ambiente API (URL) sia corretto | Assicurati che gli URL che stai utilizzando siano per l’ambiente previsto.
|
| Assicurati che i parametri API siano corretti | L’API di Megaport utilizza codici di risposta HTTP standard. In generale, un errore 400 - Bad Request è tipicamente causato da parametri mancanti o errati. Se stai ricevendo questo errore, controlla attentamente i tuoi parametri. |
| Assicurati che la sintassi della tua API sia corretta | La sintassi corretta è essenziale quando si interagisce con l’API di Megaport. L’API di Megaport si basa su REST, ha URL prevedibili e accetta corpi di richiesta codificati in formato. Puoi vedere esempi di chiamate corrette su https://dev.megaport.com. Seleziona la tua lingua preferita dal menu a discesa su questa pagina e potrai vedere esempi su come fare qualsiasi cosa all’interno dell’ambiente API. |
| Limiti API | Limite di Frequenza Generale C’è un limite di 500 richieste in un intervallo di 5 minuti per indirizzo IP. Aggiornamenti del servizio Puoi fare un solo aggiornamento del servizio ogni 5 minuti e c’è un massimo di 100 aggiornamenti al mese per servizio. Nota: Attualmente, questi non sono limiti rigidi, ma Megaport monitora e rivede quando vengono superati i limiti. Se si verificano superamenti del limite, l’accesso potrebbe essere bloccato. |
Messaggi di errore comuni dell’API
Errore di accesso
"message": "Bad session token - try logging in again."
Cause comuni:
- nome utente, email o password errati
- token mancante o errato
Errore di sintassi
HTTP Status 400 – Bad Request
L’errore si verifica comunemente quando è mancante o errata una sintassi richiesta.
URL API errato
Un esempio dell’errore che è correlato all’URL incorrecto è:
“message”:” Service abcd1234 has wrong product type VXC”
In questo scenario, il cliente ha utilizzato questo URL:
URL = "https://api-staging.megaport.com/v2/product/megaport/abcd1234-1234-1234-1234-abcdef123456/telemetry?from=1614283800000&to=1614284400000&type=BITS"
ma l’URL corretto è:
URL = "https://api-staging.megaport.com/v2/product/vxc/abcd1234-1234-1234-1234-abcdef123456/telemetry?type=A_BITS&from=1614283800000&to=1614284400000"
Parametri errati
Come esempio, un cliente ha segnalato l’assenza di output di dati quando richiedeva la telemetria del VXC per questo intervallo di tempo:
- From: GMT: Martedì, 3 agosto 2021 13:52:23
- To: GMT: Martedì, 3 agosto 2021, 13:57:23
Sintassi
https://api-staging.megaport.com/v2/product/vxc/abcd1234-1234-0000000000telemetry?type=A_BITS&from=1627998743&to=1627999043
Output
{“serviceUid”:”abcd1234-1234-0000000000”,”type”:”A_BITS”,”timeFrame”:{“from”:1627998743,”to:”1627999043},”data”:[ ]}
Dal Prendi la documentazione Telemetria VXC i parametri Da e A devono essere impostati in millisecondi per ciascun valore epoch (quindi ogni valore aveva bisogno di zeri extra alla fine):
https://api-staging.megaport.com/v2/product/vxc/abcd1234-1234-0000000000telemetry?type=A_BITS&from=1627998743000&to=1627999043000
Dati richiesti da Megaport
Se le azioni di risoluzione dei problemi non risolvono il tuo problema, contatta il Supporto Megaport. In caso di problemi con l’API, Megaport indagherà e lavorerà alla risoluzione del problema al back end.
Per facilitare l’indagine, fornisce i risultati dei test che hai eseguito e qualsiasi altra informazione pertinente, come:
- Email/account utilizzato
- Data, ora e fuso orario dell’azione e quando si è verificato l’errore
- Configurazione API
- URL API
- Dati del corpo
- Parametri e sintassi dell’endpoint
- Tipo di errore e uno screenshot dell’errore