Domande Frequenti sulla Deprecazione API

Questo argomento include gli avvisi di obsolescenza dell’API e alcune domande comuni sui cambiamenti di versione dell’API.

Consigliamo di tenersi aggiornati con questi cambiamenti e pianificare di conseguenza eventuali aggiornamenti dell’integrazione API.

Per ulteriori informazioni sulle API menzionate in questo argomento, consultare il riferimento all’API al https://dev.megaport.com.

Maggio 2025 - Cambiamenti della versione dell’API

Abbiamo apportato alcuni importanti aggiornamenti alla nostra API che potrebbero riguardarti. A seguito degli aggiornamenti, tutti gli utenti che attualmente si integrano con questi endpoint sono tenuti a migrare alle versioni più recenti.

Le modifiche chiave sono elencate nella tabella sottostante. Le API deprecate saranno completamente ritirate il 31 luglio 2025.

Passo da v2 a v3:

L’API v3 è ora disponibile e richiesta per:
- GET posizione per tutti i servizi
- POST login con username e password
- API impostazioni notifiche
- GET registri attività
- API fattura (Da notare che companyId è stato aggiornato a companyUid e supplierId è stato aggiunto all’URL)

Passo da v3 a v4:

GET MVE Dettagli immagine

Funzione	Vecchia API	Nuova API
GET Località Ritorna un elenco dei data center dove è possibile ordinare una Porta, MCR, o MVE.	GET /v2/locations	GET /v3/locations
POST Effettua l’accesso con Username e Password	POST /v2/login	POST /v3/login
GET Elenca le Impostazioni delle Notifiche	GET /v2/notificationPreferences	GET /v3/notificationPreferences
PUT Cambia le Impostazioni delle Notifiche	PUT /v2/notificationPreferences	PUT /v3/notificationPreferences
GET Attività Utente	GET /v2/activity	GET /v3/activity Tutti questi endpoint sono ora disponibili: /v3/activityNames /v3/companyActivityNames /v3/companyUserNames
GET Fatture Ritorna un elenco di tutte le fatture per l’azienda e la combinazione di mercato di fatturazione, per l’intervallo di date specificato.	/v2/company/${companyid}/invoice/ supplierId/{supplierId}?fromDate=${fromDate} &toDate=${toDate}	/v3/company/${companyUid}/invoice/ supplierId/{supplierId}?fromDate=${fromDate} &toDate=${toDate}
GET Singola Fattura Ritorna la fattura specificata in formato JSON.	/v2/company/${companyid}/invoice/ ${invoiceId}	/v3/company/{companyUId}/supplier/ {supplierId}/invoice/{invoiceId}
GET Singola Fattura PDF	/v2/company/${companyid}/invoice/ ${invoiceId}/pdf	/v3/company/{companyUid}/supplier/ {supplierId}/invoice/{invoiceId}/pdf
GET Singola Fattura CSV	/v2/company/${companyId}/invoice/ ${invoiceId}/csv	/v3/company/{companyUid}/supplier/ {supplierId}/invoice/{invoiceId}/csv
GET MVE Dettagli immagine	GET /v3/product/mve/images	GET /v4/product/mve/images

Febbraio 2024 - Nuove API Fattura

Le nostre API di fattura stanno cambiando.

Per assicurarti di continuare a ricevere i dati di fattura più precisi, aggiornati e completi, comprese le note di credito e le informazioni fiscali, sei tenuto a migrare ai nuovi endpoint API della fattura.

Per ulteriori informazioni sulle API delle fatture, visita https://dev.megaport.com.

Quali API delle fatture sono influenzate?

Questi endpoint API sono stati deprecati e sostituiti con nuovi endpoint API.

Funzione	Vecchia API	Nuova API
GET Fatture	GET /v2/invoice Ritorna un elenco delle fatture per l’azienda associata all’account utente.	GET /v2/company/${companyUid}/invoice/supplierId/{supplierId}?fromDate=${fromDate}&toDate=${toDate}? Ritorna un elenco delle fatture per la combinazione di ID azienda e ID mercato di fatturazione, per l’intervallo di date specificato.
GET Singola Fattura	GET v2/invoice/{invoiceId} Ritorna la fattura per l’`invoiceId` specificato.	GET /v2/company/${companyId}/invoice/${invoiceId} Ritorna la fattura per l’`companyId` e l’`invoiceId` specificati in formato JSON.
GET Singola Fattura PDF	GET /v2/invoice/{invoiceId}/pdf Ritorna una versione PDF della fattura per l’`invoiceId` specificato.	GET /v2/company/${companyId}/invoice/${invoiceId}/pdf Ritorna una versione PDF della fattura per l’`companyId` e l’`invoiceId` specificati.
GET Singola Fattura CSV	GET /v2/invoice/{invoiceId}/csv Ritorna una versione CSV della fattura per l’`invoiceId` specificato.	GET /v2/company/${companyId}/invoice/${invoiceId}/csv Ritorna una versione CSV della fattura per l’`companyId` e l’`invoiceId` specificati.

Dove trovo le informazioni relative al fornitore e all’azienda?

Tutte le nuove API di fattura richiedono l’invio di informazioni relative all’azienda e al fornitore come parte della chiamata API. Puoi trovare questi valori dalle seguenti API Megaport:

supplierId è il “firstPartyId” restituito nell’API GET Billing Markets /v2/market per il fornitore pertinente.
companyUid viene restituito nell’API GET Product List /v2/products o nell’API GET API Keys /v2/auth/apikeys.
companyId viene restituito nell’API GET Company Details /v2/company/companyUid.

Quando devo iniziare a utilizzare le nuove API delle fatture?

Il prima possibile. Le nuove API delle fatture sono attualmente disponibili in Produzione, eventuali futuri miglioramenti relativi alle fatture saranno applicati solo alle nuove API.

Quando le API delle fatture legacy saranno ritirate?

Le API delle fatture legacy sono state deprecate e non sono più supportate.

Con chi posso parlare per ulteriori informazioni?

Si prega di contattare il tuo Account Manager o il Supporto Megaport. Per ulteriori informazioni, consulta Contattare il Supporto.

Aprile 2023 - API v2 MVE

Nell’aprile 2023, abbiamo lanciato una nuova versione di Megaport Virtual Edge (MVE). In precedenza, MVE era offerto come un pacchetto con specifiche preimpostate per calcolo, circuiti virtuali e Megaport Internet. Con questa ultima versione, abbiamo scomposto Megaport Internet per separare il calcolo dalle connessioni Virtual Cross Connect (VXC) e Megaport Internet. Scomponendo le funzioni di calcolo e transito, ora puoi ottenere un nuovo livello di configurabilità e flessibilità personalizzando ulteriormente la tua rete in base alle tue esigenze.

MVE è ora disponibile anche in diverse dimensioni e ha il doppio della RAM della nostra versione precedente per una migliore prestazione. Le dimensioni del calcolo sono ora 2/8, 4/16, 8/32 e opzioni di capacità superiore, dove il primo numero è la CPU e il secondo numero è la GB di RAM disponibile.

Per abilitare questa nuova funzionalità, è stata creata un’API v3 per ottenere i prezzi, convalidare, ordinare, modificare ed eliminare MVE e le connessioni Megaport Internet come prodotti separati. Gli integratori API esistenti che desiderano modificare la velocità della loro connessione Megaport Internet dovranno integrarsi con la nuova API v3.

Di conseguenza, gli utenti che si integrano con le API Validate and Buy per altri tipi di servizio, tra cui Porte, MCR, VXC e IX, oltre a MVE e Megaport Internet connections, saranno anche tenuti a migrare alla versione v3 più recente. Non vengono applicate modifiche per questi tipi di servizio, oltre alla versione, all’url, al corpo della richiesta o al corpo della risposta.

Per mantenere la retrocompatibilità per i nostri integratori API esistenti, gli utenti dell’API potranno continuare a utilizzare le attuali chiamate API Megaport v2 per ordinare MVE bundle fino al 30 settembre 2024, momento in cui l’API legacy v2 sarà deprecata. Quando si ordina un MVE con le API v2, verrà automaticamente creata una connessione Megaport Internet con la velocità predefinita associata alla dimensione di MVE selezionata.

Si incoraggiano tutti gli integratori a migrare e iniziare a utilizzare le API v3 quando ordinano MVE e Megaport Internet connections per sfruttare al massimo la flessibilità aggiuntiva.

Il nostro Portal Cliente è già passato alla v3 per:

Ottieni i prezzi di MVE e VXC:

GET /v3/pricebook/mve?locationId={locationId}&vendor={vendor}&size={size}
GET /v3/pricebook/vxc?bLocationId={bLocationId}&aLocationId={aLocationId}

Valida e compra di tutti i tipi di servizi:

POST /v3/networkdesign/validate
POST /v3/networkdesign/buy

Aggiorna VXC (solo):

PUT /v3/product/vxc/{productUid}

Elimina tutti i tipi di servizi:

POST /v3/product/{productUid}/action/{action}

Quando devo iniziare a utilizzare l’API v3 di MVE?

Il prima possibile e non oltre settembre 2024. Le API v3 di MVE sono attualmente disponibili in Produzione, eventuali futuri miglioramenti relativi a MVE e le connessioni a Megaport Internet verranno applicate solo alle API v3.

Quando le API v2 di MVE saranno deprecate?

Le API v2 di MVE saranno deprecate il 30 settembre 2024.

Quali sono le API v2 che sono influenzate?

Questa tabella elenca le API v2 influenzate da questi cambiamenti:

Funzione	Vecchia API	Nuova API
Ottieni il Prezzo MVE	GET /v2/pricebook/mve Ritorna il prezzo di MVE + connessione Megaport Internet.	GET /v3/pricebook/mve Ritorna il prezzo del solo calcolo di MVE.
Ottieni il Prezzo VXC	GET /v2/pricebook/vxc Non restituisce il prezzo Megaport Internet.	GET /v3/pricebook/vxc Con connectType=transit, ritorna il prezzo della connessione Megaport Internet.
Valida gli ordini per tutti i tipi di prodotto: Porta, MCR, MVE, VXC, IX	POST /v2/networkdesign/validate Per MVE, valida l’ordine di MVE + connessione Megaport Internet insieme.	POST /v3/networkdesign/validate Per MVE, valida l’ordine di MVE solo. Nota: Le dimensioni disponibili sono: `"SMALL" "MEDIUM" "LARGE" "X_LARGE_12"`.
Compra servizi per tutti i tipi di prodotto: Porta, MCR, MVE, VXC, IX	POST /v2/networkdesign/buy Per MVE, compra MVE + Megaport Internet connection insieme.	POST /v3/networkdesign/buy Per MVE, compra solo l’MVE. Può comprare Megaport Internet connections singole.
Aggiorna i Dettagli VXC	PUT /v2/product/vxc/{productUid} Non può aggiornare le connessioni Megaport Internet.	PUT /v3/product/vxc/{productUid} Può aggiornare le connessioni Megaport Internet.
Cancella servizi per tutti i tipi di prodotto: Porta, MCR, MVE, VXC, IX	POST /v2/product/{productUid}/ action/{action}	POST /v3/product/{productUid}/ action/{action}

Cosa succede se non ho migrato in tempo?

La tua integrazione con MVE smetterà di funzionare e non sarai più in grado di ordinare nuovi o aggiornare esistenti MVE. Per ulteriori informazioni, contatta il tuo Account Manager.

Con chi posso parlare per ulteriori informazioni?

Si prega di contattare il tuo Account Manager o il Supporto Megaport. Per ulteriori informazioni, consulta Contattare il Supporto.