Firmy korzystające z Presio udostępniają otwarte dyżury swoim agencjom pracy. Pobieracie oferty przez API lub otrzymujecie je przez webhook, zgłaszacie swoich pracowników - a akceptacja od razu liczy się w obsadzie. Bez telefonu, bez e-mailowego ping-ponga.
API partnerskie jest celowo małe: trzy punkty końcowe i jeden webhook. Odwzorowuje dokładnie ten przebieg, który dziś odbywa się przez telefon - tylko bez pytań zwrotnych i bez ręcznego uzupełniania grafiku.
Wszystkie oferty, które firma wam udostępniła - z datą, godziną, stanowiskiem, wymaganą kwalifikacją, liczbą miejsc i terminem.
Gdy tylko firma udostępni wam ofertę, wasz URL webhooka otrzymuje ofertę jako JSON - bez pętli odpytywania.
Zgłaszacie nazwisko, kwalifikację i kontakt pracownika do oferty. Firma akceptuje lub odrzuca - status widzicie w każdej chwili.
Firma tworzy was w swoim zarządzaniu partnerami: nazwa, kontakt, jakie stanowiska i kwalifikacje obsługujecie. Każda firma, z którą współpracujecie, tworzy was osobno.
Presio generuje klucz API dla każdego partnera i firmy. Firma przekazuje go wam bezpieczną drogą; wysyłacie go w nagłówku x-partner-key w każdym żądaniu.
Albo regularnie odpytujecie GET /offers , albo zapisujecie w firmie URL webhooka i każdą nową ofertę dostajecie natychmiast.
Przez POST /offers/{id}/respond zgłaszacie pracownika. Gdy firma zaakceptuje, pracownik jest w grafiku i liczy się w obsadzie planowanej i rzeczywistej. Status widzicie w GET /responses.
Wszystkie zapytania przesyłane są jako JSON przez HTTPS. Klucz API identyfikuje jednocześnie partnera i firmę - nie ma dodatkowego logowania.
<code>Bazowy URL: https://jvesiwsaghavrelflbjc.supabase.co/functions/v1/partner-api Nagłówek: x-partner-key: <wasz klucz API> Content-Type: application/json</code>
Zwraca wszystkie oferty, które zostały wam udostępnione i jeszcze nie wygasły - łącznie z waszymi zgłoszeniami do nich.
<code>GET /offers x-partner-key: <wasz klucz API> 200 OK { "partner": { "id": "…", "name": "Pflege-Personal Nord GmbH" }, "offers": [ { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Dyżur poranny", "startTime": "06:30", "endTime": "14:30", "workplace": "Oddział 3", "requiredSkill": "Pielęgniarka dyplomowana", "slots": 1, "note": "Przekazanie 6:15 w dyżurce", "deadline": "2026-09-04T18:00:00Z", "state": "open", "myResponses": 0, "myAccepted": 0 } ] }</code>
Zgłasza pracownika do oferty. Na pracownika i ofertę możliwe jest jedno zgłoszenie; przy kilku miejscach możecie zgłosić kilku pracowników.
<code>POST /offers/8f2c…/respond x-partner-key: <wasz klucz API> Content-Type: application/json { "name": "Anna Beispiel", "qualification": "Pielęgniarka dyplomowana", "contact": "0170 1234567", "note": "na miejscu od 6:30" } 201 Created { "ok": true, "response": { "id": "c41a…", "state": "applied" } }</code>
Wszystkie złożone przez was zgłoszenia z aktualnym statusem: applied (zgłoszone), accepted (zaakceptowane przez firmę, pracownik jest zaplanowany) lub declined (odrzucone lub oferta obsadzona w inny sposób).
<code>GET /responses x-partner-key: <wasz klucz API> 200 OK { "responses": [ { "id": "c41a…", "offerId": "8f2c…", "name": "Anna Beispiel", "state": "accepted", "updatedAt": "2026-09-04T09:12:00Z" }, { "id": "d902…", "offerId": "71be…", "name": "Max Muster", "state": "applied", "updatedAt": "2026-09-04T09:20:00Z" } ] }</code>
Jeśli firma zapisze dla was URL webhooka, Presio przy każdej nowej ofercie wysyła POST z tym samym obiektem oferty co w GET /offers. Odpowiadajcie kodem 2xx; w razie błędów dostarczenie jest ponawiane.
<code>POST <wasz URL webhooka> Content-Type: application/json { "event": "offer.created", "offer": { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Dyżur poranny", "startTime": "06:30", "endTime": "14:30", "workplace": "Oddział 3", "requiredSkill": "Pielęgniarka dyplomowana", "slots": 1, "note": "Przekazanie 6:15 w dyżurce", "deadline": "2026-09-04T18:00:00Z", "state": "open" } }</code>
<code>401 Unauthorized Brak klucza API, klucz jest nieprawidłowy lub został cofnięty przez firmę 404 Not Found Oferta nie istnieje lub nie została wam udostępniona 409 Conflict Oferta jest już obsadzona, wygasła lub pracownik został już zgłoszony</code>
Interfejs jest zbudowany tak, że obie strony widzą tylko to, czego potrzebują do realizacji dyżuru.
Napisz nam krótko, jakie firmy obsługujecie i jaki system u was działa - wyślemy wam dostęp testowy i przykładowe oferty.
Omów integrację Testuj Presio bezpłatnie