Com4 IoT API: Zarządzanie kartami SIM i łącznością IoT

Kompleksowa automatyzacja cyklu życia karty SIM

Przejmij programową kontrolę nad całym cyklem życia swoich kart SIM. Od początkowej aktywacji i udostępniania po zawieszenie, ponowną aktywację i ostateczną dezaktywację, możesz zautomatyzować te kluczowe procesy, ograniczając ręczną interwencję i przyspieszając wdrażanie.

Monitorowanie łączności w czasie rzeczywistym

Uzyskaj natychmiastowy, szczegółowy wgląd w stan i zużycie danych przez urządzenia IoT. Nasz interfejs API umożliwia pobieranie danych w czasie rzeczywistym dla każdej karty SIM lub całego konta, umożliwiając proaktywne zarządzanie i kontrolę kosztów.

Usprawnione wdrażanie urządzeń

Uprość i przyspiesz wdrażanie nowych urządzeń IoT. Zautomatyzuj proces rejestracji i konfiguracji, zapewniając, że urządzenia są podłączone i działają z minimalnym opóźnieniem.

Płynna integracja systemu

Zbudowany w oparciu o zasady RESTful, interfejs API Com4 został zaprojektowany z myślą o łatwej integracji. Zarządzanie łącznością IoT można osadzić bezpośrednio w istniejącym oprogramowaniu korporacyjnym, niestandardowych pulpitach nawigacyjnych i operacyjnych przepływach pracy, tworząc ujednolicone środowisko zarządzania.

Bezpieczny i niezawodny dostęp

Bezpieczeństwo jest podstawą naszego API. Korzystając z solidnego przepływu poświadczeń klienta OIDC (OpenID Connect), zapewniamy, że cała komunikacja z API jest uwierzytelniona i bezpieczna, chroniąc cenne dane i integralność urządzenia

Szczegółowa kontrola roamingu

Łatwe zarządzanie i optymalizacja profili roamingowych dla urządzeń rozmieszczonych na całym świecie. Interfejs API zapewnia narzędzia do konfigurowania ustawień roamingu, zapewniając opłacalną i niezawodną łączność wszędzie tam, gdzie działają urządzenia.

Konfigurowalne profile usług

Dostosuj usługi łączności do konkretnych potrzeb różnych typów urządzeń i przypadków użycia. Programowo przypisuj profile usług i zarządzaj nimi w celu optymalizacji wydajności i kosztów.

Skalowalna architektura

Niezależnie od tego, czy zarządzasz setkami, czy milionami urządzeń, interfejs API Com4 jest skalowalny. Nasza architektura została zaprojektowana do obsługi dużej liczby żądań i obsługi rosnącej floty IoT.

Projektowanie zorientowane na deweloperów

Priorytetem jest dla nas doświadczenie dewelopera. Dzięki jasnym, dobrze udokumentowanym punktom końcowym i przestrzeganiu standardowych protokołów, integracja z Com4 API jest prosta, umożliwiając zespołom programistycznym szybkie rozpoczęcie pracy.

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

Podstawowe punkty końcowe API dla rozwiązań IoT

Com4 IoT API oferuje bogaty zestaw punktów końcowych do zarządzania każdym aspektem łączności IoT. Poniżej znajdują się niektóre z podstawowych funkcji, do których można uzyskać dostęp. Aby uzyskać szczegółowe informacje, zapoznaj się z naszą pełną dokumentacją API.
(Uwaga dla deweloperów: Poniżej przedstawiono przykładowe struktury punktów końcowych. Zawsze należy zapoznać się z oficjalną dokumentacją API Com4, aby uzyskać najbardziej aktualne i kompletne definicje punktów końcowych, formaty żądań/odpowiedzi i parametry).

Zarządzanie kontami

GET /accounts: Pobiera listę kont dostępnych dla użytkownika.
GET /accounts/{accountId}: Pobieranie szczegółowych informacji dla określonego konta.
GET /accounts/{accountId}/roaming-profiles: Dostęp i zarządzanie profilami roamingowymi powiązanymi z określonym kontem.

Cykl życia karty SIM i zarządzanie nią

GET /sim-cards: Lista wszystkich kart SIM na koncie lub w określonym zakresie.
GET /sim-cards/{simId}: Pobiera kompleksowe informacje o konkretnej karcie SIM przy użyciu jej unikalnego identyfikatora.
POST /sim-cards/register: Rejestruje nowe karty SIM na koncie użytkownika.
PATCH /sim-cards/{simId}: Aktualizacja różnych atrybutów istniejącej karty SIM.
PUT /sim-cards/{simId}/activate: Programowo aktywuje kartę SIM.
PUT /sim-cards/{simId}/suspend: Tymczasowe zawieszenie subskrypcji karty SIM i dostępu do sieci.
DELETE /sim-cards/{simId}/unsuspend: Ponowna aktywacja wcześniej zawieszonej karty SIM.
DELETE /sim-cards/{simId}: Dezaktywacja lub anulowanie usługi karty SIM.

Wykorzystanie i monitorowanie danych

GET /sim-cards/data-usage: Przegląd wykorzystania danych zagregowanych na wielu kartach SIM.
GET/sim-cards/{simId}/data-usage: Pobieranie konkretnych, szczegółowych informacji o wykorzystaniu danych dla pojedynczej karty SIM.
GET /sim-cards/{simId}/data-sessions: Dostęp do historycznych rekordów sesji danych dla określonej karty SIM.

Konfiguracja usług i profili

GET /sim-cards/{simId}/product: Wyświetlanie bieżącego produktu lub planu usług powiązanego z kartą SIM.
PUT/sim-cards/{simId}/product: Przypisanie lub zmiana produktu lub planu usług dla karty SIM.
GET/sim-cards/{simId}/service-profile: Pobiera przypisany profil usługi dla karty SIM.
PUT/sim-cards/{simId}/service-profile: Ustawia lub aktualizuje profil usługi, dostosowując usługi, takie jak limity danych lub dostęp do sieci.
PUT /sim-cards/{simId}/private-apn: Konfiguracja prywatnej nazwy punktu dostępu (APN) dla karty SIM w celu zwiększenia bezpieczeństwa.
GET/sim-cards/{simId}/private-apn: Sprawdza aktualnie aktywny prywatny profil APN na karcie SIM.

Uwierzytelnianie i autoryzacja

Interfejs API Com4 wykorzystuje przepływ poświadczeń klienta OIDC (OpenID Connect) do bezpiecznego uwierzytelniania serwer-serwer. Zazwyczaj używasz client_id i client_secret, aby uzyskać token dostępu z naszego serwera autoryzacji (np. PUT /v1/clients-registrations/openid-connect/{client_id}), który jest następnie używany do uwierzytelniania żądań API.

Pierwsze kroki z Com4 IoT API

Integracja potężnych rozwiązań łączności Com4 z aplikacjami jest prosta:

1. Poproś o dostęp: Skontaktuj się z naszym zespołem wsparcia (np. [email protected] lub menedżerem konta), aby uzyskać dane uwierzytelniające API (client_id i client_secret).

2. Zapoznaj się z dokumentacją: Zapoznaj się z naszą obszerną dokumentacją API, aby uzyskać szczegółowe opisy punktów końcowych, przykłady żądań/odpowiedzi i najlepsze praktyki.

3.Rozwijaj i integruj: Wykorzystaj preferowany język programowania do wysyłania żądań HTTP do naszych punktów końcowych API. Wykorzystaj nasze rozbudowane funkcje do automatyzacji wdrożeń IoT i zarządzania nimi.

4. Testowanie i wdrażanie: Dokładnie przetestuj swoją integrację w środowisku programistycznym przed wdrożeniem do produkcji.

Zobacz pełną dokumentację API

Żądanie dostępu do API

Earth half small

API zapewnia szeroki zakres funkcji, koncentrując się głównie na zarządzaniu cyklem życia karty SIM (aktywacja, zawieszenie, dezaktywacja), monitorowaniu wykorzystania danych w czasie rzeczywistym, udostępnianiu urządzeń, zarządzaniu kontami, konfiguracji profili usług i konfiguracji prywatnych APN. Pozwala to zautomatyzować wiele ręcznych zadań związanych z zarządzaniem dużą flotą urządzeń IoT.

Aby rozpocząć, zazwyczaj należy skontaktować się z pomocą techniczną Com4 (np. za pośrednictwem [email protected]) lub dedykowanym menedżerem konta. Poprowadzą Cię oni przez proces uzyskiwania niezbędnych danych uwierzytelniających API (identyfikator klienta i sekret klienta) wymaganych do uwierzytelnienia.

Nasz interfejs API wykorzystuje bezpieczny i standardowy przepływ poświadczeń klienta OIDC (OpenID Connect). Polega to na tym, że aplikacja używa identyfikatora klienta i tajnego klucza klienta, aby zażądać tokena dostępu z naszego serwera autoryzacji, który następnie autoryzuje kolejne wywołania API.

Kompleksowa dokumentacja, w tym szczegółowe opisy punktów końcowych, formaty żądań i odpowiedzi, definicje parametrów i przykłady kodu, jest dostępna na portalu deweloperskim Com4 lub może być dostarczona przez nasz zespół wsparcia.

Będąc RESTful API, Com4 IoT API może być zintegrowany przy użyciu praktycznie dowolnego języka programowania, który może wykonywać standardowe żądania HTTP. Obejmuje to popularne języki, takie jak Python, Java, C#, Node.js (JavaScript), Ruby, PHP, Go i wiele innych.

Interfejs API ma kluczowe znaczenie dla skalowalności, umożliwiając automatyzację. Można programowo zarządzać tysiącami lub milionami kart SIM i urządzeń, automatyzować procesy udostępniania, masowo monitorować wzorce użytkowania i integrować te kontrole z własnymi skalowalnymi systemami zarządzania, znacznie zmniejszając wysiłek ręczny i koszty operacyjne.

Tak, wiele punktów końcowych API jest zaprojektowanych do obsługi operacji zbiorczych lub może być skutecznie iterowanych w celu zarządzania dużą liczbą kart SIM jednocześnie, takich jak aktywacja zbiorcza lub aktualizacje statusu. Szczegółowe informacje na temat możliwości przetwarzania wsadowego można znaleźć w dokumentacji konkretnego punktu końcowego.

Chociaż bezpośrednie informacje webhook nie są tutaj wyszczególnione, wiele zaawansowanych platform IoT oferuje powiadomienia sterowane zdarzeniami. Zapoznaj się z pełną dokumentacją API lub skontaktuj się z naszą pomocą techniczną, aby zapytać o możliwości webhook dla zdarzeń takich jak progi limitu danych lub zmiany statusu karty SIM.

Aby zapewnić uczciwe użytkowanie i stabilność dla wszystkich użytkowników, nasz interfejs API może mieć limity szybkości. Szczegółowe informacje na temat limitów szybkości (żądań na sekundę/minutę) można znaleźć w oficjalnej dokumentacji API lub kontaktując się z naszym zespołem pomocy technicznej.

Wersjonowanie API jest zarządzane w celu zapewnienia kompatybilności wstecznej tam, gdzie to możliwe i jasnych ścieżek aktualizacji do nowych wersji. Szczegóły dotyczące bieżącej wersji i strategii wersjonowania zostaną przedstawione w dokumentacji API.

Porozmawiaj z
ekspert

Odblokuj drogę do lepszej przyszłości dzięki naszym niezrównanym rozwiązaniom IoT i wsparciu. Nawiąż z nami współpracę już dziś i utoruj sobie drogę do sukcesu.

Wzmocnij swoje aplikacje IoT dzięki funkcjom Com4 API