Zum Inhalt springen

Kontaktdaten und persönliche Angaben des Mitglieds aktualisieren

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

Schreibbar: phone, gender, locale und die Identifizierung — dob, birthplace, birth_country, codicefiscale. Eine Person wird über eine Steuernummer ODER über Geburtsdatum, Geburtsort und Geburtsland identifiziert; die Steuernummer ist optional und kann später ergänzt werden. Eine Steuernummer wird geprüft und mit dem gespeicherten Namen, dem Geburtsdatum und dem Ort abgeglichen — bei in Italien geborenen Personen mit der Gemeinde, bei allen anderen nur mit dem STAAT (birth_country); das Geschlecht wird nicht abgeglichen. Eine abweichende Steuernummer ergibt 422 codicefiscale_mismatch mit mismatches, hints (names_swapped) und confirmable: Ist confirmable gleich true, darf die Person bestätigen, dass es die Steuernummer auf ihrer Gesundheitskarte ist — senden Sie codicefiscale_confirmed: true —, und codicefiscale_check wird zu mismatch_confirmed.

Medientypapplication/json
object
phone
string
nullable
dob
string Format: date
nullable
gender
string
nullable
Erlaubte Werte: M F
birthplace

Gemeinde (in Italien geboren) oder Stadt, freier Text (im Ausland geboren)

string
nullable
birth_country

ISO 3166-1 alpha-2

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

Nur schreibbar: Die Person bestätigt eine Steuernummer, die nicht zu ihren Angaben passt (siehe confirmable)

boolean
locale

Die Sprache der Person; null löscht die Wahl. 422 unsupported bei einer Sprache, die die Plattform nicht anbietet

string
nullable
Erlaubte Werte: it en zh-Hans zh-Hant fr es de pt-BR

Das aktualisierte Profil

Medientypapplication/json
object
sub
erforderlich

Die Subject-Kennung dieser Person, wie im ID-Token

string
email
erforderlich
string Format: email
email_verified
erforderlich
boolean
first_name
string
nullable
last_name
string
nullable
phone
string
nullable
dob
string Format: date
nullable
gender

Nur statistisch

string
nullable
Erlaubte Werte: M F
birthplace
string
nullable
birth_country

ISO 3166-1 alpha-2

string
nullable
codicefiscale

Optional: Eine Person kann keine haben

string
nullable
codicefiscale_check

Wie die Person identifiziert ist. matched: eine Steuernummer, die zu ihren Angaben passt; mismatch_confirmed: eine abweichende Steuernummer, von der Person bestätigt; absent: keine Steuernummer — Geburtsdatum, Geburtsort und Geburtsland identifizieren sie; null: noch nicht identifiziert (sie kann keine Mitgliedschaft beantragen)

string
nullable
Erlaubte Werte: matched mismatch_confirmed absent
locale

Die Sprache, die die Person für die Plattform und ihre E-Mails gewählt hat; null: nie gewählt — dann gilt die Sprache der Anfrage, danach die des Vereins

string
nullable
Erlaubte Werte: it en zh-Hans zh-Hant fr es de pt-BR
updated_at
string Format: date-time
nullable
Beispiel
{
"gender": "M",
"codicefiscale_check": "matched",
"locale": "it"
}

Ungültige Anfrage

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}

Fehlende oder ungültige Zugangsdaten

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}

Nicht erlaubt

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}

Nicht gefunden

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}

Validierung fehlgeschlagen (errors[]: invalid_codicefiscale, codicefiscale_mismatch, invalid, age_below_minimum, not_writable)

Ratenlimit überschritten

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}

Interner Fehler

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}