SMSHook
Callback de estado de SMS
URL
Configuración definida por el usuario en la página
Configuración definida por el usuario en la página
Este bloque de código se muestra en una ventana flotante
Content-Type:
application/json; charset=utf-8
application/json; charset=utf-8
Este bloque de código se muestra en una ventana flotante
Método de solicitud HTTP
post
post
Este bloque de código se muestra en una ventana flotante
Encabezados de la solicitud
| Encabezado | Tipo | Descripción |
|---|---|---|
| X-SMSHook-Signature | string | firma |
| X-SMSHook-Timestamp | long | marca de tiempo de generación del mensaje |
| X-SMSHook-AppKey | string | clave de aplicación |
| X-SMSHook-Version | string | versión |
Cuerpo de la solicitud
| Parámetro | Tipo | Descripción |
|---|---|---|
| message_id | string | ID del mensaje |
| from | string | remitente (vacío en el mensaje template_approval) |
| to | string | destinatario (vacío en target, sent y template_approval) |
| server | string | SMS |
| itime | long | marca de tiempo de generación del mensaje |
| custom_args | json | campos definidos por el cliente |
| status | json | callback de estado del mensaje |
Mensaje de estado target de SMS
status
| Parámetro | Tipo | Descripción |
|---|---|---|
| message_status | string | target |
| status_data | json object | datos de estado |
| message | string | solicitud realizada correctamente |
| template_id | int | ID de la plantilla de SMS |
| template_type | int | tipo de contenido de SMS |
| label_id | int | ID de la etiqueta de SMS |
| user_id | int | ID de usuario |
| sms_user | string | SMS_USER |
| sms_ids | array | array de IDs de SMS del destinatario |
| to | array | array de destinatarios |
| msg_type | int | tipo de SMS |
{
"server": "sms",
"message_id": "1679392394031_15_17153_881599_c1fjwa",
"itime": 1679392394061,
"status": {
"message_status": "target",
"status_data": {
"user_id": 15,
"to": [
"+8618871186627",
"008615727024341"
],
"msg_type": 2,
"template_id": 881599,
"message": "successfully request",
"sms_user": "xiaojinmintest",
"sms_ids": [
"1679392394031_15_17153_881599_c1fjwa$+8618871186627",
"1679392394031_15_17153_881599_c1fjwa$008615727024341"
],
"template_type": 2,
"label_id": 0
}
}
}
{
"server": "sms",
"message_id": "1679392394031_15_17153_881599_c1fjwa",
"itime": 1679392394061,
"status": {
"message_status": "target",
"status_data": {
"user_id": 15,
"to": [
"+8618871186627",
"008615727024341"
],
"msg_type": 2,
"template_id": 881599,
"message": "successfully request",
"sms_user": "xiaojinmintest",
"sms_ids": [
"1679392394031_15_17153_881599_c1fjwa$+8618871186627",
"1679392394031_15_17153_881599_c1fjwa$008615727024341"
],
"template_type": 2,
"label_id": 0
}
}
}
Este bloque de código se muestra en una ventana flotante
Mensaje de estado sent de SMS
status
| Parámetro | Tipo | Descripción |
|---|---|---|
| message_status | string | sent |
| status_data | json object | datos de estado |
| message | string | enviado correctamente |
| template_id | int | ID de la plantilla de SMS |
| template_type | int | tipo de contenido de SMS |
| label_id | int | ID de la etiqueta de SMS |
| user_id | int | ID de usuario |
| sms_user | string | SMS_USER |
| sms_ids | array | array de IDs de SMS del destinatario |
| to | array | array de destinatarios |
| msg_type | int | tipo de SMS |
{
"server": "sms",
"message_id": "1679392394031_15_17153_881599_c1fjwa",
"itime": 1679392394061,
"status": {
"message_status": "sent",
"status_data": {
"user_id": 15,
"to": [
"+8618871186627",
"008615727024341"
],
"msg_type": 2,
"template_id": 881599,
"message": "successfully sent",
"sms_user": "xiaojinmintest",
"sms_ids": [
"1679392394031_15_17153_881599_c1fjwa$+8618871186627",
"1679392394031_15_17153_881599_c1fjwa$008615727024341"
],
"template_type": 2,
"label_id": 0
}
}
}
{
"server": "sms",
"message_id": "1679392394031_15_17153_881599_c1fjwa",
"itime": 1679392394061,
"status": {
"message_status": "sent",
"status_data": {
"user_id": 15,
"to": [
"+8618871186627",
"008615727024341"
],
"msg_type": 2,
"template_id": 881599,
"message": "successfully sent",
"sms_user": "xiaojinmintest",
"sms_ids": [
"1679392394031_15_17153_881599_c1fjwa$+8618871186627",
"1679392394031_15_17153_881599_c1fjwa$008615727024341"
],
"template_type": 2,
"label_id": 0
}
}
}
Este bloque de código se muestra en una ventana flotante
Mensaje de estado delivered de SMS
status
| Parámetro | Tipo | Descripción |
|---|---|---|
| message_status | string | delivered |
| status_data | json object | datos de estado |
| message | string | entregado correctamente |
| template_id | int | ID de la plantilla de SMS |
| template_type | int | tipo de contenido de SMS |
| label_id | int | ID de la etiqueta de SMS |
| user_id | int | ID de usuario |
| sms_user | string | SMS_USER |
| sms_id | string | ID de SMS |
| msg_count | int | número de mensajes SMS |
| msg_type | int | tipo de SMS |
| outbound_time | string | hora de solicitud al canal |
| receipt_time | string | hora de recepción |
{
"server": "sms",
"message_id": "1679387065399_15_17155_881597_0poco8$+115927992951",
"to": "+115927992951",
"itime": 1679388949000,
"status": {
"message_status": "delivered",
"status_data": {
"outbound_time": "2023-03-21 16:55:25",
"receipt_time": "2023-03-21 16:55:49",
"sms_id": "1679387065399_15_17155_881597_0poco8$+115927992951",
"user_id": 15,
"msg_type": 2,
"template_id": 881597,
"message": "successfully delivered",
"sms_user": "huangli_SMS",
"template_type": 1,
"msg_count": 1,
"label_id": 0
}
}
}
{
"server": "sms",
"message_id": "1679387065399_15_17155_881597_0poco8$+115927992951",
"to": "+115927992951",
"itime": 1679388949000,
"status": {
"message_status": "delivered",
"status_data": {
"outbound_time": "2023-03-21 16:55:25",
"receipt_time": "2023-03-21 16:55:49",
"sms_id": "1679387065399_15_17155_881597_0poco8$+115927992951",
"user_id": 15,
"msg_type": 2,
"template_id": 881597,
"message": "successfully delivered",
"sms_user": "huangli_SMS",
"template_type": 1,
"msg_count": 1,
"label_id": 0
}
}
}
Este bloque de código se muestra en una ventana flotante
Mensaje de estado delivered_failed de SMS
status
| Parámetro | Tipo | Descripción |
|---|---|---|
| message_status | string | delivered_failed |
| status_data | json object | datos de estado |
| template_id | int | ID de la plantilla de SMS |
| template_type | int | tipo de contenido de SMS |
| label_id | int | ID de la etiqueta de SMS |
| user_id | int | ID de usuario |
| sms_user | string | SMS_USER |
| sms_id | string | ID de SMS |
| outbound_time | string | hora de solicitud al canal |
| receipt_time | string | hora de recepción |
| msg_count | int | número de mensajes SMS |
| msg_type | int | tipo de SMS |
| error_code | int | código de error |
| error_detail | json | detalle del error |
| message | string | registro de error |
| sub_stat | int | subcategoría de error; 4xx indica un fallo de procesamiento para la categoría, 5XX indica un fallo de envío para la categoría |
| sub_stat_desc | string | mensaje de error |
{
"server": "sms",
"message_id": "1679392394031_15_17153_881599_c1fjwa$+8618871186627",
"to": "+8618871186627",
"itime": 1679392394120,
"status": {
"message_status": "delivered_failed",
"error_code": 480,
"error_detail": {
"message": "smsworker:local policy restrictions",
"sub_stat": 480,
"sub_stat_desc": "sending type not supported"
},
"status_data": {
"sms_id": "1679392394031_15_17153_881599_c1fjwa$+8618871186627",
"user_id": 15,
"msg_type": 2,
"template_id": 881599,
"outbound_time": "2023-03-21 17:53:14",
"receipt_time":"2023-03-21 17:53:37",
"sms_user": "xiaojinmintest",
"template_type": 2,
"msg_count": 1,
"label_id": 0
}
}
}
{
"server": "sms",
"message_id": "1679392394031_15_17153_881599_c1fjwa$+8618871186627",
"to": "+8618871186627",
"itime": 1679392394120,
"status": {
"message_status": "delivered_failed",
"error_code": 480,
"error_detail": {
"message": "smsworker:local policy restrictions",
"sub_stat": 480,
"sub_stat_desc": "sending type not supported"
},
"status_data": {
"sms_id": "1679392394031_15_17153_881599_c1fjwa$+8618871186627",
"user_id": 15,
"msg_type": 2,
"template_id": 881599,
"outbound_time": "2023-03-21 17:53:14",
"receipt_time":"2023-03-21 17:53:37",
"sms_user": "xiaojinmintest",
"template_type": 2,
"msg_count": 1,
"label_id": 0
}
}
}
Este bloque de código se muestra en una ventana flotante
Callback de respuesta de SMS
URL
Configuración definida por el usuario en la página
Configuración definida por el usuario en la página
Este bloque de código se muestra en una ventana flotante
Content-Type:
application/json; charset=utf-8
application/json; charset=utf-8
Este bloque de código se muestra en una ventana flotante
Método de solicitud HTTP
post
post
Este bloque de código se muestra en una ventana flotante
Encabezados de la solicitud
| Encabezado | Tipo | Descripción |
|---|---|---|
| X-SMSHook-Signature | string | firma |
| X-SMSHook-Timestamp | long | marca de tiempo de generación del mensaje |
| X-SMSHook-AppKey | string | clave de aplicación |
| X-SMSHook-Version | string | versión |
Cuerpo de la solicitud
| Parámetro | Tipo | Descripción |
|---|---|---|
| message_id | string | ID del mensaje |
| to | string | destinatario |
| server | string | SMS |
| itime | long | marca de tiempo de generación del mensaje |
| custom_args | json | campos definidos por el cliente |
| response | json | callback de respuesta del mensaje |
Mensaje de respuesta de reply de SMS
response
| Parámetro | Tipo | Descripción |
|---|---|---|
| event | string | reply |
| response_data | json object | datos de respuesta |
| template_id | int | ID de la plantilla de SMS |
| template_type | int | tipo de contenido de SMS |
| label_id | int | ID de la etiqueta de SMS |
| user_id | int | ID de usuario |
| sms_user | string | SMS_USER |
| sms_id | string | ID de SMS |
| reply_content | int | contenido de la respuesta |
| reply_time | string | hora de respuesta |
| msg_type | int | tipo de SMS |
{
"server": "sms",
"message_id": "1679364048767_15_15814_905354_3y5z9a$17858502021",
"to": "17858502021",
"itime": 1679392394128,
"response": {
"event": "reply",
"response_data": {
"sms_id": "1679364048767_15_15814_905354_3y5z9a$17858502021",
"user_id": 15,
"reply_time": "2023-03-21 10:07:17",
"msg_type": 2,
"template_id": 905354,
"sms_user": "cpx_sms",
"template_type": 2,
"reply_content": "T",
"label_id": 0
}
}
}
{
"server": "sms",
"message_id": "1679364048767_15_15814_905354_3y5z9a$17858502021",
"to": "17858502021",
"itime": 1679392394128,
"response": {
"event": "reply",
"response_data": {
"sms_id": "1679364048767_15_15814_905354_3y5z9a$17858502021",
"user_id": 15,
"reply_time": "2023-03-21 10:07:17",
"msg_type": 2,
"template_id": 905354,
"sms_user": "cpx_sms",
"template_type": 2,
"reply_content": "T",
"label_id": 0
}
}
}
Este bloque de código se muestra en una ventana flotante
Callback de estado de SMS
Mensaje de notificación template_approval de plantilla de SMS
notification
| Parámetro | Tipo | Descripción |
|---|---|---|
| event | string | template_approval |
| notification_data | json object | datos de respuesta |
| template_id | string | ID de la plantilla de SMS |
| template_type | int | tipo de contenido de SMS |
| user_id | string | ID de usuario |
| msg_type | int | tipo de SMS |
| approval_status | string | resultados de revisión de la plantilla |
| approval_message | string | información de revisión de la plantilla |
{
"server": "sms",
"message_id": "1679364048767_15_15864",
"to": "17858502021",
"itime": 1679392394179,
"notification": {
"event": "template_approval",
"notification_data": {
"user_id": 15,
"msg_type": 2,
"template_id": 905354,
"template_type": 2,
"approval_status": "1",
"approval_message": "pass"
}
}
}
{
"server": "sms",
"message_id": "1679364048767_15_15864",
"to": "17858502021",
"itime": 1679392394179,
"notification": {
"event": "template_approval",
"notification_data": {
"user_id": 15,
"msg_type": 2,
"template_id": 905354,
"template_type": 2,
"approval_status": "1",
"approval_message": "pass"
}
}
}
Este bloque de código se muestra en una ventana flotante
