HarborOrganizacjaPrzestrzenie roboczeProdukcjaSandbox
Agent wysyłki
Klucz API · Zespół operacji klientaALAlex Lee AdministratorZaktualizowano uprawnienia
Wbuduj dane mobilne w swoją aplikację.
Użyj eSIM API, aby odkrywać oferty danych, kupować pakiety i dostarczać prywatne linki instalacyjne ze swojej aplikacji. Pozwól klientom pozostać w Twoim własnym interfejsie konta, gdzie zobaczą raportowane salda, kompatybilne doładowania i zakupy cykliczne, jeśli są dostępne.
Zacznij od dostępnych ofert.
Użyj klucza API po stronie serwera z uprawnieniem do odczytu eSIM, aby przeglądać katalog. Ten przykład wyświetla oferty bez kupowania pakietu.
1
bird esim offers listOd oferty do zamówienia
Zamień ofertę w odtwarzalny zakup.
Sprawdź zasięg, limit danych i ważność oferty, a następnie pobierz aktualną cenę zamówienia. Zakup jest finansowany z portfela Twojej organizacji. Zapisz wynikowe zamówienie, aby klient mógł do niego wrócić, podczas gdy Bird udostępnia eSIM i pakiet danych.
Przedstaw zaakceptowane warunki
Wyślij zaakceptowaną wersję oferty i cenę wraz z zamówieniem. Jeśli warunki zmienią się przed zakupem, pokaż zaktualizowaną wycenę do akceptacji. Zakupy cykliczne mają własne dostępne warunki i harmonogram.
Odzyskaj bez kolejnego zakupu
Zapisz klucz idempotentności przed utworzeniem zamówienia i użyj go ponownie z tym samym żądaniem, jeśli odpowiedź zostanie przerwana. Jeśli masz ID zamówienia, najpierw odczytaj to zamówienie, aby sprawdzić, czy zostało ukończone.
Hostowana instalacja
Wyślij konfigurację, którą klient może otworzyć.
Po ukończeniu zamówienia utwórz hostowany link instalacyjny lub wyślij go e-mailem lub przez SMS. Klient otwiera instrukcje dopasowane do urządzenia bez logowania się do obszaru roboczego Bird. Śledź dostarczenie wiadomości oddzielnie od instalacji i pierwszego połączenia z danymi mobilnymi.
Kontroluj dostęp do instalacji
Poświadczenia instalacyjne korzystają z osobnych uprawnień API. Sprawdź datę wygaśnięcia hostowanego linku i unieważnij go, jeśli trafi do niewłaściwej osoby. Unieważnienie linku blokuje przyszły dostęp przez niego; nie dezaktywuje profilu, który został już zainstalowany.
Odczytuj salda pakietów
Wyświetlaj zakupiony limit, datę wygaśnięcia i raportowane zużycie z czasem obserwacji. Gdy dane o zużyciu są niedostępne, pozostaw je jako nieznane, aby klienci mogli odróżnić limit pakietu od zmierzonego salda pozostałego.
Bieżące zakupy
Pozwól klientom dodawać dane do tej samej karty eSIM.
Wyświetl kompatybilne oferty dla istniejącej karty eSIM przed przedstawieniem doładowania. Ukończone doładowanie dodaje pakiet do zainstalowanego profilu, więc klient może dalej korzystać z tej karty eSIM bez kolejnej instalacji.
Zaplanuj pakiety cykliczne
Jeśli oferta wspiera odnowienie, przypisz osobę korzystającą z eSIM i zaakceptuj cenę cykliczną oraz kadencję. Śledź płatność i dostarczenie pakietu w każdym okresie i pozwól klientowi zatrzymać przyszłe odnowienia.
Zachowaj dostęp klienta w swojej aplikacji
Uwierzytelniaj swoich klientów i autoryzuj dostęp do ich własnych zamówień i kart eSIM. Klucz API obszaru roboczego może uzyskiwać dostęp do zasobów wielu klientów, więc przechowuj go na swoim serwerze i łącz każdy zasób z właściwym kontem.
Pytania o API eSIM
Co mogę zbudować z eSIM API?
Wbuduj w swoją aplikację odkrywanie ofert, zakup pakietów danych, dostarczanie instalacji i bieżące zarządzanie pakietami. Klienci mogą kupować kompatybilne doładowania i zapisywać się na zakupy cykliczne, jeśli są dostępne. Twoja aplikacja odpowiada za uwierzytelnianie klientów i wszelkie pobierane od nich płatności.
Czego potrzebuję, żeby dokonać zakupu?
Potrzebujesz obszaru roboczego Bird, klucza API po stronie serwera z wymaganymi uprawnieniami eSIM oraz środków w portfelu organizacji. Przed zakupem sprawdź ofertę, warunki zamówienia i wymagania identyfikacyjne. Odczyt poświadczeń oraz tworzenie lub wysyłanie linków instalacyjnych wymaga osobnych uprawnień do poświadczeń.
Jak obsłużyć przerwaną odpowiedź na zakup?
Odczytaj istniejące zamówienie, jeśli masz jego ID. W przeciwnym razie powtórz zapisane żądanie tworzenia z oryginalnym kluczem idempotentności. Doprowadź to zamówienie do zakończenia lub niepowodzenia, zanim utworzysz nowe, które mogłoby spowodować kolejne obciążenie.
Czy ukończone zamówienie oznacza, że klient jest online?
Ukończone zamówienie identyfikuje zakupioną kartę eSIM i pakiet. Klient nadal musi zainstalować profil na kompatybilnym urządzeniu i przetestować dane mobilne w obsługiwanej lokalizacji. Raporty o instalacji i saldzie mogą nadejść po wyniku z urządzenia.
Połącz pełną usługę
Instalacja eSIMPomóż klientom zainstalować eSIM na urządzeniu i połączyć się dzięki przejrzystym instrukcjom.Zużycie i doładowaniaPokaż dostępny pakiet i datę wygaśnięcia, a następnie zaproponuj kompatybilne dodatkowe dane.Operacje łącznościRozwiązuj problemy z zakupem, instalacją i pakietami na podstawie istniejących rekordów serwisowych.Biblioteka zasobów eSIMPrzeglądaj praktyczne przewodniki, objaśnienia i dokumentację techniczną.
Skaluj bez
utraty kontroli.
Organizuj zespoły w obszarach roboczych, kontroluj dostęp do API i śledź zmiany w logach audytu.
HarborOrganizacjaAktywne
Dziennik audytu
Produkcja- Przestrzeń robocza
- Produkcja
- Zasób
- Agent wysyłki
- Dostęp do odczytuOdczyt i zapis
Zespół Operacje klientaRola wykonawcy AdministratorWynik PowodzenieCzas 22 wrz, 09:42:18 UTC
Powodzenie