Subscription
Consulta il piano di abbonamento attivo e il saldo crediti del tuo account.
Ottieni l'abbonamento attivo
Restituisce il piano di abbonamento attualmente attivo per il tuo account. La risposta include il codice del piano (es. monthly_pro, annual_business), lo stato (active per l'abbonamento in vigore), le date di inizio e fine del periodo di fatturazione corrente, il prossimo azzeramento dei contatori di utilizzo, se l'abbonamento è stato annullato e il codice del piano successivo, se è previsto un cambio di piano. Usa questo endpoint per verificare in modo programmatico il livello del tuo piano prima di effettuare chiamate API che potrebbero essere limitate in base al piano, oppure per mostrare le informazioni sull'abbonamento nella tua dashboard. Le date del periodo di fatturazione definiscono il ciclo di fatturazione corrente, al termine del quale il piano si rinnova a meno che non venga annullato. La data nextRenew è il prossimo azzeramento dei contatori di utilizzo: in un piano annuale arriva ogni mese, molto prima di billingPeriodEnd. Se canceled è true mentre lo stato è ancora active, il piano resta utilizzabile fino alla fine del periodo di fatturazione corrente, dopodiché non verrà rinnovato; nextPlan, se presente, è il piano che subentra. Restituisce 401 se la chiave API è mancante o non valida. Restituisce 404 se non esiste alcun abbonamento attivo per il tuo account. Restituisce 502 se il servizio upstream degli abbonamenti è temporaneamente non disponibile.
Ottieni saldo crediti
Restituisce il saldo crediti del tuo account, suddiviso in tre valori: credito totale, credito congelato e credito disponibile. Il credito è la valuta usata per pagare l'invio dei messaggi e le altre operazioni a pagamento sulla piattaforma, e tutti e tre i valori sono espressi in crediti. Il campo credit è il tuo saldo crediti totale. Il campo frozenCredit rappresenta il credito riservato (congelato) per operazioni in sospeso, come le campagne programmate che sono state messe in coda ma non ancora completamente consegnate. Il credito congelato non può essere speso per nuove operazioni finché le operazioni in sospeso non vengono completate o annullate. Il campo availableCredit è l'importo che puoi effettivamente spendere in questo momento (credit meno frozenCredit). Controlla questo endpoint prima di lanciare campagne di grandi dimensioni, per assicurarti di avere credito disponibile sufficiente a coprire il costo stimato. Se il credito disponibile è insufficiente, la campagna o l'invio del messaggio potrebbero essere rifiutati. Il credito può essere ricaricato tramite la dashboard di fatturazione o tramite il tuo account manager. Se il tuo account non ha ancora crediti, tutti e tre i valori sono 0. Restituisce 401 se la chiave API è mancante o non valida. Restituisce 502 se il servizio upstream del wallet è temporaneamente non disponibile.