In-negozji li jużaw Presio jirrilaxxaw xifts miftuħa lill-fornituri tal-persunal tagħhom. Intom iġġibu l-offerti permezz tal-API jew tirċevuhom permezz ta' webhook, tirrappurtaw il-ħaddiema tagħkom - u l-aċċettazzjoni tgħodd minnufih fil-persunal. Mingħajr telefon, mingħajr ping-pong ta' emails.
L-API għall-Imsieħba hi żgħira apposta: tliet endpoints u webhook wieħed. Hija tirrifletti eżattament il-proċess li llum isir bit-telefon - biss mingħajr mistoqsijiet lura u mingħajr aġġornamenti manwali fil-pjan.
L-offerti kollha li negozju rrilaxxa għalikom - bid-data, il-ħin, il-post tax-xogħol, il-kwalifika meħtieġa, il-postijiet u l-iskadenza.
Hekk kif negozju jirrilaxxa offerta għalikom, il-Webhook-URL tagħkom tirċievi l-offerta bħala JSON - l-ebda polling meħtieġ.
Intom tirrappurtaw l-isem, il-kwalifika u l-kuntatt ta' ħaddiem għal offerta. In-negozju jaċċetta jew jirrifjuta - l-istatus tarawh f'kull ħin.
In-negozju joħloqkom fil-ġestjoni tal-imsieħba tiegħu: isem, kuntatt, liema postijiet tax-xogħol u kwalifiki tkopru. Kull negozju li taħdmu miegħu joħloqkom separatament.
Presio joħloq API-Key għal kull imsieħeb u negozju. In-negozju jgħaddihulkom b'mod sikur; intom tibagħtuh ma' kull talba bil-header x-partner-key inkluż.
Jew tistaqsu GET /offers regolarment, jew iddaħħlu għand in-negozju Webhook-URL u tirċievu kull offerta ġdida minnufih.
Permezz ta' POST /offers/{id}/respond tirrappurtaw ħaddiem. Jekk in-negozju jaċċetta, il-ħaddiem jidher fil-pjan tax-xifts u jgħodd fil-persunal ippjanat u dak reali. L-istatus tarawh taħt GET /responses.
It-talbiet kollha jintbagħtu bħala JSON fuq HTTPS. L-API-Key jidentifika l-imsieħeb u n-negozju fl-istess ħin - m'hemm l-ebda login ieħor.
<code>URL bażi: https://jvesiwsaghavrelflbjc.supabase.co/functions/v1/partner-api Header: x-partner-key: <l-API-Key tagħkom> Content-Type: application/json</code>
Jagħti l-offerti kollha li huma rilaxxati għalikom u li għadhom ma skadewx - inklużi r-rapporti tagħkom stess għalihom.
<code>GET /offers x-partner-key: <l-API-Key tagħkom> 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 } ] }</code>
Jirrapporta ħaddiem għal offerta. Għal kull ħaddiem u offerta hu possibbli rapport wieħed; b'diversi postijiet tistgħu tirrappurtaw diversi ħaddiema.
<code>POST /offers/8f2c…/respond x-partner-key: <l-API-Key tagħkom> 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" } }</code>
Ir-rapporti kollha li bgħattu, bl-istatus attwali: applied (irrappurtat), accepted (aċċettat min-negozju, il-ħaddiem hu ppjanat) jew declined (irrifjutat jew l-offerta mtliet b'mod ieħor).
<code>GET /responses x-partner-key: <l-API-Key tagħkom> 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>
Jekk in-negozju jdaħħal Webhook-URL għalikom, Presio jibgħat ma' kull offerta ġdida POST bl-istess oġġett tal-offerta bħal taħt GET /offers. Wieġbu b'2xx; f'każ ta' żbalji, il-kunsinna tiġi ripetuta.
<code>POST <il-Webhook-URL tagħkom> 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" } }</code>
<code>401 Unauthorized L-API-Key nieqes, mhux validu jew ġie rtirat min-negozju 404 Not Found L-offerta ma teżistix jew mhijiex rilaxxata għalikom 409 Conflict L-offerta diġà mtliet, skadiet jew il-ħaddiem diġà ġie rrappurtat</code>
L-interfaċċa hi mibnija b'tali mod li ż-żewġ naħat jaraw biss dak li għandhom bżonn għall-assenjament.
Iktbulna fil-qosor liema negozji sservu u liema sistema tużaw - aħna nibagħtulkom aċċess għat-test u offerti ta' eżempju.
Iddiskuti l-integrazzjoni Ipprova Presio b'xejn