Firmy, které používají Presio, uvolňují volné služby svým personálním agenturám. Nabídky načtete přes API nebo je dostanete přes webhook, nahlásíte své pracovníky - a potvrzení se okamžitě počítá do obsazení. Bez telefonu, bez e-mailového pingpongu.
Partnerské API je záměrně malé: tři endpointy a jeden webhook. Zobrazuje přesně ten průběh, který dnes běží po telefonu - jen bez zpětných dotazů a bez dodatečného doplňování do plánu.
Všechny nabídky, které pro vás firma uvolnila - s datem, časem, pracovištěm, požadovanou kvalifikací, počtem míst a lhůtou.
Jakmile firma uvolní nabídku pro vás, dostane vaše webhook URL nabídku jako JSON - žádná dotazovací smyčka není potřeba.
Nahlásíte jméno, kvalifikaci a kontakt pracovníka na nabídku. Firma potvrdí nebo odmítne - stav vidíte kdykoli.
Firma vás založí ve své správě partnerů: název, kontakt, která pracoviště a kvalifikace pokrýváte. Každá firma, se kterou spolupracujete, vás založí zvlášť.
Presio vygeneruje API klíč pro každého partnera a firmu. Firma vám ho předá bezpečnou cestou; vy ho posíláte při každém požadavku v hlavičce x-partner-key jako součást požadavku.
Buď pravidelně voláte GET /offers a dotazujete se na nové nabídky, nebo u firmy uložíte webhook URL a každou novou nabídku dostanete okamžitě.
Přes POST /offers/{id}/respond nahlásíte pracovníka. Pokud firma potvrdí, je pracovník v rozpisu služeb a počítá se do plánovaného/skutečného obsazení. Stav vidíte pod GET /responses.
Všechny požadavky jdou jako JSON přes HTTPS. API klíč identifikuje partnera i firmu zároveň - žádné další přihlášení není potřeba.
<code>Základní URL: https://jvesiwsaghavrelflbjc.supabase.co/functions/v1/partner-api Header: x-partner-key: <váš API klíč> Content-Type: application/json</code>
Vrátí všechny nabídky, které jsou pro vás uvolněny a ještě nevypršely - včetně vašich vlastních nahlášení k nim.
<code>GET /offers x-partner-key: <váš API klíč> 200 OK { "partner": { "id": "…", "name": "Pflege-Personal Nord GmbH" }, "offers": [ { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Ranní služba", "startTime": "06:30", "endTime": "14:30", "workplace": "Oddělení 3", "requiredSkill": "Zdravotní sestra", "slots": 1, "note": "Předání 6:15 na sesterně", "deadline": "2026-09-04T18:00:00Z", "state": "open", "myResponses": 0, "myAccepted": 0 } ] }</code>
Nahlásí pracovníka na nabídku. Na jednoho pracovníka a nabídku je možné jedno nahlášení; při více místech můžete nahlásit více pracovníků.
<code>POST /offers/8f2c…/respond x-partner-key: <váš API klíč> Content-Type: application/json { "name": "Anna Beispiel", "qualification": "Zdravotní sestra", "contact": "0170 1234567", "note": "od 6:30 na místě" } 201 Created { "ok": true, "response": { "id": "c41a…", "state": "applied" } }</code>
Všechna nahlášení, která jste odeslali, s aktuálním stavem: applied (nahlášeno), accepted (firma potvrdila, pracovník je naplánován) nebo declined (odmítnuto nebo nabídka obsazena jinak).
<code>GET /responses x-partner-key: <váš API klíč> 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>
Pokud pro vás firma uloží webhook URL, pošle Presio při každé nové nabídce POST se stejným objektem nabídky jako u GET /offers. Odpovězte kódem 2xx; při chybě se doručení opakuje.
<code>POST <vaše webhook URL> Content-Type: application/json { "event": "offer.created", "offer": { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Ranní služba", "startTime": "06:30", "endTime": "14:30", "workplace": "Oddělení 3", "requiredSkill": "Zdravotní sestra", "slots": 1, "note": "Předání 6:15 na sesterně", "deadline": "2026-09-04T18:00:00Z", "state": "open" } }</code>
<code>401 Unauthorized API klíč chybí, je neplatný nebo jej firma odvolala 404 Not Found Nabídka neexistuje nebo pro vás není uvolněna 409 Conflict Nabídka je již obsazena, vypršela nebo pracovník už byl nahlášen</code>
Rozhraní je postaveno tak, že obě strany vidí jen to, co pro nasazení potřebují.
Napište nám krátce, které firmy obsluhujete a jaký systém u vás běží - pošleme vám testovací přístup a ukázkové nabídky.
Probrat napojení Vyzkoušet Presio zdarma