Crear una dirección de usuario

API operation: Abrir la operación en la Referencia de la API

Usa POST /users/{user_id}/addresses para crear una dirección para un usuario. La operación pública actual es Address.register.

El comportamiento descrito requiere autenticación. Los administradores y agentes pueden actuar en nombre de otro usuario; el user_id de los demás solicitantes autenticados debe coincidir con el de la ruta. La operación obtiene de la ruta el usuario que se almacenará. Cuando default es true, se quita la marca predeterminada de las demás direcciones de ese usuario.

const response = await ordering.users(userId).addresses(addressData).save();

Esta sintaxis del SDK es histórica. Confirma el paquete y la versión antes de usarla. Consulta el modelo de dirección de usuario para conocer campos representativos.

Referencia de OpenAPI

Operación: POST /users/{user_id}/addresses

Parámetros de ruta

Nombre	Tipo	Obligatorio	Descripción
user_id	integer	Sí	—

Parámetros de encabezado

Nombre	Tipo	Obligatorio	Descripción
X-Socket-Id-X	string	No	—

Campos del cuerpo de la solicitud

Nombre	Tipo	Obligatorio
address	any	No
address_notes	any	No
cellphone	any	No
city	any	No
country	any	No
country_code	any	No
default	boolean	No
external_id	any	No
internal_number	any	No
lastname	any	No
locality	any	No
location	string	No
middle_name	any	No
name	any	No
neighborhood	any	No
phone	any	No
route	any	No
second_lastname	any	No
state	any	No
state_code	any	No
street_number	any	No
sublocality	any	No
user_id	number	Sí
zipcode	any	No

Respuestas

Código	Descripción
200	Respuesta exitosa. El contenido de result varía según la operación y se devuelve como JSON.
400	Respuesta de error (error=true). Los errores de validación y de negocio comparten este código.
401	Envelope de error: sesión ausente, inválida, o nivel de usuario fuera de los permitidos. Respuesta de error para el código declarado por la operación. Consulta result para ver los detalles disponibles. Envelope de error: el proyecto no existe o no tiene una suscripción activa.
404	Respuesta vacía: la versión de API solicitada no está admitida.
429	Envelope de error: se excedió un límite de consumo del proyecto (o el sujeto está baneado). Lleva Retry-After y X-RateLimit-Limit/Remaining/Reset/Scope/Key.
500	Respuesta de error: falló la búsqueda o inicialización del proyecto.
503	Envelope de error: la aplicación está temporalmente en mantenimiento. Envelope de error: el proyecto está temporalmente en mantenimiento, o los límites de consumo no se pudieron evaluar y el límite aplicable está configurado con on_error = closed (cabecera Retry-After: 1).

Abrir esta operación en la Referencia de la API