# PUSH API

#### Skalowalna wysyłka transakcyjna i automatyzacja

Sekcja Mobile Push API umożliwia pełną integrację Twojego systemu z infrastrukturą MessageFlow. To rozwiązanie dedykowane do obsługi powiadomień transakcyjnych (np. statusy zamówień, kody 2FA) oraz realizacji automatycznych scenariuszy komunikacji bezpośrednio z poziomu kodu, z pominięciem interfejsu graficznego panelu.

### Kluczowe możliwości kanału PUSH API

* **Wysyłka Transakcyjna**: Szybka realizacja pojedynczych komunikatów krytycznych czasowo (np. kody 2FA, alerty bezpieczeństwa, statusy zamówień) wysyłanych w reakcji na zdarzenie.
* **Pełna Automatyzacja**: Wyzwalanie powiadomień w czasie rzeczywistym w reakcji na zdarzenia w Twoim systemie (trigger-based messaging).
* **Logi i Wyszukiwarka w Panelu**: Mimo wysyłki realizowanej programistycznie, masz pełny wgląd w historię zdarzeń w interfejsie panelu. Wbudowana wyszukiwarka pozwala szybko namierzyć konkretną wysyłkę i zweryfikować jej status, co znacznie przyspiesza obsługę zgłoszeń (Customer Support) i weryfikację błędów.
* **Webhooks & Raportowanie**: Możliwość odbierania statusów doręczenia (DLR) bezpośrednio do Twojego systemu poprzez mechanizm callback/webhook.
* **Adresowanie**: Precyzyjne dotarcie do użytkownika przy użyciu unikalnego Device Token (ciąg znaków generowany przez aplikację, identyfikujący urządzenie).

{% hint style="success" %}
**Best Practice**: Wysyłki Masowe API jest zoptymalizowane pod kątem szybkich powiadomień transakcyjnych (1:1). Do realizacji wysokowolumenowych kampanii marketingowych (bulk) zalecamy korzystanie z modułu **Kampanie** w panelu. Posiada on dedykowane mechanizmy zarządzania przepustowością, które gwarantują stabilność i szybkość dostarczania przy dużych bazach odbiorców.
{% endhint %}

### Jak to działa?

Komunikacja odbywa się poprzez bezpieczne żądania HTTPS. Twój system przesyła payload (treść + odbiorcy) do MessageFlow, który waliduje zapytanie i przekazuje je do odpowiednich bramek (FCM dla Android / APNs dla iOS).

* Metoda: `POST`
* Endpoint: `/v2.1/push`
* Wymagane parametry: W żądaniu (body) należy przekazać tablicę tokenów urządzeń (`device_tokens`) oraz treść wiadomości.

{% hint style="info" %}
**Dokumentacja Deweloperska**

Szczegółowy opis metod, struktury JSON, kodów błędów oraz przykłady implementacji (cURL, PHP, Python, Java) znajdziesz w [naszej dokumentacji](https://dev.messageflow.com/#/operations/PushCreate).
{% endhint %}

{% hint style="success" %}
**Specyfikacja Techniczna**

Pamiętaj, że limity znaków (tytuł/treść) oraz formaty grafik obowiązują również przy wysyłce przez API. Pełną specyfikację znajdziesz w zakładce [Overview](https://docs.messageflow.com/pl/mobile-push/overview#specyfikacja-techniczna).
{% endhint %}