Un texto legal, renderizado

GET

/v1/legal/{kind}

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

• Vimine API

La versión en vigor de un tipo (o ?version= para una archivada), con los marcadores de posición resueltos con la identidad del operador y el registro de subencargados. ?locale=it|en con el italiano como alternativa (prevalece el texto italiano). Las plantillas dirigidas a las asociaciones (DPA y anexos) muestran etiquetas genéricas donde van los datos propios de la asociación.

Parámetros

Parámetros de ruta

kind

obligatorio

Tipo de documento

string

Parámetros de consulta

locale

string

Valores permitidos: it en zh-Hans zh-Hant fr es de pt-BR

version

Una versión publicada concreta

string

Respuestas

200

Documento

Tipo de medioapplication/json

object

uid

string formato: uuid

kind

obligatorio

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

string

locale

obligatorio

string

Valores permitidos: it en zh-Hans zh-Hant fr es de pt-BR

version

obligatorio

Etiqueta de la versión (1.0, 1.1, …)

string

title

obligatorio

string

summary

Qué ha cambiado en esta versión

string

nullable

effective_from

string formato: date-time

nullable

retired_at

string formato: date-time

nullable

sha256

SHA-256 del cuerpo canónico de la plantilla

string

nullable

current

obligatorio

Es la versión en vigor del tipo en su idioma

boolean

requires_reacceptance

boolean

kind_title

string

rendered_sha256

SHA-256 del texto renderizado (con los marcadores de posición resueltos), tal como lo registra una aceptación

string

content_md

obligatorio

El texto renderizado, en Markdown. Su versión y la fecha desde la que está en vigor son version y effective_from, que no se repiten en él: mostrarlas al lado

string

content_html

obligatorio

El texto renderizado, en HTML (no pasa HTML en bruto; enlaces limitados a http(s)/mailto)

string

data

Instantánea estructurada para los documentos generados a partir de datos (el registro de subencargados de una versión del Anexo 3)

object

document_url

Versión en PDF, cuando está publicada

string formato: uri

nullable

notice_days

integer

versions

obligatorio

Array<object>

object

version

string

effective_from

string formato: date-time

nullable

retired_at

string formato: date-time

nullable

sha256

string

nullable

current

boolean

Ejemplo

{
  "locale": "it"
}

400

Petición no válida

Tipo de medioapplication/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

detail

string

code

obligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Ejemplo^generado

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

404

No hay ningún documento publicado de este tipo

429

Límite de frecuencia superado

Tipo de medioapplication/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

detail

string

code

obligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Ejemplo^generado

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

500

Error interno

Tipo de medioapplication/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

detail

string

code

obligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Ejemplo^generado

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