跳到內容
Vimine 開發者文件
繁體

一份呈現後的法律文字

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

某類文件的現行版本（或用 ?version= 取得存檔版本），其中的預留位置已以營運方的身份資訊和次處理者登記冊填入。?locale=it|en，無對應語言時改用義大利語（以義大利語文字為準）。給租戶的範本（DPA 及其附件）在應填入協會自身資料之處顯示通用標籤。

參數

章節「參數」

路徑參數

章節「路徑參數」
kind
必填

文件類型

string

查詢參數

章節「查詢參數」
locale
string
允許的值： it en zh-Hans zh-Hant fr es de pt-BR
version

某個特定的已發布版本

string

回應

章節「回應」

200

章節「200」

文件

媒體類型application/json
object
uid
string 格式： uuid
kind
必填

文件類型（platform_terms、platform_privacy、platform_cookie、aps_terms、aps_dpa、aps_dpa_annex1_processing … developer_terms）

string
locale
必填
string
允許的值： it en zh-Hans zh-Hant fr es de pt-BR
version
必填

版本標籤（1.0、1.1、…）

string
title
必填
string
summary

此版本的變更內容

string
可為 null
effective_from
string 格式： date-time
可為 null
retired_at
string 格式： date-time
可為 null
sha256

規範化範本內文的 SHA-256

string
可為 null
current
必填

這是該類型在其語言中的現行版本

boolean
requires_reacceptance
boolean
kind_title
string
rendered_sha256

呈現後文字的 SHA-256（預留位置已填入），即接受時記錄的值

string
content_md
必填

呈現後的文字，Markdown 格式。其版本與生效日期分別為 version 與 effective_from，文字中不再重複：請在旁邊顯示

string
content_html
必填

呈現後的文字，HTML 格式（原始 HTML 一律不予保留；連結僅限 http(s)/mailto）

string
data

由資料產生之文件的結構化快照（某個附件 3 版本的次處理者登記冊）

object
document_url

已發布時對應的 PDF 版本

string 格式： uri
可為 null
notice_days
integer
versions
必填
Array<object>
object
version
string
effective_from
string 格式： date-time
可為 null
retired_at
string 格式： date-time
可為 null
sha256
string
可為 null
current
boolean
範例
{
  "locale": "it"
}

400

章節「400」

請求無效

媒體類型application/problem+json
object
type
必填
string 格式： uri
title
必填
string
status
必填
integer
detail
string
code
必填
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
範例自動產生
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

404

章節「404」

此類型沒有已發布的文件

429

章節「429」

超出速率限制

媒體類型application/problem+json
object
type
必填
string 格式： uri
title
必填
string
status
必填
integer
detail
string
code
必填
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
範例自動產生
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

500

章節「500」

內部錯誤

媒體類型application/problem+json
object
type
必填
string 格式： uri
title
必填
string
status
必填
integer
detail
string
code
必填
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
範例自動產生
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}