Ettevõtted, kes kasutavad Presiot, jagavad täitmata vahetusi oma personaliteenuse pakkujatele. Te pärite pakkumised API kaudu või saate need webhooki kaudu, esitate oma töötajad - ja kinnitus arvestatakse kohe koosseisu. Ilma telefonita, ilma e-kirjade pingpongita.
Partneri-API on teadlikult väike: kolm otspunkti ja üks webhook. See kujutab täpselt seda töövoogu, mis täna käib telefoni teel - ainult ilma täpsustavate küsimusteta ja ilma graafiku järelhooldamiseta.
Kõik pakkumised, mille ettevõte on teile jaganud - koos kuupäeva, kellaaja, töökoha, nõutava kvalifikatsiooni, kohtade arvu ja tähtajaga.
Niipea kui ettevõte jagab teile pakkumise, saab teie webhooki URL pakkumise JSON-ina - pärimistsüklit ei ole vaja.
Te esitate töötaja nime, kvalifikatsiooni ja kontakti ühele pakkumisele. Ettevõte kinnitab või lükkab tagasi - staatust näete igal ajal.
Ettevõte loob teid oma partnerihalduses: nimi, kontakt, milliseid töökohti ja kvalifikatsioone te katate. Iga ettevõte, kellega te töötate, loob teid eraldi.
Presio genereerib API-võtme iga partneri ja ettevõtte kohta. Ettevõte edastab selle teile turvalisel viisil; te saadate selle iga päringuga kaasa päises x-partner-key .
Kas te pärite GET /offers regulaarselt, või salvestate ettevõtte juures webhooki URL-i ja saate iga uue pakkumise kohe kätte.
Kasutades POST /offers/{id}/respond esitate te töötaja. Kui ettevõte kinnitab, on töötaja töögraafikus ja arvestatakse plaanitud/tegeliku koosseisu hulka. Staatust näete päringuga GET /responses.
Kõik päringud käivad JSON-ina üle HTTPS-i. API-võti identifitseerib korraga nii partneri kui ka ettevõtte - eraldi sisselogimist ei ole.
<code>Baas-URL: https://jvesiwsaghavrelflbjc.supabase.co/functions/v1/partner-api Päis: x-partner-key: <teie API-võti> Content-Type: application/json</code>
Tagastab kõik pakkumised, mis on teile jagatud ja ei ole veel aegunud - koos teie enda esitustega nende kohta.
<code>GET /offers x-partner-key: <teie API-võti> 200 OK { "partner": { "id": "…", "name": "Pflege-Personal Nord GmbH" }, "offers": [ { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Hommikune vahetus", "startTime": "06:30", "endTime": "14:30", "workplace": "Osakond 3", "requiredSkill": "Õendustöötaja", "slots": 1, "note": "Üleandmine 6:15 osakonna toas", "deadline": "2026-09-04T18:00:00Z", "state": "open", "myResponses": 0, "myAccepted": 0 } ] }</code>
Esitab töötaja ühele pakkumisele. Töötaja ja pakkumise kohta on võimalik üks esitus; mitme koha korral saate esitada mitu töötajat.
<code>POST /offers/8f2c…/respond x-partner-key: <teie API-võti> Content-Type: application/json { "name": "Anna Beispiel", "qualification": "Õendustöötaja", "contact": "0170 1234567", "note": "alates 6:30 kohal" } 201 Created { "ok": true, "response": { "id": "c41a…", "state": "applied" } }</code>
Kõik esitused, mille te olete teinud, koos praeguse staatusega: applied (esitatud), accepted (ettevõtte poolt kinnitatud, töötaja on graafikusse pandud) või declined (tagasi lükatud või pakkumine täidetud muul viisil).
<code>GET /responses x-partner-key: <teie API-võti> 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>
Kui ettevõte salvestab teie jaoks webhooki URL-i, saadab Presio iga uue pakkumise korral POST-päringu sama pakkumisobjektiga nagu GET /offers. Vastake 2xx-ga; vigade korral korratakse saatmist.
<code>POST <teie webhooki URL> Content-Type: application/json { "event": "offer.created", "offer": { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Hommikune vahetus", "startTime": "06:30", "endTime": "14:30", "workplace": "Osakond 3", "requiredSkill": "Õendustöötaja", "slots": 1, "note": "Üleandmine 6:15 osakonna toas", "deadline": "2026-09-04T18:00:00Z", "state": "open" } }</code>
<code>401 Unauthorized API-võti puudub, on kehtetu või ettevõte on selle tagasi võtnud 404 Not Found Pakkumist ei ole olemas või see ei ole teile jagatud 409 Conflict Pakkumine on juba täidetud, aegunud või töötaja on juba esitatud</code>
Liides on ehitatud nii, et mõlemad pooled näevad ainult seda, mida nad rakendamiseks vajavad.
Kirjuta meile lühidalt, milliseid ettevõtteid te teenindate ja milline süsteem teil töötab - saadame teile testjuurdepääsu ja näidispakkumised.
Arutame liidestamist Proovi Presiot tasuta