Un texte juridique, rendu

GET

/v1/legal/{kind}

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

• Vimine API

La version en vigueur d’un type (ou ?version= pour une version archivée), avec les variables remplacées par l’identité de l’opérateur et le registre des sous-traitants ultérieurs. ?locale=it|en avec repli sur l’italien (le texte italien prévaut). Les modèles destinés aux associations (DPA et annexes) affichent des libellés génériques là où vont les données propres de l’association.

Paramètres

Paramètres de chemin

kind

obligatoire

Type de document

string

Paramètres de requête

locale

string

Valeurs autorisées : it en zh-Hans zh-Hant fr es de pt-BR

version

Une version publiée précise

string

Réponses

200

Document

Type de médiaapplication/json

object

uid

string format : uuid

kind

obligatoire

Type de document (platform_terms, platform_privacy, platform_cookie, aps_terms, aps_dpa, aps_dpa_annex1_processing … developer_terms)

string

locale

obligatoire

string

Valeurs autorisées : it en zh-Hans zh-Hant fr es de pt-BR

version

obligatoire

Libellé de version (1.0, 1.1, …)

string

title

obligatoire

string

summary

Ce qui a changé dans cette version

string

nullable

effective_from

string format : date-time

nullable

retired_at

string format : date-time

nullable

sha256

SHA-256 du corps canonique du modèle

string

nullable

current

obligatoire

C’est la version en vigueur de ce type dans sa langue

boolean

requires_reacceptance

boolean

kind_title

string

rendered_sha256

SHA-256 du texte rendu (variables remplacées), tel que l’enregistre une acceptation

string

content_md

obligatoire

Le texte rendu, en Markdown. Sa version et la date à partir de laquelle il est en vigueur sont version et effective_from, non répétées dans le texte : à afficher à côté

string

content_html

obligatoire

Le texte rendu, en HTML (aucun HTML brut ne passe ; liens limités à http(s)/mailto)

string

data

Instantané structuré pour les documents générés à partir de données (le registre des sous-traitants ultérieurs d’une version de l’annexe 3)

object

document_url

La version PDF, quand elle est publiée

string format : uri

nullable

notice_days

integer

versions

obligatoire

Array<object>

object

version

string

effective_from

string format : date-time

nullable

retired_at

string format : date-time

nullable

sha256

string

nullable

current

boolean

Exemple

{
  "locale": "it"
}

400

Requête invalide

Type de médiaapplication/problem+json

object

type

obligatoire

string format : uri

title

obligatoire

string

status

obligatoire

integer

detail

string

code

obligatoire

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Exemple^généré

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

404

Aucun document publié de ce type

429

Limite de débit atteinte

Type de médiaapplication/problem+json

object

type

obligatoire

string format : uri

title

obligatoire

string

status

obligatoire

integer

detail

string

code

obligatoire

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Exemple^généré

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

500

Erreur interne

Type de médiaapplication/problem+json

object

type

obligatoire

string format : uri

title

obligatoire

string

status

obligatoire

integer

detail

string

code

obligatoire

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Exemple^généré

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