API v0 - smsc/smsc-api-php GitHub Wiki

Desde '''SMS Compartidos''' ('''SMSC''') podés enviar mensajes de texto a cualquier celular del País (Argentina). Estos mensajes son enviados desde una serie de líneas activas, asegurando la entrega del mensaje.

API

Accedes a la api consultando el siguiente enlace: http://www.smsc.com.ar/api/0.3/?alias=XXXXXX&apikey=XXXXXXX&cmd=estado

Parámetros de la URL

Básicos

; alias''' : Tu alias de SMSC

; apikey : Tu apikey que obtienes en la sección Desarrolladores de SMSC.

; cmd : Tipo de operación que realizas. Valor predeterminado: "enviar".

Enviar un SMS

cmd=enviar: especifica la acción a realizar.

num=2627-000000: Destino. Se puede especificar sin guión (-), aunque no es recomendable. Puede agregarse varios números de destino, utilizando coma ,. Ejemplo: num=2627-000000,2627-000001

msj=HolaMundo!: El mensaje que será enviado. Ten en cuenta que los mensajes con más de 160 caracteres consumirán más crédito, al igual que los que poseen caracteres como las vocales con acento.

line={line_id}: (opcional) (sólo usuarios con líneas dedicadas) Permite elegir la línea por la que saldrá el mensaje, cuando el usuario posee más de una línea contratada. Si no se establece este parámetro, el sistema lo envía por la línea contratada que primero esté disponible.

Opcionales

priority=7: Valores de 1 a 7, sólo líneas dedicadas. Siendo 7 prioridad alta y 1 la más baja, siendo 5 el valor por defecto. Sólo se controla la prioridad del SMS en comparación a los encolados previamente; por lo que si se envían todos con prioridad 1 o todos con prioridad 7 será exactamente el mismo orden.

time=1532432468: Unix_Time_Stamp de a partir de qué hora debería ser enviado el SMS. Si no hay SMS encolados, se enviará inmediatamente a la hora seteada.

Consulta de Enviados

; cmd=enviados

; ultimoid=0 : Opcional. Puede espedificar el último ID de mensaje que consultó, para ahorrar ancho de banda y aumentar la velocidad de respuesta. Si coloca 0, recibirá los últimos 50 SMSC enviados.

; maxid=0 : Opcional. Puede especificar el máximo ID de mensaje que desea obtener en la respuesta, para consultar el estado de mensajes anteriores a los últimos 50. El intervalo es abierto, es decir, el mensaje con id = maxid no es incluido en la respuesta.

Consulta de Recibidos

; cmd=recibidos

; ultimoid=0 : Opcional. Puede espedificar el último ID de mensaje que consultó, para ahorrar ancho de banda y aumentar la velocidad de respuesta. Si coloca 0, recibirá los últimos 50 SMSC recibidos.

Consultar estado del servicio

cmd=estado

Consultar saldo

cmd=saldo

Si la cuenta posee líneas dedicadas se podrá ver el estado de cada línea y los mensajes restantes correspondientes.

Datos retornados

Te devolverá información en formato JSON. Los 3 valores serán:

  • '''code''': SMSC Api Codes (OK, Error, etc)
  • '''message''': Mensaje del código devuelto.
  • '''data''': Si la operación fue de consulta, aquí estará la información devuelta.

Otros

Si llegaste aquí buscando saldo pero no de sms, sino dinero electrónico, puedes visitar este artículo de saldo.com.ar.