Le aziende che usano Presio rilasciano i turni scoperti ai loro fornitori di personale. Voi recuperate le offerte via API o le ricevete via webhook, segnalate le vostre risorse - e la conferma conta subito nella copertura. Senza telefono, senza ping-pong di e-mail.
L'API partner è volutamente piccola: tre endpoint e un webhook. Riproduce esattamente il flusso che oggi passa per telefono - solo senza domande di chiarimento e senza correzioni a mano nel piano.
Tutte le offerte che un'azienda ha rilasciato per voi - con data, orario, postazione, qualifica richiesta, posti e scadenza.
Non appena un'azienda rilascia un'offerta per voi, il vostro URL webhook riceve l'offerta come JSON - nessun ciclo di interrogazione necessario.
Segnalate nome, qualifica e contatto di una risorsa per un'offerta. L'azienda conferma o rifiuta - lo stato lo vedete in qualsiasi momento.
L'azienda vi crea nella sua gestione partner: nome, contatto, quali postazioni e qualifiche coprite. Ogni azienda con cui lavorate vi crea separatamente.
Presio genera una chiave API per ogni partner e azienda. L'azienda ve la consegna in modo sicuro; voi la inviate a ogni richiesta nell'header x-partner-key .
Oppure interrogate GET /offers regolarmente, oppure registrate presso l'azienda un URL webhook e ricevete subito ogni nuova offerta.
Tramite POST /offers/{id}/respond segnalate una risorsa. Se l'azienda conferma, la risorsa è nel piano turni e conta nella copertura previsto/effettivo. Lo stato lo vedete in GET /responses.
Tutte le richieste viaggiano in JSON via HTTPS. La chiave API identifica insieme partner e azienda - non c'è nessun altro login.
<code>URL di base: https://jvesiwsaghavrelflbjc.supabase.co/functions/v1/partner-api Header: x-partner-key: <la vostra chiave API> Content-Type: application/json</code>
Restituisce tutte le offerte rilasciate per voi e non ancora scadute - comprese le vostre segnalazioni relative.
<code>GET /offers x-partner-key: <la vostra chiave API> 200 OK { "partner": { "id": "…", "name": "Pflege-Personal Nord GmbH" }, "offers": [ { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Turno del mattino", "startTime": "06:30", "endTime": "14:30", "workplace": "Reparto 3", "requiredSkill": "Infermiere/a", "slots": 1, "note": "Consegne alle 6:15 nella sala infermieri", "deadline": "2026-09-04T18:00:00Z", "state": "open", "myResponses": 0, "myAccepted": 0 } ] }</code>
Segnala una risorsa per un'offerta. È possibile una segnalazione per risorsa e offerta; con più posti potete segnalare più risorse.
<code>POST /offers/8f2c…/respond x-partner-key: <la vostra chiave API> Content-Type: application/json { "name": "Anna Beispiel", "qualification": "Infermiere/a", "contact": "0170 1234567", "note": "sul posto dalle 6:30" } 201 Created { "ok": true, "response": { "id": "c41a…", "state": "applied" } }</code>
Tutte le segnalazioni che avete inviato, con lo stato attuale: applied (segnalata), accepted (confermata dall'azienda, la risorsa è pianificata) oppure declined (rifiutata oppure offerta coperta in altro modo).
<code>GET /responses x-partner-key: <la vostra chiave 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>
Se l'azienda registra un URL webhook per voi, Presio invia a ogni nuova offerta un POST con lo stesso oggetto offerta di GET /offers. Rispondete con 2xx; in caso di errore la consegna viene ripetuta.
<code>POST <il vostro URL webhook> Content-Type: application/json { "event": "offer.created", "offer": { "id": "8f2c…", "organization": "Klinikum Beispielstadt", "date": "2026-09-05", "shift": "Turno del mattino", "startTime": "06:30", "endTime": "14:30", "workplace": "Reparto 3", "requiredSkill": "Infermiere/a", "slots": 1, "note": "Consegne alle 6:15 nella sala infermieri", "deadline": "2026-09-04T18:00:00Z", "state": "open" } }</code>
<code>401 Unauthorized Chiave API mancante, non valida o revocata dall'azienda 404 Not Found L'offerta non esiste o non è rilasciata per voi 409 Conflict L'offerta è già coperta, scaduta oppure la risorsa è già stata segnalata</code>
L'interfaccia è costruita in modo che entrambe le parti vedano solo ciò che serve per l'impiego.
Scriveteci in due righe quali aziende servite e quale sistema usate - vi inviamo un accesso di prova e offerte di esempio.
Parliamo dell'integrazione Prova Presio gratis