Richieste
Le richieste che le persone hanno fatto sui tuoi immobili, e lo stato in cui hai spostato ciascuna. Circoscritte agli immobili di proprietà della tua organizzazione: una richiesta appartiene a chi possiede l'immobile a cui si riferisce.
/v1/api/inquiriesinquiries:readElencare le richieste
Richieste sui tuoi immobili, dalla più recente.
Paginata a cursore come ogni altra raccolta. Filtra per immobile o per stato per costruire una coda di lavoro invece di scorrere tutto.
Parametri di query
| Nome | Tipo | Descrizione |
|---|---|---|
status | enum | Solo le richieste in questo stato. new | read | replied | closed | spam esempio: new |
property_id | string | Solo le richieste su questo immobile. esempio: prop_9ad0ddd2e01949ddb471899aba67d577 |
limit | integer | Dimensione della pagina. Limitata a 200. predefinito: 50esempio: 50 |
cursor | string | Cursore opaco preso dal meta.next_cursor della pagina precedente. esempio: eyJpZCI6InByb3BfMWI3N2UwYTRmMiJ9 |
sort | string | Campo su cui ordinare. Anteponi un meno per l'ordine decrescente. esempio: -created_at |
Risposta
{
"data": [
{
"id": "inq_db6f3d5316884c649ea1848c278bbf44",
"property_id": "prop_f954911b55e14b65b762ee55f01e03b7",
"sender_name": "Anna Schmidt",
"sender_email": "anna@example.com",
"sender_phone": "+49 30 555",
"message": "Is the balcony south facing?",
"status": "new",
"channel": "web",
"consent_text": "I agree to be contacted about this property.",
"consented_at": "2026-08-13T10:43:26Z",
"created_at": "2026-08-13T10:43:26Z"
}
],
"meta": { "has_more": false, "limit": 50 }
}https://api.skautik.com/v1/api/inquiries
GET /v1/api/inquiries?status=new&property_id=prop_9ad0ddd2e01949ddb471899aba67d577&limit=50 HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/inquiries/{inquiry_id}inquiries:readRecuperare una richiesta
Una richiesta per intero.
Una richiesta su un immobile che la tua organizzazione non possiede risponde esattamente come una inesistente, quindi l'API non può essere usata per sondare schede che non puoi leggere.
Parametri di percorso
| Nome | Tipo | Descrizione |
|---|---|---|
inquiry_idobbligatorio | string | Identificatore della richiesta. esempio: inq_db6f3d5316884c649ea1848c278bbf44 |
https://api.skautik.com/v1/api/inquiries/{inquiry_id}
GET /v1/api/inquiries/inq_db6f3d5316884c649ea1848c278bbf44 HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/inquiries/{inquiry_id}/readinquiries:readSegnare come letta
Registra che l'hai vista.
read_at viene impostato una volta e non si sposta nelle chiamate successive. Risponde a quando hai visto la richiesta per la prima volta, che è ciò che interessa a chi aspetta una risposta; sovrascriverlo risponderebbe a quando hai guardato l'ultima volta, che non l'ha chiesto nessuno. Segnare come letta non fa tornare indietro uno stato: una richiesta a cui hai già risposto resta come risposta.
Parametri di percorso
| Nome | Tipo | Descrizione |
|---|---|---|
inquiry_idobbligatorio | string | Identificatore della richiesta. esempio: inq_db6f3d5316884c649ea1848c278bbf44 |
https://api.skautik.com/v1/api/inquiries/{inquiry_id}/read
POST /v1/api/inquiries/inq_db6f3d5316884c649ea1848c278bbf44/read HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/inquiries/{inquiry_id}inquiries:readImpostare lo stato
Fai avanzare una richiesta nel tuo flusso di lavoro.
Impostare replied registra quando è successo, e quel dato sopravvive a un successivo passaggio a chiusa: il fatto che qualcuno abbia ricevuto risposta non viene annullato dall'archiviazione della conversazione.
Parametri di percorso
| Nome | Tipo | Descrizione |
|---|---|---|
inquiry_idobbligatorio | string | Identificatore della richiesta. esempio: inq_db6f3d5316884c649ea1848c278bbf44 |
Campi del corpo
| Nome | Tipo | Descrizione |
|---|---|---|
statusobbligatorio | string | Lo stato in cui spostarla. new | read | replied | closed | spam esempio: new |
Corpo della richiesta
{ "status": "replied" }https://api.skautik.com/v1/api/inquiries/{inquiry_id}
PATCH /v1/api/inquiries/inq_db6f3d5316884c649ea1848c278bbf44 HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…
Content-Type: application/json
{ "status": "replied" }