Pular para o conteúdo
Vimine para desenvolvedores
PT

Atualizar os contatos e os dados pessoais do associado

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

Editáveis: phone, gender, locale e a identificação — dob, birthplace, birth_country, codicefiscale. Uma pessoa é identificada por um código fiscal OU pela data, local e país de nascimento; o código fiscal é opcional e pode ser adicionado depois. Um código é validado e conferido com o nome registrado, a data de nascimento e o local — o comune para quem nasceu na Itália, só o PAÍS (birth_country) para todos os outros; o sexo não é conferido. Um código que não confere responde 422 codicefiscale_mismatch com mismatches, hints (names_swapped) e confirmable: quando confirmable é true, a pessoa pode confirmar que esse é o código do seu cartão de saúde italiano (tessera sanitaria) — envie codicefiscale_confirmed: true — e codicefiscale_check passa a ser mismatch_confirmed.

Autorizações

Seção intitulada “Autorizações”

Corpo da requisiçãoobrigatório

Seção intitulada “Corpo da requisiçãoobrigatório”
Tipo de mídiaapplication/json
object
phone
string
nullable
dob
string formato: date
nullable
gender
string
nullable
Valores permitidos: M F
birthplace

Comune (nascidos na Itália) ou cidade, texto livre (nascidos no exterior)

string
nullable
birth_country

ISO 3166-1 alpha-2

string
nullable >= 2 caracteres <= 2 caracteres
codicefiscale
string
nullable
codicefiscale_confirmed

Só de escrita: a pessoa confirma um código que não confere com os seus dados (veja confirmable)

boolean
locale

O idioma da pessoa; null apaga a escolha. 422 unsupported para um idioma que a plataforma não oferece

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

Respostas

Seção intitulada “Respostas”

200

Seção intitulada “200”

O perfil atualizado

Tipo de mídiaapplication/json
object
sub
obrigatório

O identificador desta pessoa (subject), como no ID token

string
email
obrigatório
string formato: email
email_verified
obrigatório
boolean
first_name
string
nullable
last_name
string
nullable
phone
string
nullable
dob
string formato: date
nullable
gender

Só estatístico

string
nullable
Valores permitidos: M F
birthplace
string
nullable
birth_country

ISO 3166-1 alpha-2

string
nullable
codicefiscale

Opcional: uma pessoa pode não ter um

string
nullable
codicefiscale_check

Como a pessoa está identificada. matched: um código fiscal que confere com os seus dados; mismatch_confirmed: um código que não confere, confirmado pela pessoa; absent: nenhum código — data, local e país de nascimento a identificam; null: ainda não identificada (não pode pedir uma carteirinha)

string
nullable
Valores permitidos: matched mismatch_confirmed absent
locale

O idioma que a pessoa escolheu para a plataforma e os seus e-mails; null: nunca escolhido — vale o idioma da requisição, depois o da associação

string
nullable
Valores permitidos: it en zh-Hans zh-Hant fr es de pt-BR
updated_at
string formato: date-time
nullable
Exemplo
{
  "gender": "M",
  "codicefiscale_check": "matched",
  "locale": "it"
}

400

Seção intitulada “400”

Requisição inválida

Tipo de mídiaapplication/problem+json
object
type
obrigatório
string formato: uri
title
obrigatório
string
status
obrigatório
integer
detail
string
code
obrigatório
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplogerado
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

401

Seção intitulada “401”

Credenciais ausentes ou inválidas

Tipo de mídiaapplication/problem+json
object
type
obrigatório
string formato: uri
title
obrigatório
string
status
obrigatório
integer
detail
string
code
obrigatório
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplogerado
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

403

Seção intitulada “403”

Não permitido

Tipo de mídiaapplication/problem+json
object
type
obrigatório
string formato: uri
title
obrigatório
string
status
obrigatório
integer
detail
string
code
obrigatório
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplogerado
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

404

Seção intitulada “404”

Não encontrado

Tipo de mídiaapplication/problem+json
object
type
obrigatório
string formato: uri
title
obrigatório
string
status
obrigatório
integer
detail
string
code
obrigatório
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplogerado
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

422

Seção intitulada “422”

Falha na validação (errors[]: invalid_codicefiscale, codicefiscale_mismatch, invalid, age_below_minimum, not_writable)

429

Seção intitulada “429”

Limite de requisições excedido

Tipo de mídiaapplication/problem+json
object
type
obrigatório
string formato: uri
title
obrigatório
string
status
obrigatório
integer
detail
string
code
obrigatório
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplogerado
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

500

Seção intitulada “500”

Erro interno

Tipo de mídiaapplication/problem+json
object
type
obrigatório
string formato: uri
title
obrigatório
string
status
obrigatório
integer
detail
string
code
obrigatório
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplogerado
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}