EnglishEnvía tu primer mensaje en una tarde
Una API REST simple para enviar, rastrear y recibir SMS: autenticación de token, webhooks en tiempo real y SDK, sin nada exótico que aprender.
Tres movimientos, empiezan a entregarse.
Cada integración es el mismo arco corto: autenticar, enviar y luego realizar un seguimiento.
Envíe su clave de acceso como encabezado de token, con tipo de contenido: aplicación/json, en cada solicitud.
PUBLICAR un desde, hacia y contenido. La respuesta vuelve con un msgstr y un código de error inmediatamente.
PUBLICAMOS u OBTENEMOS un informe de estado en su URL de devolución de llamada en el momento en que un mensaje alcanza su estado final.
Una solicitud, en el idioma que ya utilizas
PUBLICAR su remitente, destinatario y contenido con un encabezado Token. La respuesta vuelve en el momento en que la aceptamos.
01curl -X POST https://secure.smslocal.com/api/service/enterprise-service/external/sms \02 -H "Token: $SMSLOCAL_TOKEN" \03 -H "Content-Type: application/json" \04 -d '{05 "from": "SMSLOCAL",06 "to": "14155550123",07 "content": "Your code is 481920."08 }'msgstr "9f2a7c10-4b2e-..."
dirección "monte"
código de error 0
guardar el msgstr – así es como rastreas este mensaje desde aquí.
Leer un mensaje de arriba a abajo
Los eventos de envío, estado y entrantes tienen la misma forma: apréndalo una vez.
ID de mensaje
msgstr: acuñado en el momento en que se crea un mensaje. Este es el identificador que utiliza para comprobar su estado más adelante.
Remitente
de: un número de teléfono o una identificación alfanumérica de hasta 11 caracteres, cualquiera que sea la identidad que vean sus destinatarios.
Beneficiario
a: el número al que se dirige el mensaje, incluido el código de país.
Codificación
codificación de datos: GSM7 admite 160 caracteres por pieza; cambie a Unicode y eso cae a 70. Vaya y se concatene en partes facturadas adicionales.
Dirección
dirección: cada mensaje es mt (lo enviaste) o mo (lo recibiste), la misma forma en ambos sentidos.
Código de error
código de error: devuelto en la respuesta de envío y en cada informe de estado. 0 significa aceptado; cualquier otra cosa te dice exactamente qué salió mal.
Un punto final, dos verbos
PUBLICAR para enviar, OBTENER para verificar el estado: la misma URL y el mismo encabezado del token en ambos sentidos.
Enviar
Envíe un mensaje y reciba un mensaje de texto y un código de error inmediatamente.
Devoluciones msgstr + código de errorPista
Busque un mensaje que ya envió para verificar su estado actual.
Devoluciones mensaje + estadoInformes de estado, en el momento en que suceden
Establezca una URL de devolución de llamada y cada entrega, error y respuesta entrante llegará allí como GET o POST, sin necesidad de sondeo.
Documentos para desarrolladores: preguntas frecuentes
Pase su clave de acceso en un encabezado Token en cada solicitud (Token: {accessKey}) junto con Content-Type: application/json.
Cada envío devuelve un msgstr. Indíquenos una URL de devolución de llamada y PUBLICAREMOS u OBTENEMOS un informe de estado en el momento en que el mensaje alcance su estado final: subfecha, fecha de finalización y el código de estado resultante incluido.
mt (terminado en móvil) es un mensaje que usted envió; mo (originado en un dispositivo móvil) es una respuesta que recibiste. Ambos usan la misma forma de objeto de mensaje.
La entrega se vuelve a intentar de acuerdo con la política de reintentos: nada se descarta silenciosamente, pero un punto final que nunca reconoce seguirá recibiendo reintentos.
160 caracteres en codificación GSM7 o 70 en Unicode. Si se supera el límite, el mensaje se concatena en varias partes, cada una de las cuales se factura por separado.