Elenca i documenti legali

GET /v1/legal-documents · permesso legal-documents:read

Elenca i documenti legali mostrati ai tuoi utenti finali (termini, informative sulla privacy, documenti personalizzati), dal più recente, in pagine con cursor. È disponibile solo la paginazione in avanti (after); before e order=asc vengono rifiutati. Cambiare un filtro invalida i cursor emessi per un altro filtro.

Richiesta

Parametri di query:

Campo Tipo Obbligatorio Descrizione
limit integer no 1-100, predefinito 20.
after string no Cursor opaco da list_metadata.after.
kind string no Filtra per tipo: terms, privacy_notice o custom.
application_id string no Solo i documenti specifici di questa applicazione (app_…).

Risposta

200 OK con data (documenti) e list_metadata (before è sempre null; after è null nell'ultima pagina). Non viene restituito alcun totale.

{
  "data": [
    {
      "id": "ldoc_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "application_id": null,
      "kind": "terms",
      "version": "2026-10",
      "locale": "en",
      "url": "https://example.com/legal/terms-2026-10",
      "content_sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
      "effective_at": "2026-11-01T00:00:00Z",
      "requires_reacceptance": true,
      "created_at": "2026-10-05T09:30:00.123456Z",
      "updated_at": "2026-10-05T09:30:00.123456Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Errori

HTTP code Quando
400 invalid_cursor Il cursor è malformato o è stato emesso per un altro filtro.
422 validation_failed Un parametro di query non è valido.
401 unauthenticated La credenziale è mancante, non valida o revocata.
403 insufficient_permissions La credenziale non ha il permesso richiesto.
429 rate_limited Il limite di velocità è stato superato; riprova dopo il periodo Retry-After.
503 service_unavailable Una dipendenza è temporaneamente non disponibile; riprova dopo il periodo Retry-After.

Esempio

curl "https://api.eu.keenauth.com/v1/legal-documents?kind=terms&limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"