Salta ai contenuti
ArenileArenile
Coste360.itCoste360.it

Overview

Gestionale gratuito per stabilimenti balneari, codice sorgente disponibile (BSL 1.1).

Contratto unico (spec-first) delle API REST di Arenile.

  • /api/admin/v1 — API del pannello del gestore (sessione via cookie o chiave API).
  • /api/public/v1 — API pubblica della pagina di prenotazione.
  • /api/device/v1 — API dei dispositivi abbinati (token per dispositivo, spec 29.2).
  • /api/desktop/v1 — edizione desktop, solo da 127.0.0.1 (spec 29.1).

Convenzioni (specifica, sezione 17.1):

  • errori in application/problem+json (RFC 9457) con type stabile (slug);
  • paginazione a cursore (?cursor=&limit=);
  • Idempotency-Key accettato sui POST che creano risorse o pagamenti;
  • le richieste del pannello autenticate via cookie che modificano dati devono inviare l’header X-CSRF-Token uguale al cookie arenile_csrf;
  • date di calendario YYYY-MM-DD, istanti RFC 3339 UTC.

Documentazione di Arenile

Information

  • License: Business Source License 1.1
  • OpenAPI version: 3.1.0

Sessione del pannello (cookie HttpOnly impostato dal login).

Security scheme type: apiKey

Cookie parameter name: arenile_session

Chiave API server-to-server legata a uno stabilimento (ar_live_...), oppure token per dispositivo (ar_dev_..., vedi deviceAuth) con i permessi del ruolo del suo utente.

Security scheme type: http

Bearer format: ar_live_<prefix>_<secret>

Token per dispositivo ottenuto con pairDevice (app mobile, app desktop in modalità remota). Vale anche come bearerAuth sulle API admin, con i permessi del ruolo dell’utente nello stabilimento del dispositivo. Revocabile dal pannello (spec 29.2).

Security scheme type: http

Bearer format: ar_dev_<prefix>_<secret>