Фирмите, които използват Presio, освобождават свободни дежурства за своите агенции за персонал. Вие извличате предложенията през API или ги получавате чрез webhook, заявявате своите служители - и потвърждението се брои веднага в разпределението. Без телефон, без пинг-понг по имейл.
Партньорският API е съзнателно малък: три крайни точки и един webhook. Той отразява точно процеса, който днес върви по телефона - само без уточнения и без допълнително въвеждане в графика.
Всички предложения, които дадена фирма е освободила за вас - с дата, час, работно място, необходима квалификация, брой места и срок.
Щом дадена фирма освободи предложение за вас, вашият webhook URL получава предложението като JSON - не е нужен цикъл на запитване.
Заявявате име, квалификация и контакт на служител по дадено предложение. Фирмата потвърждава или отказва - статуса виждате по всяко време.
Фирмата ви създава в своето управление на партньори: име, контакт, кои работни места и квалификации покривате. Всяка фирма, с която работите, ви създава отделно.
Presio генерира API ключ за всеки партньор и фирма. Фирмата ви го предава по сигурен път; вие го изпращате при всяка заявка в хедъра x-partner-key при всяка заявка.
Или запитвате GET /offers редовно, или въвеждате при фирмата webhook URL и получавате всяко ново предложение веднага.
Чрез POST /offers/{id}/respond заявявате служител. Ако фирмата потвърди, служителят е в графика и се брои в планираното/реалното разпределение. Статуса виждате под GET /responses.
Всички заявки се изпращат като JSON през HTTPS. API ключът идентифицира едновременно партньора и фирмата - няма друг вход.
<code>Базов URL: https://jvesiwsaghavrelflbjc.supabase.co/functions/v1/partner-api Header: x-partner-key: <вашият API ключ> Content-Type: application/json</code>
Връща всички предложения, които са освободени за вас и още не са изтекли - включително вашите собствени заявки по тях.
<code>GET /offers x-partner-key: <вашият API ключ> 200 OK { "partner": { "id": "…", "name": "Pflege-Personal Nord GmbH" }, "offers": [ { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Ранна смяна", "startTime": "06:30", "endTime": "14:30", "workplace": "Отделение 3", "requiredSkill": "Медицинска сестра", "slots": 1, "note": "Предаване 6:15 в сестринската стая", "deadline": "2026-09-04T18:00:00Z", "state": "open", "myResponses": 0, "myAccepted": 0 } ] }</code>
Заявява служител по дадено предложение. За всеки служител и предложение е възможна една заявка; при няколко места можете да заявите няколко служители.
<code>POST /offers/8f2c…/respond x-partner-key: <вашият API ключ> Content-Type: application/json { "name": "Anna Beispiel", "qualification": "Медицинска сестра", "contact": "0170 1234567", "note": "на място от 6:30" } 201 Created { "ok": true, "response": { "id": "c41a…", "state": "applied" } }</code>
Всички заявки, които сте подали, с актуален статус: applied (заявено), accepted (потвърдено от фирмата, служителят е включен в графика) или declined (отказано или предложението е заето по друг начин).
<code>GET /responses x-partner-key: <вашият 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>
Ако фирмата въведе webhook URL за вас, Presio изпраща при всяко ново предложение POST със същия обект на предложението както при GET /offers. Отговаряйте с 2xx; при грешки доставката се повтаря.
<code>POST <вашият webhook URL> Content-Type: application/json { "event": "offer.created", "offer": { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Ранна смяна", "startTime": "06:30", "endTime": "14:30", "workplace": "Отделение 3", "requiredSkill": "Медицинска сестра", "slots": 1, "note": "Предаване 6:15 в сестринската стая", "deadline": "2026-09-04T18:00:00Z", "state": "open" } }</code>
<code>401 Unauthorized API ключът липсва, е невалиден или е оттеглен от фирмата 404 Not Found Предложението не съществува или не е освободено за вас 409 Conflict Предложението вече е заето, изтекло е или служителят вече е заявен</code>
Интерфейсът е изграден така, че двете страни виждат само това, което им трябва за назначението.
Пишете ни накратко кои фирми обслужвате и коя система използвате - ще ви изпратим тестов достъп и примерни предложения.
Обсъждане на свързването Тествай Presio безплатно