Scaoileann gnólachtaí a úsáideann Presio sealanna oscailte chuig a soláthraithe foirne. Faigheann sibh na tairiscintí trí API nó faigheann sibh iad trí webhook, ainmníonn sibh bhur n-oibrithe - agus áirítear an glacadh láithreach sa líon foirne. Gan teileafón, gan pingpong ríomhphoist.
Tá an API comhpháirtithe beag d'aon ghnó: trí chríochphointe agus webhook amháin. Léiríonn sé go díreach an próiseas a ritheann inniu trí theileafón - ach gan ceisteanna ar ais agus gan an plean a chothabháil ina dhiaidh.
Gach tairiscint atá scaoilte daoibh ag gnólacht - le dáta, am, áit oibre, an cháilíocht atá ag teastáil, áiteanna agus spriocdháta.
A luaithe a scaoileann gnólacht tairiscint daoibh, seachadtar an tairiscint mar JSON chuig bhur URL webhook - gan lúb fiosraithe ag teastáil.
Ainmníonn sibh ainm, cáilíocht agus teagmháil oibrí ar thairiscint. Glacann nó diúltaíonn an gnólacht - feiceann sibh an stádas am ar bith.
Cruthaíonn an gnólacht sibh ina bhainistíocht comhpháirtithe: ainm, teagmháil, cé na háiteanna oibre agus cáilíochtaí a chlúdaíonn sibh. Cruthaíonn gach gnólacht a n-oibríonn sibh leis sibh ar leithligh.
Cruthaíonn Presio eochair API in aghaidh an chomhpháirtí agus an ghnólachta. Tugann an gnólacht daoibh í ar bhealach slán; seolann sibh í le gach iarratas sa cheanntásc x-partner-key freisin.
Ceachtar acu, fiosraíonn sibh GET /offers go rialta, nó cláraíonn sibh URL webhook leis an ngnólacht agus seachadtar gach tairiscint nua chugaibh láithreach.
Trí POST /offers/{id}/respond ainmníonn sibh oibrí. Má ghlacann an gnólacht leis, tá an t-oibrí sa sceideal seirbhíse agus áirítear é san fhoireann sprioctha agus iarbhír. Feiceann sibh an stádas faoi GET /responses.
Téann gach iarratas mar JSON thar HTTPS. Sainaithníonn an eochair API an comhpháirtí agus an gnólacht araon - níl aon logáil isteach eile ann.
<code>Bun-URL: https://jvesiwsaghavrelflbjc.supabase.co/functions/v1/partner-api Ceanntásc: x-partner-key: <bhur n-eochair API> Content-Type: application/json</code>
Tugann sé gach tairiscint atá scaoilte daoibh agus nach bhfuil imithe in éag fós - lena n-áirítear bhur n-ainmniúcháin féin ina leith.
<code>GET /offers x-partner-key: <bhur n-eochair API> 200 OK { "partner": { "id": "…", "name": "Pflege-Personal Nord GmbH" }, "offers": [ { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Seal luath", "startTime": "06:30", "endTime": "14:30", "workplace": "Barda 3", "requiredSkill": "Altra cáilithe", "slots": 1, "note": "Aistriú 6:15 i seomra an bharda", "deadline": "2026-09-04T18:00:00Z", "state": "open", "myResponses": 0, "myAccepted": 0 } ] }</code>
Ainmníonn sé oibrí ar thairiscint. Tá ainmniúchán amháin indéanta in aghaidh an oibrí agus na tairisceana; i gcás roinnt áiteanna is féidir libh roinnt oibrithe a ainmniú.
<code>POST /offers/8f2c…/respond x-partner-key: <bhur n-eochair API> Content-Type: application/json { "name": "Anna Beispiel", "qualification": "Altra cáilithe", "contact": "0170 1234567", "note": "ar an láthair ó 6:30" } 201 Created { "ok": true, "response": { "id": "c41a…", "state": "applied" } }</code>
Gach ainmniúchán a chuir sibh isteach, leis an stádas reatha: applied (ainmnithe), accepted (glactha ag an ngnólacht, tá an t-oibrí sceidealaithe) nó declined (diúltaithe nó an tairiscint líonta ar bhealach eile).
<code>GET /responses x-partner-key: <bhur n-eochair API> 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>
Má chláraíonn an gnólacht URL webhook daoibh, seolann Presio POST le gach tairiscint nua leis an réad tairisceana céanna atá faoi GET /offers. Freagraígí le 2xx; i gcás earráidí déanfar an seachadadh arís.
<code>POST <bhur URL webhook> Content-Type: application/json { "event": "offer.created", "offer": { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Seal luath", "startTime": "06:30", "endTime": "14:30", "workplace": "Barda 3", "requiredSkill": "Altra cáilithe", "slots": 1, "note": "Aistriú 6:15 i seomra an bharda", "deadline": "2026-09-04T18:00:00Z", "state": "open" } }</code>
<code>401 Unauthorized Eochair API in easnamh, neamhbhailí nó tarraingthe siar ag an ngnólacht 404 Not Found Níl an tairiscint ann nó níl sí scaoilte daoibh 409 Conflict Tá an tairiscint líonta cheana, imithe in éag nó ainmníodh an t-oibrí cheana</code>
Tá an comhéadan tógtha sa chaoi nach bhfeiceann an dá thaobh ach an rud atá ag teastáil uathu don obair.
Scríobhaigí chugainn go gairid cé na gnólachtaí a bhfreastalaíonn sibh orthu agus cén córas atá ag rith agaibh - seolfaimid rochtain tástála agus tairiscintí samplacha chugaibh.
Nasc a phlé Bain triail as Presio saor in aisce