A Presiót használó cégek megnyitják a betöltetlen műszakokat a munkaerő-szolgáltatóik számára. Ti API-n keresztül kéritek le az ajánlatokat, vagy webhookon kapjátok meg őket, jelentitek a munkaerőtöket - és az elfogadás azonnal beleszámít a létszámba. Telefon nélkül, e-mail-pingpong nélkül.
A Partner-API szándékosan kicsi: három végpont és egy webhook. Pontosan azt a folyamatot képezi le, amely ma telefonon zajlik - csak visszakérdezések és a beosztás utólagos javítgatása nélkül.
Minden ajánlat, amelyet egy cég számotokra megnyitott - dátummal, idővel, munkahellyel, szükséges képesítéssel, helyek számával és határidővel.
Amint egy cég megnyit egy ajánlatot számotokra, a webhook-URL-etek JSON formátumban megkapja az ajánlatot - nincs szükség lekérdezési ciklusra.
Egy munkaerő nevét, képesítését és elérhetőségét jelentitek egy ajánlatra. A cég elfogadja vagy elutasítja - az állapotot bármikor látjátok.
A cég a saját partnerkezelésében hoz létre titeket: név, elérhetőség, mely munkahelyeket és képesítéseket fedtek le. Minden cég, amellyel dolgoztok, külön hoz létre titeket.
A Presio partnerenként és cégenként egy API-kulcsot generál. A cég biztonságos úton adja át nektek; ti minden kérésnél elkülditek a(z) x-partner-key fejlécben.
Vagy rendszeresen lekérdezitek a(z) GET /offers végpontot, vagy megadtok a cégnél egy webhook-URL-t, és minden új ajánlatot azonnal megkaptok.
A(z) POST /offers/{id}/respond végponton keresztül jelentetek munkaerőt. Ha a cég elfogadja, a munkaerő bekerül a beosztásba, és beleszámít az elvárt/tényleges létszámba. Az állapotot itt látjátok: GET /responses.
Minden kérés JSON formátumban, HTTPS-en keresztül megy. Az API-kulcs egyszerre azonosítja a partnert és a céget - nincs további bejelentkezés.
<code>Alap-URL: https://jvesiwsaghavrelflbjc.supabase.co/functions/v1/partner-api Fejléc: x-partner-key: <a ti API-kulcsotok> Content-Type: application/json</code>
Visszaadja az összes ajánlatot, amely számotokra megnyitott és még nem járt le - a hozzájuk tartozó saját jelentéseitekkel együtt.
<code>GET /offers x-partner-key: <a ti API-kulcsotok> 200 OK { "partner": { "id": "…", "name": "Pflege-Personal Nord GmbH" }, "offers": [ { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Délelőttös műszak", "startTime": "06:30", "endTime": "14:30", "workplace": "3. osztály", "requiredSkill": "Szakápoló", "slots": 1, "note": "Átadás 6:15-kor a nővérszobában", "deadline": "2026-09-04T18:00:00Z", "state": "open", "myResponses": 0, "myAccepted": 0 } ] }</code>
Munkaerőt jelent egy ajánlatra. Munkaerőnként és ajánlatonként egy jelentés lehetséges; több hely esetén több munkaerőt is jelenthettek.
<code>POST /offers/8f2c…/respond x-partner-key: <a ti API-kulcsotok> Content-Type: application/json { "name": "Anna Beispiel", "qualification": "Szakápoló", "contact": "0170 1234567", "note": "6:30-tól a helyszínen" } 201 Created { "ok": true, "response": { "id": "c41a…", "state": "applied" } }</code>
Minden általatok leadott jelentés az aktuális állapottal: applied (jelentve), accepted (a cég elfogadta, a munkaerő be van osztva) vagy declined (elutasítva, vagy az ajánlat máshogy lett betöltve).
<code>GET /responses x-partner-key: <a ti API-kulcsotok> 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>
Ha a cég webhook-URL-t ad meg számotokra, a Presio minden új ajánlatnál egy POST-ot küld ugyanazzal az ajánlatobjektummal, mint a(z) GET /offers. Válaszoljatok 2xx-szel; hiba esetén a kézbesítés megismétlődik.
<code>POST <a ti webhook-URL-etek> Content-Type: application/json { "event": "offer.created", "offer": { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Délelőttös műszak", "startTime": "06:30", "endTime": "14:30", "workplace": "3. osztály", "requiredSkill": "Szakápoló", "slots": 1, "note": "Átadás 6:15-kor a nővérszobában", "deadline": "2026-09-04T18:00:00Z", "state": "open" } }</code>
<code>401 Unauthorized Az API-kulcs hiányzik, érvénytelen, vagy a cég visszavonta 404 Not Found Az ajánlat nem létezik, vagy nincs számotokra megnyitva 409 Conflict Az ajánlat már betöltött, lejárt, vagy a munkaerőt már jelentettétek</code>
Az interfész úgy épül fel, hogy mindkét fél csak azt látja, amire a bevetéshez szüksége van.
Írjátok meg röviden, mely cégeket szolgáljátok ki, és milyen rendszer fut nálatok - küldünk teszthozzáférést és példaajánlatokat.
Csatlakozás megbeszélése Presio ingyenes kipróbálása