Crear una cuenta de Vimine para una persona (desde el servidor)
const url = 'https://api.vimine.network/v1/signup';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"email":"hello@example.com","first_name":"example","last_name":"example","phone":"example","dob":"2026-04-15","gender":"M","birthplace":"example","birth_country":"example","codicefiscale":"example","codicefiscale_confirmed":true,"locale":"example","accept_terms":{"version":"example","sha256":"example"},"acknowledge_privacy":{"version":"example","sha256":"example"}}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.vimine.network/v1/signup \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "email": "hello@example.com", "first_name": "example", "last_name": "example", "phone": "example", "dob": "2026-04-15", "gender": "M", "birthplace": "example", "birth_country": "example", "codicefiscale": "example", "codicefiscale_confirmed": true, "locale": "example", "accept_terms": { "version": "example", "sha256": "example" }, "acknowledge_privacy": { "version": "example", "sha256": "example" } }'Crea la identidad y envía a la persona el correo que confirma la dirección y le permite elegir una contraseña. Responde siempre 202: nunca se revela si la dirección ya tenía una cuenta (en su lugar, se avisa por correo al titular de la dirección). Solo tokens de cliente (identity:signup); acepta Idempotency-Key.
Autorizaciones
Sección titulada «Autorizaciones»Cuerpo de la peticiónobligatorio
Sección titulada «Cuerpo de la peticiónobligatorio»object
Solo demográfico: no se coteja
Comune (nacidos en Italia) o ciudad, texto libre (nacidos en el extranjero)
ISO 3166-1 alpha-2
Se valida y se coteja con los demás campos cuando está presente
La persona confirma un código que no coincide con sus datos (422 codicefiscale_mismatch con confirmable: true)
El idioma de la página que ha rellenado la persona (un idioma de la plataforma — it, en, …; cualquier otra etiqueta se reduce a uno de los de la plataforma: en-GB → en, zh-TW → zh-Hant). Decide el idioma de los correos que siguen y se convierte en la preferencia de una cuenta NUEVA; una cuenta existente conserva la suya. Los valores no admitidos se ignoran
Las condiciones de la cuenta (platform_terms) que la persona ha aceptado en tu sitio — opcional, pero cuando se envía debe nombrar la versión en vigor
object
La etiqueta de la versión en vigor que se ha mostrado (GET /v1/legal/{kind})
El hash de su plantilla, cuando se publica
La política de privacidad de la plataforma (platform_privacy) que la persona ha leído en tu sitio — opcional, misma regla
object
La etiqueta de la versión en vigor que se ha mostrado (GET /v1/legal/{kind})
El hash de su plantilla, cuando se publica
Respuestas
Sección titulada «Respuestas»Aceptada
object
Ejemplo
{ "status": "accepted"}Petición no válida
object
object
Ejemplogenerado
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example", "code": "example", "request_id": "example", "errors": [ { "field": "example", "code": "example", "message": "example" } ]}Credenciales ausentes o no válidas
object
object
Ejemplogenerado
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example", "code": "example", "request_id": "example", "errors": [ { "field": "example", "code": "example", "message": "example" } ]}No permitido
object
object
Ejemplogenerado
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example", "code": "example", "request_id": "example", "errors": [ { "field": "example", "code": "example", "message": "example" } ]}No encontrado
object
object
Ejemplogenerado
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example", "code": "example", "request_id": "example", "errors": [ { "field": "example", "code": "example", "message": "example" } ]}Límite de frecuencia superado
object
object
Ejemplogenerado
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example", "code": "example", "request_id": "example", "errors": [ { "field": "example", "code": "example", "message": "example" } ]}Error interno
object
object
Ejemplogenerado
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example", "code": "example", "request_id": "example", "errors": [ { "field": "example", "code": "example", "message": "example" } ]}