Com4 IoT API: Gestione SIM e monitoraggio connettività IoT

Automazione completa del ciclo di vita delle SIM

Controllate in modo programmatico l'intero ciclo di vita delle vostre carte SIM. Dall'attivazione iniziale e dal provisioning alla sospensione, alla riattivazione e all'eventuale disattivazione, potete automatizzare questi processi cruciali, riducendo gli interventi manuali e accelerando la distribuzione.

Monitoraggio della connettività in tempo reale

Ottenete informazioni istantanee e granulari sullo stato e sul consumo di dati dei vostri dispositivi IoT. La nostra API consente di ottenere l'utilizzo dei dati in tempo reale per SIM o per l'intero account, consentendo una gestione proattiva e il controllo dei costi.

Provisioning semplificato dei dispositivi

Semplificate e accelerate l'onboarding di nuovi dispositivi IoT. Automatizzate il processo di registrazione e configurazione, assicurando che i vostri dispositivi siano connessi e operativi con il minimo ritardo.

Integrazione perfetta del sistema

Basata sui principi RESTful, l'API di Com4 è progettata per una facile integrazione. La gestione della connettività IoT può essere integrata direttamente nel software aziendale esistente, nei cruscotti personalizzati e nei flussi di lavoro operativi, creando un'esperienza di gestione unificata.

Accesso sicuro e affidabile

La sicurezza è al centro della nostra API. Utilizzando il robusto flusso di credenziali client OIDC (OpenID Connect), garantiamo che tutte le comunicazioni con l'API siano autenticate e sicure, proteggendo i vostri dati preziosi e l'integrità del dispositivo.

Controllo granulare del roaming

Gestite e ottimizzate senza problemi i profili di roaming per i vostri dispositivi distribuiti a livello globale. L'API fornisce gli strumenti per configurare le impostazioni di roaming, assicurando una connettività conveniente e affidabile ovunque i vostri dispositivi operino.

Profili di servizio personalizzabili

Adattate i servizi di connettività alle esigenze specifiche di diversi tipi di dispositivi e casi d'uso. Assegnate e gestite i profili di servizio in modo programmatico per ottimizzare prestazioni e costi.

Architettura scalabile

Che si tratti di gestire centinaia o milioni di dispositivi, l'API di Com4 è costruita per scalare. La nostra architettura è progettata per gestire un grande volume di richieste e supportare la vostra flotta IoT in crescita.

Design incentrato sullo sviluppatore

Diamo priorità all'esperienza degli sviluppatori. Grazie a endpoint chiari e ben documentati e all'aderenza ai protocolli standard, l'integrazione con l'API Com4 è semplice e consente ai team di sviluppo di essere rapidamente operativi.

API code zoomed in on a laptop in a dark room with small focus depth.

Endpoint API fondamentali per le vostre soluzioni IoT

L'API IoT di Com4 offre una ricca serie di endpoint per gestire ogni aspetto della connettività IoT. Di seguito sono riportate alcune delle funzionalità principali a cui è possibile accedere. Per i dettagli completi, consultare la documentazione completa dell'API.
(Nota per gli sviluppatori: i seguenti sono esempi di strutture di endpoint. Per le definizioni più aggiornate e complete degli endpoint, i formati di richiesta/risposta e i parametri, consultare sempre la documentazione ufficiale dell'API Com4).

Gestione degli account

GET /conti: Recupera l'elenco degli account accessibili all'utente.
GET /accounts/{accountId}: Recupera informazioni dettagliate per un account specifico.
GET /accounts/{accountId}/roaming-profiles: Accesso e gestione dei profili di roaming associati a un determinato account.

Gestione e ciclo di vita della carta SIM

GET /sim-cards: Elenca tutte le schede SIM dell'account o di un ambito specifico.
GET /sim-cards/{simId}: Recupera informazioni complete su una specifica scheda SIM utilizzando il suo identificativo univoco.
POST /sim-cards/register: Registra nuove schede SIM sul proprio account.
PATCH /sim-cards/{simId}: Aggiorna vari attributi di una carta SIM esistente.
PUT /sim-cards/{simId}/activate: Attiva programmaticamente una carta SIM.
PUT /sim-cards/{simId}/suspend: Sospende temporaneamente l'abbonamento e l'accesso alla rete di una carta SIM.
DELETE /sim-cards/{simId}/unsuspend: Riattiva una carta SIM precedentemente sospesa.
CANCELLA /sim-cards/{simId}: Disattiva o cancella il servizio di una carta SIM.

Utilizzo e monitoraggio dei dati

GET /sim-cards/data-usage: Ottenere una panoramica dell'utilizzo dei dati aggregati su più schede SIM.
GET/sim-cards/{simId}/data-usage: Recupera informazioni specifiche e dettagliate sull'utilizzo dei dati per una singola scheda SIM.
GET/sim-cards/{simId}/data-sessions: Accede ai record storici delle sessioni di dati di una particolare carta SIM.

Configurazione di servizi e profili

GET /sim-cards/{simId}/product: Visualizza il prodotto o il piano di servizio corrente associato a una carta SIM.
PUT/sim-cards/{simId}/product: Assegna o modifica il prodotto o il piano di servizio di una carta SIM.
GET/sim-cards/{simId}/service-profile: Recupera il profilo di servizio assegnato a una carta SIM.
PUT/sim-cards/{simId}/service-profile: Imposta o aggiorna il profilo di servizio, personalizzando servizi come i limiti di dati o l'accesso alla rete.
PUT/sim-cards/{simId}/private-apn: Configura un nome di punto di accesso (APN) privato per una carta SIM per una maggiore sicurezza.
GET/sim-cards/{simId}/private-apn: Controlla il profilo APN privato attualmente attivo su una scheda SIM.

Autenticazione e autorizzazione

L'API Com4 utilizza il flusso di credenziali client OIDC (OpenID Connect) per l'autenticazione sicura da server a server. In genere si utilizzano client_id e client_secret per ottenere un token di accesso dal nostro server di autorizzazione (ad esempio, PUT /v1/clients-registrations/openid-connect/{client_id}), che viene poi utilizzato per autenticare le richieste API.

Come iniziare con l'API IoT di Com4

L'integrazione delle potenti soluzioni di connettività di Com4 nelle vostre applicazioni è semplice:

1. Richiedere l'accesso: Contattare il nostro team di assistenza (ad esempio, [email protected] o il vostro account manager) per ottenere le credenziali API (client_id e client_secret).

2. Consultare la documentazione: Consultate la nostra documentazione API completa per trovare descrizioni dettagliate degli endpoint, esempi di richieste/risposte e best practice.

3.Sviluppare e integrare: Utilizzate il vostro linguaggio di programmazione preferito per effettuare richieste HTTP ai nostri endpoint API. Sfruttate le nostre solide funzionalità per automatizzare e gestire le vostre implementazioni IoT.

4. Test e distribuzione: Testate accuratamente l'integrazione in un ambiente di sviluppo prima di distribuirla in produzione.

Visualizza la documentazione API completa

Richiesta di accesso all'API

Earth half small

L'API fornisce un'ampia gamma di funzionalità, principalmente incentrate sulla gestione del ciclo di vita della SIM (attivazione, sospensione, disattivazione), sul monitoraggio dell'utilizzo dei dati in tempo reale, sul provisioning dei dispositivi, sulla gestione degli account, sulla configurazione dei profili di servizio e sull'impostazione di APN privati. Consente di automatizzare molte delle attività manuali associate alla gestione di un ampio parco di dispositivi IoT.

Per iniziare, in genere è necessario contattare il supporto Com4 (ad esempio, tramite [email protected]) o il proprio account manager dedicato. Questi vi guideranno nel processo di ottenimento delle credenziali API necessarie (ID cliente e segreto cliente) per l'autenticazione.

La nostra API utilizza il flusso di credenziali client OIDC (OpenID Connect), sicuro e standard del settore. Ciò comporta che l'applicazione utilizzi un ID e un segreto del cliente per richiedere un token di accesso al nostro server di autorizzazione, che autorizza le chiamate API successive.

Una documentazione completa, che include descrizioni dettagliate degli endpoint, formati di richiesta e risposta, definizioni dei parametri ed esempi di codice, è disponibile sul portale degli sviluppatori Com4 o può essere fornita dal nostro team di supporto. (L'ideale sarebbe un link diretto).

Essendo un'API RESTful, l'API Com4 IoT può essere integrata utilizzando praticamente qualsiasi linguaggio di programmazione in grado di effettuare richieste HTTP standard. Ciò include linguaggi popolari come Python, Java, C#, Node.js (JavaScript), Ruby, PHP, Go e molti altri.

L'API è fondamentale per la scalabilità, in quanto consente l'automazione. È possibile gestire in modo programmatico migliaia o milioni di SIM e dispositivi, automatizzare i processi di provisioning, monitorare i modelli di utilizzo in massa e integrare questi controlli nei propri sistemi di gestione scalabili, riducendo in modo significativo lo sforzo manuale e i costi operativi.

Sì, molti endpoint API sono progettati per supportare operazioni in blocco o possono essere iterati in modo efficiente per gestire un gran numero di schede SIM contemporaneamente, come l'attivazione in blocco o gli aggiornamenti di stato. Per maggiori dettagli sulle capacità di elaborazione in batch, consultare la documentazione dell'endpoint specifico.

Sebbene le informazioni dirette sui webhook non siano dettagliate in questa sede, molte piattaforme IoT avanzate offrono notifiche guidate dagli eventi. Si prega di consultare la documentazione completa dell'API o di contattare il nostro supporto per richiedere informazioni sulle funzionalità webhook per eventi quali soglie di limiti di dati o cambiamenti di stato della SIM.

Per garantire un utilizzo equo e la stabilità di tutti gli utenti, la nostra API può avere dei limiti di velocità. Informazioni specifiche sui limiti di velocità (richieste al secondo/minuto) sono disponibili nella documentazione ufficiale dell'API o contattando il nostro team di assistenza.

Il versioning dell'API è gestito in modo da garantire la retrocompatibilità, ove possibile, e chiari percorsi di aggiornamento alle nuove versioni. I dettagli sulla versione corrente e su qualsiasi strategia di versioning saranno illustrati nella documentazione dell'API.

Potenziate le vostre applicazioni IoT con le funzioni API di Com4