Dokumentacja REST API
API REST dla SMS i MMS
Wysyłaj zatwierdzone wiadomości aplikacji oraz obsługuj przyjęcie, zdarzenia dostarczenia, segmentację i opłaty.
Wybierz API i poświadczenie razem
Zatwierdzone konta dla programistów i automatyzacji, firm oraz dostawców usług komunikacyjnych mogą integrować włączone usługi. Indywidualny programista nie musi udawać firmy. SMS/MMS wysyłane przez aplikacje wymagają odpowiedniej zgody na wysyłkę i rejestracji. Usługa dla osób prywatnych i rodzin nie udostępnia klientom API do inicjowania wysyłki wiadomości.
| Rodzina API | Bazowy adres URL | Uwierzytelnianie i wynik |
|---|---|---|
| Komunikacja v3 | https://api.multitel.net/v3 | Zatwierdzone poświadczenia Basic; kwalifikujące się udostępnione tokeny tylko dla operacji, które je obsługują. JSON status i response. |
| Rejestracja numerów alarmowych | https://api.multi.tel/emergency | Zatwierdzone poświadczenia Basic lub specjalnie udostępniony dostęp bearer. JSON code, message i data. |
| Integracje REST portalu | Host i operacja wskazane w dokumentacji dla programistów Twojego konta | Używaj danych uwierzytelniających, zakresów uprawnień i schematu opisanych dla danej operacji. Żądania sesji przeglądarki stanowią odrębny kanał dostępu. |
Przed użyciem przykładów ustaw MULTITEL_API_USERNAME i MULTITEL_API_PASSWORD w konfiguracji sekretów swojego serwera. Nigdy nie umieszczaj ich w publicznym JavaScripcie przeglądarki, adresach URL ani w repozytorium kodu. Dedykowanymi poświadczeniami zarządzasz w ustawieniach integracji API.
Przygotuj żądanie SMS
Użyj zatwierdzonego numeru nadawczego z obsługą SMS, należącego do konta, odbiorcy, który wyraził zgodę na wiadomość, oraz wymaganej weryfikacji Brand/Campaign lub numeru bezpłatnego. Poniższy przykład wysyła prawdziwą wiadomość po uzupełnieniu działającymi poświadczeniami i numerami; to nie jest piaskownica.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
--request POST \
--header "Content-Type: application/json" \
--data '{"from":"YOUR_APPROVED_NUMBER","to":"YOUR_CONSENTED_RECIPIENT","text":"Your requested update is ready."}' \
"https://api.multitel.net/v3/sendsms"Zastąp symbole zastępcze nadawcy i odbiorcy cyframi międzynarodowymi z numerem kierunkowym kraju. W przypadku MMS podaj w media obsługiwany, publicznie dostępny adres URL multimediów i najpierw sprawdź kwalifikowalność oraz cennik MMS.
Przyjęcie to nie doręczenie
Sprawdź zarówno zewnętrzny status aplikacji, jak i zwrócony wynik wiadomości. Zapisz identyfikator wiadomości dostarczony przez usługę oraz śledź status doręczenia i zdarzenia webhook. Pomyślne przesłanie nie dowodzi, że telefon odbiorcy otrzymał wiadomość.
SMS są rozliczane za segment. Kodowanie i długość wiadomości mogą dać kilka segmentów; opłaty za multimedia i związane z operatorem mogą różnić się od opłat za SMS. Przed wysłaniem sprawdź aktualną cenę sprzedaży na koncie. Nigdy nie ponawiaj na ślepo wysyłki, która przekroczyła czas: najpierw sprawdź jej zapisany wynik.
Obsługa błędów i ponowień
- Błąd uwierzytelniania lub uprawnień
- Sprawdź, czy poświadczenie API jest włączone, jaka usługa jest dozwolona oraz jakie obowiązuje ograniczenie źródłowego adresu IP. Plik cookie sesji portalu nie jest poświadczeniem integracji.
- Niewystarczające środki lub brak wymaganej zgody
- Uzupełnij środki na koncie, uzyskaj zgodę na wysyłkę lub dostarcz wymagany dokument, zanim powtórzysz operację.
- Brak wyniku
- Puste zasoby numerów lub brak nazwy dzwoniącego traktuj jako zwykły wynik. Nie zakładaj, że poprawny składniowo numer obsługuje każdą usługę.
- Przekroczenie czasu sieci lub awaria usługi
- Dla operacji odczytu stosuj ograniczoną liczbę ponowień z rosnącymi odstępami między próbami. Przy zakupie, wysyłce lub rejestracji najpierw sprawdź stan operacji; ponowienie przyjętego żądania może powielić płatną czynność.
Obsługa idempotentności zależy od danej rodziny API. połączeń alarmowych API obsługuje klucze ponowień, ale to nie czyni dowolnych żądań v3 idempotentnymi. Zachowaj znaczniki czasu, zwrócone identyfikatory i odpowiedzi z usuniętymi danymi wrażliwymi na potrzeby pomocy technicznej.
Przejdź do dokumentacji swojego konta
Dokumentacja dostępna po zalogowaniu filtruje operacje według Twoich uprawnień i włączonych usług. Korzystaj z jej dokładnego hosta, typu poświadczeń, pól żądania i schematu odpowiedzi. Konsole mogą wykonywać operacje na żywo, w tym zakupy i wysyłanie wiadomości.