🔐 Autenticación y Gestión de Cuenta

La autenticación en SpeckUIX se realiza mediante tokens Bearer. El proceso completo incluye la creación de cuenta, verificación de correo electrónico y la gestión posterior de la cuenta.

👤 Crear una Cuenta

Primer Paso

El primer paso es crear una cuenta. Al crearla, recibirás un accountId que servirá como tu token de autenticación.

Solicitud de Creación de Cuenta

Ver ejemplo de solicitud

curl --request POST \
  --url 'https://api.speckuix.page/api/account' \
  --header 'content-type: multipart/form-data' \
  --form username=johndoe \
  --form password=M1P@ssw0rd \
  --form email=johndoe@example.com \
  --form 'name=John Doe'

Parámetros Requeridos

Parámetro	Tipo	Descripción	Requerido
username	string	Nombre de usuario único	✅
password	string	Contraseña segura	✅
email	string	Correo electrónico válido	✅
name	string	Nombre completo	✅

Ver ejemplo de respuesta

{
   "accountId": "555aabbcc123"
}

Importante

Guarda de forma segura el accountId que recibes en la respuesta. Este identificador es fundamental ya que:

• Se utiliza como token de autenticación (Bearer token)
• Es necesario para verificar tu cuenta
• No puede ser recuperado si lo pierdes
• Es requerido para actualizar o eliminar tu cuenta

✉️ Verificación de Correo Electrónico

La verificación del correo electrónico es necesaria en dos casos:

1. Después de crear una cuenta nueva
2. Después de actualizar tu dirección de correo electrónico

Proceso de Verificación

1. 📧 Recibirás un correo electrónico con un código de verificación
2. 📋 Copia el código recibido en tu correo
3. 🔄 Realiza una solicitud al endpoint de verificación

Reenvío del Código de Verificación

Si no recibiste el código o este expiró, puedes solicitar un nuevo código de verificación:

Ver ejemplo de solicitud de reenvío

curl --request PATCH \
  --url 'https://api.speckuix.page/api/account' \
  --header 'Authorization: Bearer 555aabbcc123'

tip

El nuevo código de verificación será enviado al correo electrónico asociado a tu cuenta.

Endpoint de Verificación

Ver ejemplo de solicitud

curl --request POST \
  --url 'https://api.speckuix.page/api/account/verification-code' \
  --header 'Authorization: Bearer 555aabbcc123' \
  --header 'content-type: multipart/form-data' \
  --form code=172081

Parámetro	Tipo	Descripción	Requerido
code	string	Código recibido en el correo	✅

🔑 Uso del Token Bearer

El accountId debe incluirse como token Bearer en el encabezado de autorización:

Authorization: Bearer 555aabbcc123

Ejemplo de Solicitud con Autenticación

curl "{{apiUrl}}/api/endpoint" \
  -H "Authorization: Bearer 555aabbcc123"

⚙️ Gestión de Cuenta

Obtener Información de la Cuenta

Ver ejemplo de solicitud

curl --request GET \
  --url 'https://api.speckuix.page/api/account' \
  --header 'Authorization: Bearer 555aabbcc123'

Actualizar Información de la Cuenta

Actualización Flexible

Puedes actualizar uno o varios campos. No es necesario enviar todos los campos, solo aquellos que deseas modificar.

Parámetros Actualizables

Parámetro	Tipo	Descripción	Requerido
name	string	Nuevo nombre completo	❌
email	string	Nuevo correo electrónico	❌
password	string	Nueva contraseña	❌

Ver ejemplos de actualizaciones

Actualización Completa

curl --request PUT \
  --url 'https://api.speckuix.page/api/account' \
  --header 'Authorization: Bearer 555aabbcc123' \
  --header 'content-type: multipart/form-data' \
  --form 'name=John Doe' \
  --form 'email=johndoe@example.com' \
  --form 'password=M1P@ssw0rd'

Solo Nombre

curl --request PUT \
  --url 'https://api.speckuix.page/api/account' \
  --header 'Authorization: Bearer 555aabbcc123' \
  --header 'content-type: multipart/form-data' \
  --form 'name=John Doe'

Nombre y Correo

curl --request PUT \
  --url 'https://api.speckuix.page/api/account' \
  --header 'Authorization: Bearer 555aabbcc123' \
  --header 'content-type: multipart/form-data' \
  --form 'name=John Doe' \
  --form 'email=johndoe@example.com'

Recordatorio

Si actualizas el correo electrónico, necesitarás verificarlo nuevamente usando el endpoint de verificación.

Eliminar Cuenta

Ver ejemplo de solicitud

curl --request DELETE \
  --url 'https://api.speckuix.page/api/account' \
  --header 'Authorization: Bearer 555aabbcc123'

🛡️ Mejores Prácticas de Seguridad

1. 🔒 Mantén tu token de API (accountId) seguro y nunca lo compartas públicamente
2. 🔑 Usa contraseñas seguras que incluyan:
   • Mayúsculas
   • Minúsculas
   • Números
   • Caracteres especiales
3. ✉️ Verifica tu correo electrónico lo antes posible
4. 🔐 Utiliza variables de entorno para almacenar tus tokens en desarrollo
5. ⚠️ Nunca subas tokens al control de versiones
6. 🔄 Cambia tu contraseña periódicamente