Przejdź do treści

Sprawdź status wiadomości

Śledź status dostarczenia wiadomości za pomocą punktu końcowego sprawdzania stanu.

Punkt końcowy

KOD_BLOKU_0

Żądanie

Parametry adresu URL

Parametr Wpisz Wymagane Opis
Identyfikator wiadomości ciąg Tak Unikalny identyfikator wiadomości z odpowiedzi na wysłanie

Uwierzytelnianie

Użyj dowolnej z trzech metod uwierzytelniania:

=== „Nagłówek klucza API”

__KOD_BLOKU_1__

=== „Podstawowe uwierzytelnianie HTTP”

__KOD_BLOKU_2__

=== „Klucz API jako hasło”

__KOD_BLOKU_3__

Odpowiedź

Podstawowa odpowiedź

KOD_BLOKU_4

Pola odpowiedzi

Pole Wpisz Opis
Identyfikator listy wiadomości liczba całkowita Identyfikator partii
Identyfikator wiadomości ciąg Unikalny identyfikator wiadomości
status dostawy ciąg Aktualny status dostawy
liczba części liczba całkowita Liczba części wiadomości
„koszt” numer Koszt wiadomości w jednostkach walutowych

Rozszerzona odpowiedź (z rezerwą)

Jeśli skonfigurowano rezerwę, odpowiedź zawiera dodatkowe pola:

KOD_BLOKU_5

Wartości stanu dostawy

Stan Opis
„zaplanowane” W kolejce do wysłania
„przetwarzanie” Obecnie wysyłane
„dostarczone” Dostarczono pomyślnie
„niedostarczalne” Dostawa nie powiodła się, wiadomość odrzucona
stały błąd Usunięto z kolejki z powodu utrzymującego się błędu

Cykl życia stanu

KOD_BLOKU_6

Zaplanowane

Wiadomość została zaakceptowana i umieszczona w kolejce do dostarczenia:

KOD_BLOKU_7

Przetwarzanie

Wiadomość jest obecnie wysyłana do odbiorcy:

KOD_BLOKU_8

Dostarczono

Wiadomość pomyślnie dostarczona do odbiorcy:

KOD_BLOKU_9

Niemożliwe do dostarczenia

Wiadomość nie mogła zostać dostarczona (nieprawidłowy numer, błąd sieci):

KOD_BLOKU_10

Stały błąd

Wiadomość usunięta z kolejki z powodu utrzymujących się problemów z dostarczaniem:

KOD_BLOKU_11

Sprawdź wiele wiadomości

Sprawdź status wielu wiadomości w swojej aplikacji:

KOD_BLOKU_12

Odpytywanie o aktualizacje statusu

Odpytuj punkt końcowy stanu, aby śledzić dostawę:

KOD_BLOKU_13

Alternatywa dla webhooka

Zamiast odpytywać, używaj webhooków do aktualizacji statusu w czasie rzeczywistym:

KOD_BLOKU_14

Skontaktuj się ze swoim menedżerem konta, aby skonfigurować adres URL webhooka.

Przykłady implementacji

Pythona

KOD_BLOKU_15

PHP

KOD_BLOKU_16

Node.js

KOD_BLOKU_17

Najlepsze praktyki

Częstotliwość odpytywania

  • ✅ Ankieta co 5-10 sekund
  • ✅ Wprowadź wykładnicze wycofywanie
  • ✅ Ustaw rozsądny limit czasu (60-120 sekund)
  • ❌ Nie odpytuj częściej niż raz na sekundę
  • ❌ Nie odpytuj w nieskończoność

Obsługa błędów

KOD_BLOKU_18

Buforowanie

Wyniki stanu pamięci podręcznej w celu ograniczenia wywołań API:

KOD_BLOKU_19

Przetwarzanie wsadowe

Podczas sprawdzania wielu wiadomości żądania zbiorcze:

KOD_BLOKU_20

Przypadki użycia

Potwierdzenie zamówienia

Śledź dostarczanie wiadomości z potwierdzeniem zamówienia:

KOD_BLOKU_21

Uwierzytelnianie dwuskładnikowe

Sprawdź dostawę OTP przed upływem limitu czasu:

KOD_BLOKU_22

Kampanie marketingowe

Śledź współczynniki dostarczania komunikatów kampanii:

KOD_BLOKU_23

Następne kroki