Ver .md Abrir en ChatGPT Abrir en Claude

👤 Perfil

Autenticación Requerida

Incluir en todos los endpoints de esta sección el header: Authorization: Bearer {token}

Parámetro Multi-Tenant: client_uuid

Si operas como Casa de Software, puedes actualizar el perfil del usuario de una de tus sub-cuentas agregando ?client_uuid={{client_uuid}} en los endpoints PUT. GET /profile y GET /profile/types no lo usan: siempre responden sobre el usuario del token.

👤 Gestión del Perfil

GET /profile — Obtener Datos del Usuario

GET {{url}}/profile
Authorization: Bearer {token}
Accept: application/json

Descripción: Retorna la información del usuario dueño del token y su tipo de usuario. Es equivalente a GET /auth/user.

✅ Respuesta Exitosa (HTTP 200)

{
  "dataRecords": {
    "data": [
      {
        "id": 1,
        "type_id": 2,
        "first_name": "JUAN",
        "last_name": "PEREZ",
        "email": "usuario@miempresa.com",
        "avatar": "users/1/profile/avatar.png",
        "active": 1,
        "name": "JUAN PEREZ",
        "avatarUrl": "https://sandbox-api.matias-api.com/storage/users/1/profile/avatar.png",
        "user_type": {
          "id": 2,
          "user_type_name": "DESARROLLADOR",
          "type": 2,
          "active": 1
        }
      }
    ]
  },
  "success": true
}

❌ No Autenticado (HTTP 401)

Requiere Accept: application/json; sin esa cabecera, la respuesta es una redirección (HTTP 302).

{
  "message": "Unauthenticated."
}

GET /profile/types — Listar Tipos de Usuario

GET {{url}}/profile/types
Authorization: Bearer {token}
Accept: application/json

Descripción: Devuelve el catálogo de tipos de usuario, el valor de type_id en el perfil y en la respuesta del login.

`type_id`	Tipo	Quién lo tiene
`1`	ADMINISTRADOR	Administración de la plataforma
`2`	DESARROLLADOR	Casa de Software / cuenta principal creada con `POST /register`
`3`	EMPRESA	No se asigna con `POST /register` ni al crear sub-cuentas
`4`	USUARIO	No se asigna con `POST /register` ni al crear sub-cuentas
`5`	CLIENTE	Usuario de una sub-cuenta creada por una Casa de Software (`POST /company/{uuid}/customer`)

✅ Respuesta Exitosa (HTTP 200)

{
  "records": [
    {
      "id": 1,
      "user_type_name": "ADMINISTRADOR",
      "type": 1,
      "active": 1
    },
    {
      "id": 2,
      "user_type_name": "DESARROLLADOR",
      "type": 2,
      "active": 1
    }
  ],
  "success": true
}

PUT /profile/{id} — Actualizar Perfil de Usuario

PUT {{url}}/profile/{id}?client_uuid={{client_uuid}}
Authorization: Bearer {token}
Content-Type: application/json
Accept: application/json

Problema conocido

A la fecha, este endpoint valida la petición y responde 200, pero no guarda los cambios de nombre, apellido ni avatar. No lo uses todavía para actualizar el perfil: para cambiar la imagen, usa PUT /profile/{id}/image, y para el correo, PUT /profile/update-email.

Parámetros:

Nombre	Ubicación	Requerido	Descripción
`id`	path	✅ Sí	ID del usuario. Debe ser el usuario de la empresa del token (o de la sub-cuenta indicada en `client_uuid`).
`client_uuid`	query	No	UUID del cliente (Casa de Software).
`records`	body	✅ Sí	Cadena JSON (`stringified JSON`) con los campos a cambiar.

Campos dentro de records:

Campo	Tipo	Descripción
`first_name`	`string`	Nombre
`last_name`	`string`	Apellido
`imgdata`	`string`	Opcional. Imagen del avatar en Base64 con prefijo Data URI
`imgname`	`string`	Nombre del archivo de la imagen. Obligatorio si se envía `imgdata`

Cualquier otro campo se ignora. El correo no se cambia aquí: usa PUT /profile/update-email.

Body (JSON):

{
  "records": "{\"first_name\":\"JUAN\",\"last_name\":\"PEREZ\"}"
}

✅ Respuesta (HTTP 200)

Devuelve el usuario tal como estaba antes de la petición.

{
  "dataRecords": {
    "data": {
      "id": 1,
      "type_id": 2,
      "first_name": "JUAN",
      "last_name": "PEREZ",
      "email": "usuario@miempresa.com",
      "avatar": "users/1/profile/avatar.png",
      "active": 1,
      "name": "JUAN PEREZ",
      "avatarUrl": "https://sandbox-api.matias-api.com/storage/users/1/profile/avatar.png",
      "user_type": {
        "id": 2,
        "user_type_name": "DESARROLLADOR",
        "type": 2,
        "active": 1
      }
    }
  },
  "success": true
}

❌ El ID no Corresponde al Usuario (HTTP 400)

{
  "message": "El usuario autenticado no coincide con el ID proporcionado",
  "success": false
}

❌ Falta records (HTTP 422)

Se recibe si se envían los campos sueltos en el body en lugar de dentro de records.

{
  "message": "El campo records es requerido",
  "errors": {
    "records": [
      "El campo records es requerido"
    ]
  }
}

Si records no es un JSON válido, el mensaje es El campo records debe ser un JSON válido.

PUT /profile/update-email — Actualizar Correo Electrónico

PUT {{url}}/profile/update-email?client_uuid={{client_uuid}}
Authorization: Bearer {token}
Content-Type: application/json
Accept: application/json

Descripción: Cambia el correo electrónico del usuario. El nuevo correo no puede estar en uso por otro usuario. La API envía automáticamente un correo de verificación a la nueva dirección.

El correo queda sin verificar

Tras el cambio, el correo queda sin verificar: hasta abrir el enlace enviado a la nueva dirección, POST /auth/login responde HTTP 404 con El correo electrónico no ha sido verificado. Comuníquese con el administrador. Los tokens ya emitidos siguen funcionando. Si el correo no llega, pide uno nuevo con POST /email/verification-notification.

Parámetros:

Nombre	Ubicación	Requerido	Descripción
`client_uuid`	query	No	UUID del cliente (Casa de Software).
`email`	body	✅ Sí	Nuevo correo (formato válido, máx. 255, no usado por otro usuario).

Body (JSON):

{
  "email": "nuevo-correo@miempresa.com"
}

✅ Respuesta Exitosa (HTTP 200)

{
  "message": "Correo electrónico actualizado exitosamente. Se ha enviado un correo de verificación a tu nuevo email.",
  "dataRecords": {
    "data": {
      "email": "nuevo-correo@miempresa.com",
      "email_verified_at": null,
      "previous_email": "usuario@miempresa.com",
      "verification_sent": true
    }
  },
  "success": true
}

❌ Error de Validación (HTTP 422)

{
  "message": "Validación fallida",
  "errors": {
    "email": [
      "El correo electrónico ya está en uso, por favor elige otro correo electrónico. Si este es tu correo electrónico, por favor inicia sesión con él."
    ]
  },
  "success": false
}

Otros mensajes de errors.email: El correo electrónico es obligatorio, El correo electrónico debe ser una dirección válida y El correo electrónico no puede exceder 255 caracteres.

PUT /profile/{id}/image — Actualizar Imagen de Perfil

PUT {{url}}/profile/{id}/image?client_uuid={{client_uuid}}
Authorization: Bearer {token}
Content-Type: application/json
Accept: application/json

Descripción: Permite actualizar el avatar del usuario enviando la imagen en Base64.

Parámetros:

Nombre	Ubicación	Requerido	Descripción
`id`	path	✅ Sí	ID del usuario. Debe ser el usuario de la empresa del token (o de la sub-cuenta indicada en `client_uuid`).
`client_uuid`	query	No	UUID del cliente (Casa de Software).
`records`	body	✅ Sí	Cadena JSON (`stringified JSON`) con los campos de la imagen.

Campos dentro de records:

Campo	Tipo	Requerido	Descripción
`id`	`integer`	✅ Sí	El mismo ID del usuario del path. Sin él, la imagen se sube pero el avatar del perfil no cambia
`imgdata`	`string`	✅ Sí	Imagen codificada en Base64 con prefijo Data URI (`data:image/png;base64,...`)
`imgname`	`string`	✅ Sí	Nombre del archivo, con extensión (por ejemplo, `avatar.png`)

Body (JSON):

{
  "records": "{\"id\":1,\"imgname\":\"avatar.png\",\"imgdata\":\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...\"}"
}

💡 Guía para Desarrolladores — Imagen en Base64

Envía la imagen del avatar codificada en Base64 con prefijo Data URI en el campo imgdata, junto con id e imgname, dentro de records.

JavaScript / Node.js
PHP
Python
Postman

import fs from 'fs';
import axios from 'axios';

const imgBuffer = fs.readFileSync('avatar.png');
const base64Img = 'data:image/png;base64,' + imgBuffer.toString('base64');

const response = await axios.put(`${url}/profile/${userId}/image`, {
  records: JSON.stringify({ id: userId, imgname: 'avatar.png', imgdata: base64Img })
}, {
  headers: {
    'Authorization': 'Bearer ' + token,
    'Content-Type': 'application/json',
    'Accept': 'application/json'
  }
});

<?php
$imgData = file_get_contents('avatar.png');
$base64Img = 'data:image/png;base64,' . base64_encode($imgData);

$payload = json_encode(['records' => json_encode([
    'id'      => $userId,
    'imgname' => 'avatar.png',
    'imgdata' => $base64Img,
])]);

$ch = curl_init("{$url}/profile/{$userId}/image");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $token,
        'Content-Type: application/json',
        'Accept: application/json'
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

import base64
import json
import requests

with open("avatar.png", "rb") as f:
    b64_img = "data:image/png;base64," + base64.b64encode(f.read()).decode("utf-8")

response = requests.put(
    f"{url}/profile/{userId}/image",
    json={"records": json.dumps({"id": userId, "imgname": "avatar.png", "imgdata": b64_img})},
    headers={
        "Authorization": f"Bearer {token}",
        "Content-Type": "application/json",
        "Accept": "application/json"
    }
)

// Pre-request Script
const records = {
    id: Number(pm.environment.get('user_id')),
    imgname: "avatar.png",
    imgdata: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
};

const payload = { records: JSON.stringify(records) };
pm.request.body.mode = 'raw';
pm.request.body.raw = JSON.stringify(payload);
pm.request.headers.add({key: 'Content-Type', value: 'application/json'});

✅ Respuesta (HTTP 200)

Devuelve el usuario tal como estaba antes de la petición. Consulta GET /profile para ver el nuevo avatarUrl.

{
  "dataRecords": {
    "data": {
      "id": 1,
      "type_id": 2,
      "first_name": "JUAN",
      "last_name": "PEREZ",
      "email": "usuario@miempresa.com",
      "avatar": "users/1/profile/avatar-anterior.png",
      "active": 1,
      "name": "JUAN PEREZ",
      "avatarUrl": "https://sandbox-api.matias-api.com/storage/users/1/profile/avatar-anterior.png",
      "user_type": {
        "id": 2,
        "user_type_name": "DESARROLLADOR",
        "type": 2,
        "active": 1
      }
    }
  },
  "success": true
}

❌ Imagen Ausente o Vacía (HTTP 400)

Sin imgdata (o si records no es un JSON válido):

{
  "message": "No se proporcionó la imagen en base64",
  "success": false
}

Con imgdata vacío (por ejemplo, solo el prefijo Data URI):

{
  "message": "La imagen en base64 está vacía",
  "success": false
}

Si {id} no es el usuario de la empresa, la respuesta es 400 con El usuario autenticado no coincide con el ID proporcionado. Sin imgname, la API responde 500.

👤 Gestión del Perfil​

👤 Gestión del Perfil