Skip to main content
Questo documento introduce un’API di verifica dello stato del numero di cellulare, che può essere utilizzata per convalidare lo stato di un numero di cellulare, è possibile inserire il numero di cellulare per effettuare la verifica.

​
Procedura di richiesta

Per utilizzare l’API di verifica dello stato del numero di cellulare, prima di tutto vai al Pannello di controllo di Ace Data Cloud per ottenere il tuo API Token, da conservare per uso futuro. Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e accedere, una volta completato, verrai riportato automaticamente alla pagina corrente. Un API Token è sufficiente per accedere a tutti i servizi della piattaforma, non è necessario richiederne uno separato per ogni servizio. La prima richiesta include un credito gratuito, che consente di provare gratuitamente; quando il credito è insufficiente, puoi ricaricare il saldo generale nel pannello di controllo.
📘 Documentazione completa: API di verifica dello stato del numero di cellulare →

​
Utilizzo di base

Iniziamo a comprendere il modo di utilizzo di base, che consiste nell’inserire il numero di cellulare per ottenere il risultato elaborato, è necessario semplicemente passare un campo mobile. Possiamo quindi compilare il contenuto corrispondente nell’interfaccia, come mostrato nell’immagine:

Possiamo vedere che qui abbiamo impostato le intestazioni della richiesta, tra cui:
  • accept: il formato della risposta desiderata, qui impostato su application/json, ovvero formato JSON.
  • authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dopo la richiesta.
Inoltre, abbiamo impostato il corpo della richiesta, che include:
  • mobile: il numero di cellulare da elaborare, è un parametro obbligatorio.
  • encryption: opzionale, parametro di crittografia per campi sensibili (se è necessario inviare il testo cifrato).
Dopo aver effettuato la selezione, possiamo notare che a destra è stato generato il codice corrispondente, come mostrato nell’immagine:

Cliccando sul pulsante “Prova” è possibile effettuare un test, come mostrato nell’immagine sopra, qui abbiamo ottenuto il seguente risultato:
Il risultato restituito ha diversi campi, descritti come segue:
  • result, codice del risultato di autenticazione, la situazione di addebito è la seguente.
    • Codici di risultato a pagamento:
      • 0: Successo
    • Codici di risultato non a pagamento:
      • -1: Nessun risultato trovato
      • -2: Formato del numero di cellulare non corretto
      • -3: Servizio del centro di verifica occupato
  • description, descrizione del risultato commerciale.
  • status_code, codice di stato:
    • 0: Normale
    • 1: Disattivato
    • 2: Numero cancellato
    • 3: Numero non valido
    • 4: Non in rete
    • 99: Stato sconosciuto
Possiamo vedere che lo stato di questo numero di cellulare è stato già verificato. Inoltre, se desideri generare il codice di integrazione corrispondente, puoi semplicemente copiarlo, ad esempio il codice CURL è il seguente:
Il codice di integrazione in Python è il seguente:

​
Gestione degli errori

Quando si chiama l’API, se si verifica un errore, l’API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:
  • 400 token_mismatched: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 400 api_not_implemented: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 401 invalid_token: Non autorizzato, token di autorizzazione non valido o mancante.
  • 429 too_many_requests: Troppe richieste, hai superato il limite di frequenza.
  • 500 api_error: Errore interno del server, qualcosa è andato storto sul server.

​
Esempio di risposta di errore

​
Conclusione

Attraverso questo documento, hai appreso come utilizzare l’API di verifica dello stato del numero di cellulare per convalidare lo stato di un numero di cellulare, puoi inserire il numero di cellulare per effettuare la verifica. Speriamo che questo documento possa aiutarti a integrare e utilizzare meglio questa API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.