Konektor · REST
Połącz się z dowolnym API z dowolnego przepływu.
ERP, przewoźnik, bank czy portal administracji — jeśli ma API, phaf może je wywołać. Uwierzytelnij, zmapuj, wyślij i odczytaj odpowiedź bez pisania kodu.
Bazowy URL
https://api.acme-erp.example/v2
Uwierzytelnianie
Token Bearer
Token
•••••••• (sejf)
Eksploatacja
POST /invoices
Jak się łączy
Kilka ustawień i połączenie gotowe.
Bazowy URL
Dowolny punkt końcowy HTTP lub HTTPS — w chmurze albo w Twojej sieci.
Uwierzytelnianie
Klucz API, Basic lub token Bearer; OAuth 2.0 jest w fazie rozwoju. Sekrety pozostają zaszyfrowane w sejfie phaf.
Metoda i ścieżka
GET, POST, PUT, PATCH lub DELETE na dowolnej ścieżce, z nagłówkami i parametrami zapytania, a następnie mapowanie pól.
Operacje
Każde wywołanie HTTP jako akcja konektora.
| akcja phaf | Żądanie API | Co robi |
|---|---|---|
| Zapytanie | GET /resource?filter&page | Pobieraj rekordy do przepływu z filtrami i stronicowaniem. |
| Wyszukiwanie | GET /resource/{id} | Wzbogać wiadomość jednym rekordem, na przykład danymi klienta. |
| Utwórz | POST /resource | Twórz dokumenty i dane podstawowe. |
| Aktualizuj | PUT | PATCH /resource/{id} | Zmieniaj tylko zmapowane pola. |
| Upsert | GET → POST | PATCH | Sprawdza, czy rekord istnieje, i sam decyduje. |
| Usuń | DELETE /resource/{id} | Usuwaj rekordy, na których usunięcie pozwala API. |
| Wywołaj akcję | POST /any/endpoint | Uruchamiaj dowolną operację udostępnianą przez API REST. |
| Odbierz | Webhook → phaf | Pozwól API wysyłać zdarzenia do przepływu (w fazie rozwoju). |
Przykłady
Dowolne API przez jeden konektor.
Poniższe API są fikcyjne — pokazują rodzaje systemów i wywołań, które obsługuje phaf.
Klienci, faktury i stany magazynowe w chmurowym ERP.
GET /v2/customers?status=active&page=2
Przyjęcia towaru, stany magazynowe i potwierdzenia wysyłek.
POST /v1/receipts { "sku": "SKU-10045", "qty": 120 }
Pozycje pojazdów, trasy i odczyty paliwa.
GET /fleet/vehicles/TRK-042/positions?since=2026-10-26
Żądania płatności, zwroty i raporty rozliczeniowe.
POST /payments { "amount": 12500, "currency": "USD" }
Rezerwacje, etykiety wysyłkowe i śledzenie przesyłek.
POST /shipments { "origin": "WAW", "weightKg": 12.5 }
Wysyłaj faktury do administracji skarbowej i otrzymuj kod walidacji.
POST /einvoices/submit → { "validationCode": "…" }
Pracownicy, potrącenia płacowe i urlopy.
GET /employees?updatedSince=2026-10-01
Stany i ruchy magazynowe.
PATCH /items/SKU-889 { "onHand": 140 }
Salda rachunków i dzienne wyciągi bankowe.
GET /accounts/ACC-01/statements?date=2026-10-26
Żądanie i odpowiedź
Zobacz, co zostało wysłane i co odpowiedziało API.
Każde żądanie jest zapisywane z transakcją. Błędy są pokazywane czytelnym tekstem.
{
"customerId": "C-1001",
"currency": "USD",
"lines": [
{ "sku": "STORAGE-20FT", "qty": 3 }
]
}
Fikcyjne API, pokazane jako przykłady.
Niezawodność
Ponawia to, co powinien. Zatrzymuje się tam, gdzie musi.
Ponowienia z rosnącym opóźnieniem
Przekroczenie czasu, limity zapytań (429) lub błędy 5xx: próbuje ponownie, za każdym razem czekając dłużej.
Błędy danych zatrzymują wiadomość
Jeśli API odrzuci dane, wiadomość trafia na ścieżkę błędu.
Obsługa stronicowania
Podąża za linkami do następnej strony i kursorami, aż odczyta wszystkie rekordy.
Pełna historia
Żądanie, odpowiedź, próby i czasy każdego wywołania.
Na kanwie
Dowolne źródło, dowolne API jako cel.
Baza danych, plik, EDI lub inne API — zmapuj do punktu końcowego i wyślij.
EDI
EDIFACT
TRANSFORM
Map_To_JSON
API REST
ERP_CreateOrder
Przykład ilustracyjny.
Przynieś API, które chcesz połączyć.
Wywołamy je na żywo z phaf podczas demo.