Betriebe, die Presio nutzen, geben offene Dienste an ihre Personaldienstleister frei. Ihr ruft die Angebote per API ab oder bekommt sie per Webhook, meldet eure Kräfte - und die Zusage zählt sofort in der Besetzung. Ohne Telefon, ohne E-Mail-Pingpong.
Die Partner-API ist bewusst klein: drei Endpunkte und ein Webhook. Sie bildet genau den Ablauf ab, der heute per Telefon läuft - nur ohne Rückfragen und ohne Nachpflegen im Plan.
Alle Angebote, die ein Betrieb für euch freigegeben hat - mit Datum, Zeit, Arbeitsplatz, benötigter Qualifikation, Plätzen und Frist.
Sobald ein Betrieb ein Angebot für euch freigibt, bekommt eure Webhook-URL das Angebot als JSON zugestellt - keine Abfrage-Schleife nötig.
Ihr meldet Name, Qualifikation und Kontakt einer Kraft auf ein Angebot. Der Betrieb sagt zu oder ab - den Status seht ihr jederzeit.
Der Betrieb legt euch in seiner Partner-Verwaltung an: Name, Kontakt, welche Arbeitsplätze und Qualifikationen ihr abdeckt. Jeder Betrieb, mit dem ihr arbeitet, legt euch einzeln an.
Presio erzeugt einen API-Key je Partner und Betrieb. Der Betrieb übergibt ihn euch auf sicherem Weg; ihr schickt ihn bei jeder Anfrage im Header x-partner-key mit.
Entweder ihr fragt GET /offers regelmäßig ab, oder ihr hinterlegt beim Betrieb eine Webhook-URL und bekommt jedes neue Angebot sofort zugestellt.
Per POST /offers/{id}/respond meldet ihr eine Kraft. Sagt der Betrieb zu, steht die Kraft im Dienstplan und zählt in der Soll/Ist-Besetzung. Den Status seht ihr unter GET /responses.
Alle Anfragen gehen als JSON über HTTPS. Der API-Key identifiziert Partner und Betrieb zugleich - es gibt keinen weiteren Login.
Basis-URL: https://jvesiwsaghavrelflbjc.supabase.co/functions/v1/partner-api
Header: x-partner-key: <euer API-Key>
Content-Type: application/json
Liefert alle Angebote, die für euch freigegeben und noch nicht abgelaufen sind - inklusive eurer eigenen Meldungen dazu.
GET /offers
x-partner-key: <euer API-Key>
200 OK
{
"partner": { "id": "…", "name": "Pflege-Personal Nord GmbH" },
"offers": [
{
"id": "8f2c…",
"organization": "Klinikum Beispielstadt",
"date": "2026-09-05",
"shift": "Frühdienst",
"startTime": "06:30",
"endTime": "14:30",
"workplace": "Station 3",
"requiredSkill": "Pflegefachkraft",
"slots": 1,
"note": "Übergabe 6:15 im Stationszimmer",
"deadline": "2026-09-04T18:00:00Z",
"state": "open",
"myResponses": 0,
"myAccepted": 0
}
]
}
Meldet eine Kraft auf ein Angebot. Pro Kraft und Angebot ist eine Meldung möglich; bei mehreren Plätzen könnt ihr mehrere Kräfte melden.
POST /offers/8f2c…/respond
x-partner-key: <euer API-Key>
Content-Type: application/json
{
"name": "Anna Beispiel",
"qualification": "Pflegefachkraft",
"contact": "0170 1234567",
"note": "ab 6:30 vor Ort"
}
201 Created
{
"ok": true,
"response": { "id": "c41a…", "state": "applied" }
}
Alle Meldungen, die ihr abgegeben habt, mit aktuellem Status: applied (gemeldet), accepted (vom Betrieb zugesagt, Kraft ist eingeplant) oder declined (abgelehnt oder Angebot anderweitig besetzt).
GET /responses
x-partner-key: <euer API-Key>
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" }
]
}
Hinterlegt der Betrieb eine Webhook-URL für euch, schickt Presio bei jedem neuen Angebot einen POST mit demselben Angebotsobjekt wie unter GET /offers. Antwortet mit 2xx; bei Fehlern wird die Zustellung wiederholt.
POST <eure Webhook-URL>
Content-Type: application/json
{
"event": "offer.created",
"offer": {
"id": "8f2c…",
"organization": "Klinikum Beispielstadt",
"date": "2026-09-05",
"shift": "Frühdienst",
"startTime": "06:30",
"endTime": "14:30",
"workplace": "Station 3",
"requiredSkill": "Pflegefachkraft",
"slots": 1,
"note": "Übergabe 6:15 im Stationszimmer",
"deadline": "2026-09-04T18:00:00Z",
"state": "open"
}
}
401 Unauthorized API-Key fehlt, ist ungültig oder wurde vom Betrieb zurückgezogen
404 Not Found Angebot existiert nicht oder ist nicht für euch freigegeben
409 Conflict Angebot ist bereits besetzt, abgelaufen oder die Kraft wurde schon gemeldet
Die Schnittstelle ist so gebaut, dass beide Seiten nur sehen, was sie für den Einsatz brauchen.
Schreib uns kurz, welche Betriebe ihr bedient und welches System bei euch läuft - wir schicken euch Testzugang und Beispiel-Angebote.
Anbindung besprechen Presio kostenlos testen