Ein Rechtstext, gerendert

GET

/v1/legal/{kind}

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

• Vimine API

Die geltende Version einer Art (oder ?version= für eine archivierte), mit Platzhaltern, die mit der Identität des Betreibers und dem Register der Unterauftragsverarbeiter aufgelöst sind. ?locale=it|en, mit Italienisch als Ersatz (der italienische Text ist maßgeblich). An Vereine gerichtete Vorlagen (DPA und Anlagen) zeigen allgemeine Bezeichnungen, wo die eigenen Daten des Vereins stehen.

Parameter

Pfadparameter

kind

erforderlich

Dokumentart

string

Query-Parameter

locale

string

Erlaubte Werte: it en zh-Hans zh-Hant fr es de pt-BR

version

Eine bestimmte veröffentlichte Version

string

Antworten

200

Dokument

Medientypapplication/json

object

uid

string Format: uuid

kind

erforderlich

Dokumentart (platform_terms, platform_privacy, platform_cookie, aps_terms, aps_dpa, aps_dpa_annex1_processing … developer_terms)

string

locale

erforderlich

string

Erlaubte Werte: it en zh-Hans zh-Hant fr es de pt-BR

version

erforderlich

Versionsbezeichnung (1.0, 1.1, …)

string

title

erforderlich

string

summary

Was sich in dieser Version geändert hat

string

nullable

effective_from

string Format: date-time

nullable

retired_at

string Format: date-time

nullable

sha256

SHA-256 des kanonischen Vorlagentexts

string

nullable

current

erforderlich

Dies ist die geltende Version der Art in ihrer Sprache

boolean

requires_reacceptance

boolean

kind_title

string

rendered_sha256

SHA-256 des gerenderten Texts (Platzhalter aufgelöst), wie eine Annahme ihn festhält

string

content_md

erforderlich

Der gerenderte Text, Markdown. Version und Datum, ab dem er gilt, sind version und effective_from und stehen nicht im Text: daneben anzeigen

string

content_html

erforderlich

Der gerenderte Text, HTML (kein Roh-HTML wird durchgelassen; Links auf http(s)/mailto beschränkt)

string

data

Strukturierte Momentaufnahme bei aus Daten erzeugten Dokumenten (das Register der Unterauftragsverarbeiter einer Version von Anlage 3)

object

document_url

PDF-Fassung, wenn veröffentlicht

string Format: uri

nullable

notice_days

integer

versions

erforderlich

Array<object>

object

version

string

effective_from

string Format: date-time

nullable

retired_at

string Format: date-time

nullable

sha256

string

nullable

current

boolean

Beispiel

{
  "locale": "it"
}

400

Ungültige Anfrage

Medientypapplication/problem+json

object

type

erforderlich

string Format: uri

title

erforderlich

string

status

erforderlich

integer

detail

string

code

erforderlich

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Beispiel^erzeugt

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

404

Kein veröffentlichtes Dokument dieser Art

429

Ratenlimit überschritten

Medientypapplication/problem+json

object

type

erforderlich

string Format: uri

title

erforderlich

string

status

erforderlich

integer

detail

string

code

erforderlich

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Beispiel^erzeugt

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

500

Interner Fehler

Medientypapplication/problem+json

object

type

erforderlich

string Format: uri

title

erforderlich

string

status

erforderlich

integer

detail

string

code

erforderlich

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Beispiel^erzeugt

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