Aller au contenu

Mettre à jour les coordonnées et les données personnelles du membre

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

Champs modifiables : phone, gender, locale, et l’identification — dob, birthplace, birth_country, codicefiscale. Une personne est identifiée par un code fiscal OU par sa date, son lieu et son pays de naissance ; le code fiscal est facultatif et peut être ajouté plus tard. Un code est validé et comparé avec le nom enregistré, la date de naissance et le lieu — la comune pour les personnes nées en Italie, seulement l’ÉTAT (birth_country) pour toutes les autres ; le sexe n’est pas comparé. Un code en désaccord répond 422 codicefiscale_mismatch avec mismatches, hints (names_swapped) et confirmable : quand confirmable vaut true, la personne peut confirmer que c’est bien le code inscrit sur sa carte d’assurance maladie (tessera sanitaria) — envoyez codicefiscale_confirmed: true — et codicefiscale_check devient mismatch_confirmed.

Type de médiaapplication/json
object
phone
string
nullable
dob
string format : date
nullable
gender
string
nullable
Valeurs autorisées : M F
birthplace

Comune (né en Italie) ou ville, texte libre (né à l’étranger)

string
nullable
birth_country

ISO 3166-1 alpha-2

string
nullable >= 2 caractères <= 2 caractères
codicefiscale
string
nullable
codicefiscale_confirmed

Écriture seule : la personne confirme un code en désaccord avec ses données de naissance (voir confirmable)

boolean
locale

La langue de la personne ; null efface le choix. 422 unsupported pour une langue que la plateforme ne propose pas

string
nullable
Valeurs autorisées : it en zh-Hans zh-Hant fr es de pt-BR

Le profil mis à jour

Type de médiaapplication/json
object
sub
obligatoire

L’identifiant de sujet de cette personne, tel qu’il figure dans le jeton d’identité

string
email
obligatoire
string format : email
email_verified
obligatoire
boolean
first_name
string
nullable
last_name
string
nullable
phone
string
nullable
dob
string format : date
nullable
gender

Démographique seulement

string
nullable
Valeurs autorisées : M F
birthplace
string
nullable
birth_country

ISO 3166-1 alpha-2

string
nullable
codicefiscale

Facultatif : une personne peut ne pas en avoir

string
nullable
codicefiscale_check

Comment la personne est identifiée. matched : un code fiscal qui concorde avec ses données de naissance ; mismatch_confirmed : un code en désaccord, confirmé par la personne ; absent : pas de code — la date, le lieu et le pays de naissance l’identifient ; null : pas encore identifiée (elle ne peut pas demander d’adhésion)

string
nullable
Valeurs autorisées : matched mismatch_confirmed absent
locale

La langue que la personne a choisie pour la plateforme et ses e-mails ; null : jamais choisie — la langue de la requête, puis celle de l’association, s’applique

string
nullable
Valeurs autorisées : it en zh-Hans zh-Hant fr es de pt-BR
updated_at
string format : date-time
nullable
Exemple
{
"gender": "M",
"codicefiscale_check": "matched",
"locale": "it"
}

Requête invalide

Type de médiaapplication/problem+json
object
type
obligatoire
string format : uri
title
obligatoire
string
status
obligatoire
integer
detail
string
code
obligatoire
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplegénéré
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}

Identifiants manquants ou invalides

Type de médiaapplication/problem+json
object
type
obligatoire
string format : uri
title
obligatoire
string
status
obligatoire
integer
detail
string
code
obligatoire
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplegénéré
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}

Non autorisé

Type de médiaapplication/problem+json
object
type
obligatoire
string format : uri
title
obligatoire
string
status
obligatoire
integer
detail
string
code
obligatoire
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplegénéré
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}

Introuvable

Type de médiaapplication/problem+json
object
type
obligatoire
string format : uri
title
obligatoire
string
status
obligatoire
integer
detail
string
code
obligatoire
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplegénéré
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}

Échec de la validation (errors[] : invalid_codicefiscale, codicefiscale_mismatch, invalid, age_below_minimum, not_writable)

Limite de débit atteinte

Type de médiaapplication/problem+json
object
type
obligatoire
string format : uri
title
obligatoire
string
status
obligatoire
integer
detail
string
code
obligatoire
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplegénéré
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}

Erreur interne

Type de médiaapplication/problem+json
object
type
obligatoire
string format : uri
title
obligatoire
string
status
obligatoire
integer
detail
string
code
obligatoire
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplegénéré
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}