Actualizar los datos de contacto y personales del socio

PATCH

/v1/me

curl --request PATCH \
  --url https://api.vimine.network/v1/me \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "phone": "example", "dob": "2026-04-15", "gender": "M", "birthplace": "example", "birth_country": "example", "codicefiscale": "example", "codicefiscale_confirmed": true, "locale": "it" }'

• Vimine API

Modificables: phone, gender, locale y la identificación — dob, birthplace, birth_country, codicefiscale. Una persona se identifica con un código fiscal O con la fecha, el lugar y el país de nacimiento; el código fiscal es opcional y se puede añadir más tarde. Un código se valida y se coteja con el nombre guardado, la fecha de nacimiento y el lugar — el comune para las personas nacidas en Italia, solo el PAÍS (birth_country) para todas las demás; el sexo no se coteja. Un código que no coincide responde 422 codicefiscale_mismatch con mismatches, hints (names_swapped) y confirmable: cuando confirmable es true, la persona puede confirmar que es el código de su tarjeta sanitaria — envía codicefiscale_confirmed: true — y codicefiscale_check pasa a ser mismatch_confirmed.

Autorizaciones

• BearerToken
  profile:write

Cuerpo de la petición^obligatorio

Tipo de medioapplication/json

object

phone

string

nullable

dob

string formato: date

nullable

gender

string

nullable

Valores permitidos: M F

birthplace

Comune (nacidos en Italia) o ciudad, texto libre (nacidos en el extranjero)

string

nullable

birth_country

ISO 3166-1 alpha-2

string

nullable >= 2 caracteres <= 2 caracteres

codicefiscale

string

nullable

codicefiscale_confirmed

Solo escritura: la persona confirma un código que no coincide con sus datos (consulta confirmable)

boolean

locale

El idioma de la persona; null borra la elección. 422 unsupported para un idioma que la plataforma no ofrece

string

nullable

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

Respuestas

200

El perfil actualizado

Tipo de medioapplication/json

object

sub

obligatorio

El identificador de sujeto de esta persona, como en el token de ID

string

email

obligatorio

string formato: email

email_verified

obligatorio

boolean

first_name

string

nullable

last_name

string

nullable

phone

string

nullable

dob

string formato: date

nullable

gender

Solo demográfico

string

nullable

Valores permitidos: M F

birthplace

string

nullable

birth_country

ISO 3166-1 alpha-2

string

nullable

codicefiscale

Opcional: una persona puede no tenerlo

string

nullable

codicefiscale_check

Cómo está identificada la persona. matched: un código fiscal que coincide con sus datos; mismatch_confirmed: un código que no coincide, confirmado por la persona; absent: ningún código — la identifican la fecha, el lugar y el país de nacimiento; null: todavía no identificada (no puede solicitar la inscripción)

string

nullable

Valores permitidos: matched mismatch_confirmed absent

locale

El idioma que eligió la persona para la plataforma y sus correos; null: nunca elegido — se aplica el idioma de la petición y, después, el de la asociación

string

nullable

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

updated_at

string formato: date-time

nullable

Ejemplo

{
  "gender": "M",
  "codicefiscale_check": "matched",
  "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"
    }
  ]
}

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 encontrado

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

422

Validación fallida (errors[]: invalid_codicefiscale, codicefiscale_mismatch, invalid, age_below_minimum, not_writable)

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