API REST V2

Documentazione API StelleVere

Endpoint JSON per artigiani, lavori, recensioni e integrazioni esterne. Questa pagina serve come riferimento rapido nel browser.

Base URL: https://stellevere.it API write key: non configurata API admin key: non configurata

Endpoint

GET /api/artigiani

Lista artigiani con filtri e paginazione.

GET /api/artigiani/:slug

Dettaglio artigiano con lavori pubblicati.

GET /api/lavori

Lista lavori con ricerca semantica, filtri e paginazione.

GET /api/lavori/:artigianoSlug/:lavoroSlug

Dettaglio di un lavoro specifico.

GET /api/recensioni

Lista recensioni pubblicate più recenti.

POST /api/lavori

Crea un nuovo lavoro via API. Richiede API key.

POST /api/recensioni

Crea una recensione su un lavoro. Richiede API key.

POST /api/claims

Avvia un claim attività.

GET /api/admin/overview

Dati aggregati admin. Richiede API admin key.

Esempi Rapidi

Apri lista artigiani JSON Apri dettaglio artigiano JSON Apri lista lavori JSON Apri lista recensioni JSON

Autenticazione

Gli endpoint di lettura sono pubblici. Gli endpoint di scrittura accettano la chiave via header x-api-key oppure come parametro api_key.

curl -X POST "https://stellevere.it/api/lavori" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_WRITE_KEY" \
  -d '{
    "artigiano_slug": "idratest",
    "categoria_slug": "idraulica",
    "titolo": "Sostituzione rubinetto cucina",
    "descrizione": "Sostituzione miscelatore cucina e verifica finale della tenuta.",
    "citta": "Roma",
    "quartiere": "Salario",
    "lat": 41.9326,
    "lng": 12.4994,
    "immagini": [{ "src": "data:image/jpeg;base64,...", "name": "rubinetto-1.jpg" }]
  }'

Esempio Recensione

curl -X POST "https://stellevere.it/api/recensioni" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_WRITE_KEY" \
  -d '{
    "artigiano_slug": "idratest",
    "lavoro_slug": "sostituzione-caldaia-a-condensazione-roma-1774339190198",
    "cliente_nome": "Mario Rossi",
    "voto": 5,
    "testo": "Lavoro preciso, puntuale e pulito."
  }'

Documentazione File

Health check File locale docs: docs/api-rest.md File locale esempi curl: docs/curl-examples.md File locale Postman: docs/postman-stellevere-v2.collection.json