Com4 Logo
Aloita
Kehittäjä

Anna IoT-sovelluksille mahdollisuus Com4:n API-toiminnoilla

IoT API:mme on suunniteltu tarjoamaan kattavaa hallintaa ja joustavuutta, jonka avulla voit räätälöidä IoT-yhdistettävyyden liiketoimintasi tarpeisiin. Tutustu tehokkaisiin ominaisuuksiin, jotka virtaviivaistavat toimintojasi:

Pyydä API-yhteyttä
Sim 1

Kattava SIM-elinkaaren automatisointi

Hallitse ohjelmallisesti SIM-korttien koko elinkaarta. Voit automatisoida nämä tärkeät prosessit ensimmäisestä aktivoinnista ja käyttöönotosta keskeytykseen, uudelleenaktivointiin ja lopulta deaktivointiin, mikä vähentää manuaalisia toimenpiteitä ja nopeuttaa käyttöönottoa.

Seuranta

Yhdistettävyyden reaaliaikainen valvonta

Saat välittömästi yksityiskohtaista tietoa IoT-laitteiden tilasta ja datankulutuksesta. API:mme avulla voit hakea reaaliaikaisen datankäytön SIM-kohtaisesti tai koko tilisi osalta, mikä mahdollistaa ennakoivan hallinnan ja kustannusten valvonnan.

Huolto

Virtaviivaistettu laitteiden käyttöönotto

Yksinkertaista ja nopeuta uusien IoT-laitteiden käyttöönottoa. Automatisoi rekisteröinti- ja määritysprosessi ja varmista, että laitteesi ovat yhteydessä ja toiminnassa mahdollisimman pienellä viiveellä.

Tietopaketti

Saumaton järjestelmäintegraatio

RESTful-periaatteiden pohjalta rakennettu Com4:n API on suunniteltu helppoa integrointia varten. Sulauta IoT-yhdistettävyyden hallinta suoraan olemassa oleviin yritysohjelmistoihin, mukautettuihin hallintapaneeleihin ja operatiivisiin työnkulkuihin, mikä luo yhtenäisen hallintakokemuksen.

Kannettavan tietokoneen lukitus

Turvallinen ja luotettava käyttö

Turvallisuus on API:n ydin. Käyttämällä vankkaa OIDC (OpenID Connect) -asiakkaan tunnistetietojen virtaa varmistamme, että kaikki API:n kanssa tapahtuva viestintä on todennettua ja turvallista, mikä suojaa arvokkaita tietojasi ja laitteesi eheyttä.

Sim

Granulaarinen verkkovierailun hallinta

Hallinnoi ja optimoi vaivattomasti globaalisti käytössä olevien laitteidesi verkkovierailuprofiileja. API tarjoaa työkalut verkkovierailuasetusten määrittämiseen, mikä takaa kustannustehokkaan ja luotettavan yhteyden kaikkialla.

Valvonta

Mukautettavat palveluprofiilit

Räätälöi yhteyspalvelut eri laitetyyppien ja käyttötapausten mukaan. Määritä ja hallinnoi palveluprofiileja ohjelmallisesti suorituskyvyn ja kustannusten optimoimiseksi.

Skaalautuva

Skaalautuva arkkitehtuuri

Com4:n API on suunniteltu skaalautuvaksi riippumatta siitä, hallinnoitko satoja vai miljoonia laitteita. Arkkitehtuurimme on suunniteltu käsittelemään suurta määrää pyyntöjä ja tukemaan kasvavaa IoT-kalustoa.

Koodi

Kehittäjäkeskeinen suunnittelu

Asetamme kehittäjäkokemuksen etusijalle. Selkeiden, hyvin dokumentoitujen päätepisteiden ja standardiprotokollien noudattamisen ansiosta integrointi Com4 API:n kanssa on suoraviivaista, joten kehitystiimisi voivat aloittaa toimintonsa nopeasti.

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

 

IoT-ratkaisujesi keskeiset API-päätepisteet

Com4:n IoT API tarjoaa laajan valikoiman päätepisteitä IoT-yhteyksien kaikkien osa-alueiden hallintaan. Alla on lueteltu joitakin keskeisiä käytettäviä toimintoja. Täydelliset yksityiskohdat löytyvät täydellisestä API-dokumentaatiostamme.
(Kehittäjän huomautus: Seuraavassa on esimerkkejä päätepisteiden rakenteista. Tutustu aina Com4 API:n viralliseen dokumentaatioon, josta löydät ajantasaisimmat ja täydellisimmät päätepisteiden määritelmät, pyyntö-/vastausmuodot ja parametrit).

Tilinhallinta

GET /accounts: Hae luettelo tileistä, joihin sinulla on pääsy.
GET /accounts/{accountId}: Hae yksityiskohtaiset tiedot tietystä tilistä.
GET /accounts/{accountId}/roaming-profiilit: Siirry tiettyyn tiliin liittyviin verkkovierailuprofiileihin ja hallinnoi niitä.

SIM-kortin elinkaari ja hallinta

GET /sim-kortit: Luetteloi kaikki tilisi tai määritetyn laajuuden sisällä olevat SIM-kortit.
GET /sim-cards/{simId}: Hae kattavat tiedot tietystä SIM-kortista sen yksilöllisen tunnisteen avulla.
POST /sim-cards/register: Rekisteröi uusia SIM-kortteja tilillesi.
PATCH /sim-cards/{simId}: Päivitä olemassa olevan SIM-kortin eri ominaisuuksia.
PUT /sim-cards/{simId}/activate: Aktivoi SIM-kortti ohjelmallisesti.
PUT /sim-cards/{simId}/suspend: Keskeytä tilapäisesti SIM-kortin tilaus ja verkkoyhteys.
DELETE /sim-cards/{simId}/unsuspend: Aktivoi aiemmin keskeytetty SIM-kortti uudelleen.
DELETE /sim-cards/{simId}: Deaktivoi tai peruuta SIM-kortin palvelu.

Datankäyttö ja seuranta

GET /sim-cards/data-usage: Hanki yleiskuva useiden SIM-korttien  datankäytöstä.
GET /sim-cards/{simId}/data-usage: Hae yksittäisen SIM-kortin yksityiskohtaiset datankäyttötiedot.
GET /sim-cards/{simId}/data-sessions: Siirry tietyn SIM-kortin historiallisiin dataistuntotietoihin.

Palvelun ja profiilin määritys

GET /sim-cards/{simId}/product: Näytä SIM-korttiin liittyvä nykyinen tuote tai palvelusuunnitelma.
PUT /sim-cards/{simId}/product: Määritä tai muuta SIM-kortin tuote- tai palvelusuunnitelmaa.
GET /sim-cards/{simId}/service-profile: Hae SIM-kortille määritetty palveluprofiili.
PUT /sim-cards/{simId}/service-profile: Aseta tai päivitä palveluprofiili, jolla räätälöidään palveluita, kuten datarajoituksia tai verkkoyhteyttä.
PUT /sim-cards/{simId}/private-apn: Määritä SIM-kortin yksityinen APN (Access Point Name) turvallisuuden parantamiseksi.
GET /sim-cards/{simId}/private-apn: Tarkista SIM-kortin tällä hetkellä aktiivinen yksityinen APN-profiili.

Todentaminen ja valtuutus

Com4 API käyttää OIDC (OpenID Connect) -asiakkaan tunnistetietojen virtaa turvalliseen, palvelimelta toiselle tapahtuvaan todennukseen. Käytät tyypillisesti client_id- ja client_secret-tunnuksia saadaksesi valtuutuspalvelimeltamme käyttöoikeustunnisteen (esim. PUT /v1/clients-registrations/openid-connect/{client_id}), jota käytetään sitten API-pyyntöjesi todentamiseen.

 

Com4 IoT API:n käytön aloittaminen

Com4:n tehokkaiden yhteysatkaisujen integroiminen sovelluksiisi on helppoa:

1. Pyydä käyttöoikeutta: Ota yhteyttä tukitiimiimme (esim. [email protected] tai tilinhoitajasi) saadaksesi API-tunnuksesi (client_id ja client_secret).

2. Tutustu dokumentaatioon: Lue kattava API-dokumentaatiomme, josta löydät yksityiskohtaisia päätepisteiden kuvauksia, pyyntö-/vastausesimerkkejä ja parhaita käytäntöjä.

3.Kehitä ja integroi: Käytä haluamaasi ohjelmointikieltä tehdessäsi HTTP-pyyntöjä API-päätepisteisiimme. Hyödynnä vankkoja toimintojamme IoT-käyttöönottojen automatisointiin ja hallintaan.

4. Testaa ja ota käyttöön: Testaa integrointisi perusteellisesti kehitysympäristössä ennen käyttöönottoa tuotantoa varten.

Näytä koko API-dokumentaatio.

Pyydä API-yhteyttä

Earth half small

Kysyttävää Com4 IoT API:sta

Seuraavassa on joitakin yleisiä kysymyksiä, joita kehittäjät ja yritykset kysyvät Com4 IoT API:n hyödyntämisestä:

Mitä toimintoja Com4:n IoT API tarjoaa?

API tarjoaa laajan valikoiman toimintoja, jotka keskittyvät ensisijaisesti SIM-kortin elinkaaren hallintaan (aktivointi, keskeyttäminen, deaktivointi), reaaliaikaiseen datankäytön seurantaan, laitteen käyttöön, tilinhallintaan, palveluprofiilin konfigurointiin ja yksityisen APN-tunnuksen määrittämiseen. Sen avulla voit automatisoida monia manuaalisia tehtäviä liittyen suuren IoT-laitekannan hallintaan.

Miten voin aloittaa Com4 API:n käytön? Mihin vaiheisiin minun täytyy ryhtyä?

Alkuun pääsemiseksi sinun on yleensä otettava yhteyttä Com4:n tukeen (esimerkiksi osoitteeseen [email protected]) tai omaan tilinhoitajaasi. He opastavat sinut prosessin läpi, jotta voit hankkia tarvittavat API-tunnukset (asiakastunnus ja asiakassalaisuus), joita tarvitaan todennukseen.

Mitä todennusmekanismia Com4 API käyttää?

API:mme käyttää turvallista ja teollisuusstandardin mukaista OIDC (OpenID Connect) -asiakkaan tunnistetietojen virtaa. Sovelluksesi käyttää asiakastunnusta ja asiakassalaisuutta pyytääkseen valtuutuspalvelimeltamme käyttöoikeustunnuksen, joka sitten valtuuttaa myöhemmät API-kutsusi.

Mistä löydän yksityiskohtaisen dokumentaation kaikista Com4 API-päätepisteistä?

Kattava dokumentaatio, mukaan lukien yksityiskohtaiset päätepisteiden kuvaukset, pyyntö- ja vastausmuodot, parametrimääritelmät ja koodiesimerkit, on saatavilla Com4-kehittäjäportaalissa tai tukitiimimme kautta.

Mitkä ohjelmointikielet ovat yhteensopivia Com4 REST API:n kanssa?

Koska Com4 IoT API on RESTful API, se voidaan integroida käytännössä millä tahansa ohjelmointikielellä, jolla voidaan tehdä tavallisia HTTP-pyyntöjä. Tähän kuuluvat suositut kielet, kuten Python, Java, C#, Node.js (JavaScript), Ruby, PHP, Go ja monet muut.

Miten Com4 API auttaa suurten IoT-käyttöönottojen skaalaamisessa?

API on tärkeä skaalautuvuuden kannalta, sillä se mahdollistaa automaation. Voit hallita ohjelmallisesti tuhansia tai miljoonia SIM-kortteja ja laitteita, automatisoida käyttöönottoprosesseja, valvoa käyttötapoja massoittain ja integroida nämä valvontatoiminnot omiin skaalautuviin hallintajärjestelmiisi, mikä vähentää merkittävästi manuaalista työtä ja operatiivisia kustannuksia.

Voinko suorittaa SIM-korttien massatoimintoja API:n avulla?

Kyllä, monet API-päätepisteet on suunniteltu tukemaan massatoimintoja tai niitä voidaan käyttää tehokkaasti, kun halutaan hallita suuria määriä SIM-kortteja samanaikaisesti, kuten aktivointi tai tilapäivitykset. Lisätietoja eräkäsittelyominaisuuksista on kyseisen päätepisteen dokumentaatiossa.

Tarjoaako API reaaliaikaisia ilmoituksia tai webhookeja tapahtumia varten?

Vaikka suoria webhook-tietoja ei olekaan esitelty tässä yksityiskohtaisesti, monet kehittyneet IoT-alustat tarjoavat tapahtumapohjaisia ilmoituksia. Tutustu API:n täydelliseen dokumentaatioon tai ota yhteyttä asiakaspalveluumme tiedustellaksesi webhook-ominaisuuksia tapahtumille, kuten datarajojen raja-arvoille tai SIM-kortin tilan muutoksille.

Mistä API-rajoituksista minun pitäisi olla tietoinen?

Varmistaaksemme oikeudenmukaisen käytön ja vakauden kaikille käyttäjille API:lla voi olla nopeusrajoituksia. Tarkempia tietoja nopeusrajoituksista (pyynnöt sekunnissa/minuutissa) saat API:n virallisesta dokumentaatiosta tai ottamalla yhteyttä tukitiimiimme.

Miten Com4 käsittelee API-versiointia?

API-versiointia hallinnoidaan siten, että varmistetaan mahdollisuuksien mukaan taaksepäin yhteensopivuus ja selkeät reitit uusiin versioihin päivittämistä varten. Yksityiskohtaiset tiedot nykyisestä versiosta ja mahdollisesta versiointistrategiasta esitetään API:n dokumentaatiossa.
IoT Communication Expert - Eivind Bøe
IoT Communication Expert - Eivind Bøe

Puhu
asiantuntijalle

Avaa tie valoisampaan tulevaisuuteen verrattomien IoT-ratkaisujemme ja -tukemme avulla. Tee yhteistyötä kanssamme jo tänään ja tasoita tie menestykseen.