Un testo legale, compilato

GET

/v1/legal/{kind}

curl --request GET \
  --url 'https://api.vimine.network/v1/legal/example?locale=it'

• Vimine API

La versione in vigore di un tipo (o ?version= per una archiviata), con i segnaposto risolti con l’identità dell’operatore e il registro dei sub-responsabili. ?locale=it|en, in mancanza l’italiano (prevale il testo italiano). I modelli rivolti alle associazioni (DPA e allegati) mostrano etichette generiche dove vanno i dati dell’associazione.

Parametri

Parametri di percorso

kind

obbligatorio

Tipo di documento

string

Parametri di query

locale

string

Valori ammessi: it en zh-Hans zh-Hant fr es de pt-BR

version

Una specifica versione pubblicata

string

Risposte

200

Documento

Tipo di contenutoapplication/json

object

uid

string formato: uuid

kind

obbligatorio

Tipo di documento (platform_terms, platform_privacy, platform_cookie, aps_terms, aps_dpa, aps_dpa_annex1_processing … developer_terms)

string

locale

obbligatorio

string

Valori ammessi: it en zh-Hans zh-Hant fr es de pt-BR

version

obbligatorio

Etichetta della versione (1.0, 1.1, …)

string

title

obbligatorio

string

summary

Cosa è cambiato in questa versione

string

nullable

effective_from

string formato: date-time

nullable

retired_at

string formato: date-time

nullable

sha256

SHA-256 del corpo canonico del modello

string

nullable

current

obbligatorio

È la versione in vigore di questo tipo nella sua lingua

boolean

requires_reacceptance

boolean

kind_title

string

rendered_sha256

SHA-256 del testo compilato (segnaposto risolti), come lo registra un’accettazione

string

content_md

obbligatorio

Il testo compilato, in Markdown. La versione e la data da cui è in vigore sono version ed effective_from, non ripetute nel testo: mostrale accanto

string

content_html

obbligatorio

Il testo compilato, in HTML (l’HTML grezzo non passa; link limitati a http(s)/mailto)

string

data

Istantanea strutturata per i documenti generati dai dati (il registro dei sub-responsabili di una versione dell’Allegato 3)

object

document_url

Il PDF gemello, quando è pubblicato

string formato: uri

nullable

notice_days

integer

versions

obbligatorio

Array<object>

object

version

string

effective_from

string formato: date-time

nullable

retired_at

string formato: date-time

nullable

sha256

string

nullable

current

boolean

Esempio

{
  "locale": "it"
}

400

Richiesta non valida

Tipo di contenutoapplication/problem+json

object

type

obbligatorio

string formato: uri

title

obbligatorio

string

status

obbligatorio

integer

detail

string

code

obbligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Esempio^generato

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

404

Nessun documento pubblicato di questo tipo

429

Troppe richieste

Tipo di contenutoapplication/problem+json

object

type

obbligatorio

string formato: uri

title

obbligatorio

string

status

obbligatorio

integer

detail

string

code

obbligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Esempio^generato

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

500

Errore interno

Tipo di contenutoapplication/problem+json

object

type

obbligatorio

string formato: uri

title

obbligatorio

string

status

obbligatorio

integer

detail

string

code

obbligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Esempio^generato

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}