API Data Plan Agent
Ottobre 2019
- Richiedi un nuovo CPID ogni volta che contattiamo l'endpoint CPID. Ciò può essere ottenuto aggiungendo un timestamp all'algoritmo di generazione CPID.
- Rimuovi planLanguage da Offer, che fino a questo momento era contrassegnato come campo obbligatorio.
Settembre 2019
- Aggiunto il supporto per le notifiche di scadenza dei dati, che si distinguono dalle notifiche di avviso di scadenza dei dati.
Luglio 2019
- È stato chiarito i possibili valori dell'identificatore client.
- Aggiunto il supporto per le notifiche di ricarica dell'account.
- Requisiti di generazione CPID rilassati per richiedere un nuovo CPID ogni volta che viene chiamato l'endpoint CPID.
- Aggiungi la documentazione per le diverse risposte di errore di GTAF quando chiami l'API Mobile Data Plan Sharing.
Giugno 2019
- Specifica dell'API DPA aggiornata che richiede l'accettazione da parte degli operatori di un id client come parametro di ricerca.
- Aggiornamento dell'API Mobile Data Plan Sharing che consente agli operatori di condividere con Google le informazioni sui piani di un utente per un determinato cliente.
- L'ordine in cui le offerte vengono mostrate all'utente potrebbe non corrispondere a quello in cui le offerte vengono inviate a GTAF.
- GTAF può condividere più di 10 piani con l'UI del piano dati mobili.
Maggio 2019
- La scadenza è obbligatoria a meno che il piano non scada.
- In base alla RFC 6749, contrassegna token_type come richiesto nella risposta del server OAuth.
- Restituisce il tipo di notifiche che sono state inviate all'utente quando l'operatore invia uno stato del piano a GTAF.
Aprile 2019
- Per gli abbonati che prepagano sono necessari accountInfo.
- Aggiorna il metodo di generazione CPID consigliato per includere un linguaggio in testo normale al momento della generazione del CPID.
- È stato rimosso il supporto di moreInfoUrl, operatorLogoUrl, purchaseUrl dalle offerte. Questi campi non erano supportati dall'interfaccia utente del piano dati mobili. La modifica è compatibile con le versioni precedenti.
- Aggiunto il supporto per l'invio di notifiche quando un utente sta spendendo il saldo dell'account utilizzando i dati con pagamento a consumo.
- Rimosso il supporto per le finestre temporali flessibili dai moduli del piano. La modifica è compatibile con le versioni precedenti. Pertanto, se un operatore ci invia finestre temporali flessibili, la risposta verrà accettata.
Marzo 2019
- Rimuovi offerInfo.promoMessage dall'insieme di campi obbligatori. MDP non utilizza questo campo quando mostra le offerte agli utenti.
- Correggi il bug della documentazione secondo cui il CPID deve essere codificato nell'URL. GTAF codifica invece il CPID in base al documento RFC2396.
- Sono stati aggiunti requisiti per le notifiche push.
Febbraio 2019
- Rimosso il supporto per la condivisione di PlanOffer con Google utilizzando l'API di condivisione del piano dati.
Gennaio 2019
- È stata aggiunta una guida all'aggiornamento della configurazione dell'operatore tramite il portale ISP.
- È stata aggiunta una guida all'implementazione di OAuth per l'API Data Plan Agent.
- La guida all'integrazione dell'API Mobile Data Plan Sharing è stata rinominata e riorganizzata.
Novembre 2018
- Aggiunto il supporto per le notifiche di attivazione del piano.
- Aggiunto il supporto per una categoria di traffico del modulo del piano APP_STORE.
Settembre 2018
- È stata aggiunta un'API per segnalare il consenso dell'utente agli operatori.
- Aggiunto il supporto per i piani che aggiornano periodicamente la loro quota in PlanModule e Offerta.
- Aggiunto il supporto per le notifiche relative alla scadenza.
- PlanModuleState rinominato in PlanState. Questa è una modifica alla documentazione che non dovrebbe influire sugli operatori.
Agosto 2018
- Aggiunta la possibilità per gli operatori di specificare il saldo dell'account come parte di un PlanStatus.
Giugno 2018
- Aggiornamento rimosso, visualizzazione dei metodi per lo stato e le offerte del piano.
- Livello di saldo approssimativo consentito da compilare nello stesso momento in cui viene completato il saldo byte o il saldo temporale.
- Tipo di connessione aggiunto a un'Offerta.
- È stato aggiunto il campo stato del modulo del piano a PlanModule per consentire a un operatore di indicare i piani che l'utente ha acquistato, ma che non sono ancora stati attivati. Questo campo non è obbligatorio.
- DataPlan rinominato in Plan. Questa è una modifica alla documentazione che non dovrebbe influire sugli operatori.
- Aggiunto il campo formOfPayment a PlanOffer per consentire a un operatore di specificare la modalità di addebito per l'acquisto sull'utente. Il valore predefinito verrà detratto dal saldo del piano.
Maggio 2018
- È stata aggiornata la risposta CPID per mantenere la risposta compatibile con le versioni precedenti.
- Titolo aggiunto per un PlanStatus. Il titolo verrà utilizzato per completare l'intestazione nella UI delle impostazioni.
- Sono stati aggiunti il nome del modulo e i byte utilizzati per un PlanModule.
- Aggiunta una chiamata di risposta all'acquisto a GTAF.
Marzo 2018
Questo aggiornamento include le seguenti modifiche all'API del piano dati. Queste modifiche riguardano l'API Data Plan v4.2 ospitata qui.
- Ritira le seguenti chiamate API:
- Esecuzione di query sull'account utente (DPA_URL/{data_plan_key_string}/account).
- Esecuzione di query sui piani acquistati (DPA_URL/{data_plan_key_string}/purchasedPlans).
- Modifica l'URL che chiamiamo per lo stato del piano dati. Il nuovo URL è descritto qui. L'ETD dovrebbe restituire un'istanza di PlanStatus.
- Modifica l'URL che chiamiamo per le offerte del piano. Il nuovo URL è descritto qui. La DPA dovrebbe restituire un'istanza di PlanOffer.
- Modifica il corpo della richiesta inviata a DPA quando acquista un piano. Tieni presente che la chiamata API è la stessa. Il corpo della richiesta ora contiene un'istanza di TransactionRequest. Nota la rimozione di un livello di nidificazione rispetto alla versione precedente dell'API.
- La risposta a una richiesta di acquisto è cambiata. Utilizziamo il tipo di valuta definito dal protocollo Google. In risposta a un acquisto riuscito, ci aspettiamo che il corpo della risposta contenga un'istanza di TransactionResponse.
- Se
plan_id
non è specificato, l'API di idoneità DEVE restituire tutti i piani di dati per cui l'utente è idoneo. In precedenza, questa operazione era facoltativa. - Aggiunge un endpoint di registrazione MSISDN per GTAF per registrare i MSISDN per le notifiche con l'ETD.
API Google Mobile Data Plan Sharing
Marzo 2018
Questo aggiornamento include le seguenti modifiche all'API Google Mobile Data Plan:
- Introduce nuove chiamate API che consentono a un operatore di effettuare il push dell'upsell delle informazioni a GTAF, per estenderle ulteriormente ai dispositivi degli utenti. Queste nuove chiamate consentono a un operatore di inviare le offerte a Google.
- Presenta un campo Ultimo aggiornamento in un PlanGroup.
- Rimuove il campo percentuale di credito dati dalla finestra temporale flessibile.