Crear usuario
Registra un nuevo usuario en el sistema. Permite crear usuarios con sus datos básicos.
Entorno
Sección titulada «Entorno»URL Base: https://api.guarani.app
Endpoint
Sección titulada «Endpoint»POST /usuariosEjemplo de solicitud
Sección titulada «Ejemplo de solicitud»curl -X POST "https://api.guarani.app/usuarios/" \ -H "Content-Type: application/json" \ -H "x-api-key: Bearer <access_token>" \ -d '{ "email": "[email protected]", "nombre": "Juan Perez", "whatsapp": "+5491176543210" }' | jqNota: Asegúrate de reemplazar
<access_token>con un token JWT válido proporcionado por el equipo Guarani. Importante:
Es imprescindible incluir un token de acceso válido en el encabezadox-api-keypara autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.
Encabezados de la solicitud
Sección titulada «Encabezados de la solicitud»| Encabezado | Valor | Descripción |
|---|---|---|
Content-Type | application/json | Indica que los datos se envían en formato JSON. |
x-api-key | Bearer <access_token> | Token de autenticación necesario para acceder al recurso. |
Descripción de Campos
Sección titulada «Descripción de Campos»| Parámetro | Tipo | Requerido | Tamaño | Descripción |
|---|---|---|---|---|
email | string | Sí | 100 | Correo electrónico válido del cliente. |
nombre | string | Sí | 100 | Nombre completo de la persona o razón social si es persona jurídica. |
whatsapp | string | Sí | 15 | Número de teléfono en formato internacional. Ej: +595XXXXXXXXX. |
Ejemplo de respuesta
Sección titulada «Ejemplo de respuesta»{ "success": true, "codigo": "201", "message": "Recurso creado con éxito.", "data": { "id": "7f5c3d42-9b1a-4e8c-921a-0a6d54c3fbc2", "nombre": "Juan Perez", "whatsapp": "+5491176543210" }}Recursos adicionales
Sección titulada «Recursos adicionales»Para más información sobre posibles errores y cómo manejarlos, consulta errores.