Actualizar Cliente
Visión General
Este endpoint permite realizar actualizaciones en el registro de un cliente.
Detalles del Endpoint
Parámetro | Descripción |
---|---|
Endpoint | https://bre-b-sandbox.api.visionamos.passportfintech.com/v1/paas/entities/customers/{customer_id} |
Método | PATCH |
Encabezados | Content-Type: application/json, Authorization |
Autenticación | Token de Acceso (Bearer Token) |
Cuerpo de la Solicitud
Parámetro | Tipo | Descripción |
---|---|---|
id | String | Identificador único del objeto cliente. |
business_name | String | Nombre legal registrado del cliente. |
String | Correo electrónico de contacto del cliente. | |
mobile_phone_number | String | Número de teléfono móvil del cliente. |
Ejemplo de Solicitud
9
curl --location --request PATCH 'https://bre-b-develop.api.visionamos.passportfintech.com/v1/paas/entities/customers/7cb9de1b-d4b4-4036-9b7d-a49104a8f7f9' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
--data-raw '{
"id": "7cb9de1b-d4b4-4036-9b7d-a49104a8f7f9",
"business_name": "changing",
"email": "eAqpUh6u@example.com",
"mobile_phone_number": "573956158117"
}'
Cuerpo de la Respuesta
- Código HTTP: 200 OK
Ejemplo de Respuesta
3
3
{
"id": "7cb9de1b-d4b4-4036-9b7d-a49104a8f7f9"
}
Errores Comunes y Manejo
Código HTTP | Significado | Descripción |
---|---|---|
400 | Bad Request | Validación fallida (por ejemplo, campo faltante o inválido). |
401 | Unauthorized | Token Bearer ausente o inválido. |
403 | Forbidden | Alcance insuficiente o permisos de acceso insuficientes. |
404 | Not Found | El cliente con el ID proporcionado no existe. |
Buenas Prácticas
- Refresca los tokens OAuth antes de que expiren para evitar fallas de autenticación.
- Asegúrate de que el
customer_id
sea correcto antes de enviar la actualización. - Valida los datos de entrada (correo electrónico, número de teléfono) antes de enviar la petición.
- Registra cambios en clientes críticos para trazabilidad y auditoría.