Actualizar configuración de firma

Actualiza una configuración de firma existente, permitiendo modificar el nombre de la firma. Tras la actualización, la firma vuelve al estado "Pendiente de revisión".

URL de solicitud

PUT https://smsapi.engagelab.com/v1/sign-configs/:signId

Validación de la llamada

Consulta Validación de la llamada para saber cómo realizar la autenticación de la API.

Ejemplo de solicitud

Encabezado de la solicitud

              
              PUT /v1/sign-configs/987654321  HTTP/1.1
Content-Type: application/json
Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

            

Cuerpo de la solicitud

              
              {
  "sign_name": "Nombre de la empresa"
}

            

Parámetros de solicitud

Parámetros de ruta

Parámetros del cuerpo de la solicitud

Parámetros de respuesta

Respuesta correcta

El código de estado HTTP es 200 y el cuerpo de la respuesta contiene los siguientes campos:

Ejemplo correcto

              
              {
  "code": 0,
  "message": "success"
}

            

Respuesta con error

El código de estado HTTP es 4xx/5xx y el cuerpo de la respuesta contiene los siguientes campos:

Ejemplo de error

              
              {
  "code": 400,
  "message": "can not update pending status sign"
}

            

Códigos de error

Mensajes de error comunes:

• invalid signId: formato del ID de firma incorrecto
• sign config not exist: la configuración de firma no existe
• sign_name already exist: el nombre de la firma ya existe
• can not update pending status sign: no se puede actualizar una firma en estado pendiente de revisión
• there are pending or running plans using current sign, can not update: hay planes pendientes de envío o en ejecución que usan esta firma, no se puede actualizar

Consideraciones

1. No se puede actualizar una firma en estado pendiente de revisión
2. Si hay planes de mensajes pendientes de envío o en ejecución que usan esta firma, no se puede actualizar
3. Tras la actualización, la firma vuelve al estado "Pendiente de revisión" (status=1)
4. El nombre de la firma no puede contener caracteres prohibidos: 【, 】, [, ]
5. El ID de la firma es un número de tipo cadena

Apéndice

Estado de la configuración de firma (status)