Registrar que el socio acepta un documento legal en su versión en vigor

POST

/v1/me/acceptances

curl --request POST \
  --url https://api.vimine.network/v1/me/acceptances \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "kind": "example", "version": "example", "sha256": "example" }'

• Vimine API

Registra una fila de prueba (canal api, con tu app indicada): un documento de la capa de la cuenta (platform_terms aceptado, platform_privacy con acuse de recibo, network_consent consentido) o el privacy_notice de esta asociación, con acuse de recibo. version (y sha256 cuando se publica) debe nombrar el texto en vigor que ha mostrado tu app — si no, 422 <kind>_outdated. Registrar dos veces la misma versión no causa problemas: cada fila es una prueba. Acepta Idempotency-Key.

Autorizaciones

• BearerToken
  legal:accept

Cuerpo de la petición^obligatorio

Tipo de medioapplication/json

object

kind

obligatorio

Platform_terms | platform_privacy | network_consent | privacy_notice

string

version

obligatorio

Uno de:

string

string

integer

integer

sha256

string

Ejemplo^generado

{
  "kind": "example",
  "version": "example",
  "sha256": "example"
}

Respuestas

200

Registrada

Tipo de medioapplication/json

object

recorded

obligatorio

boolean

kind

obligatorio

string

action

obligatorio

string

version

obligatorio

string

at

obligatorio

string formato: date-time

Ejemplo^generado

{
  "recorded": true,
  "kind": "example",
  "action": "example",
  "version": "example",
  "at": "2026-04-15T12:00:00Z"
}

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"
    }
  ]
}

401

Credenciales ausentes o no válidas

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"
    }
  ]
}

403

No permitido

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 nada publicado de este tipo (not_found)

422

Tipo desconocido, versión ausente o una versión que no está en vigor (<kind>_outdated)

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"
    }
  ]
}