Exemples de codi en Ruby

A continuació trobaràs els exemples de codi de programació en el llenguatge Ruby per enviar missatges SMS a través de l'API de la plataforma LabsMobile.

També disposes d'exemples de codi en JavaScript, PHP i altres llenguatges de programació.

Et recomanem consultis i tinguis en compte els següents recursos i ajuda al teu integració:

• - Com realitzar una integració amb la SMS API.
• - Descripció, manual i exemples de codi de l'API JSON.
• - Totes les versions de l'API de LabsMobile.
• - Tutorial detallat pas a pas.
• - Crear un compte de prova per a la teva integració.
• - Recomanacions i bones pràctiques.
• - Plugin, mòduls i llibreries.
• - Contacte amb el Centre de Suport.

Enviar missatges - REST API - JSON

Aquest és el codi d'exemple en Ruby per enviar missatges SMS amb la SMS API de LabsMobile en la versió JSON. Com es pot veure s'ha de crear una estructura JSON amb tots els paràmetres de l'enviament i realitzar una trucada HTTP/POST amb les dades JSON en el cos de la trucada.

És imprescindible realitzar la crida amb l'autenticació del nom d'usuari (email de registre) i la contrasenya (o token API) del compte.

            
require 'uri'
require 'net/http'
require 'base64'

url = URI("https://api.labsmobile.com/json/send")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request["Authorization"] = 'Basic ' + Base64::encode64("myusername:mypassword")
request["Cache-Control"] = 'no-cache'
request.body = "{\"message\":\"Text of the SMS message\", \"tpoa\":\"Sender\",\"recipient\":[{\"msisdn\":\"12015550123\"},{\"msisdn\":\"447400123456\"},{\"msisdn\":\"5212221234567\"}]}"

response = http.request(request)
puts response.read_body

Pots consultar tots els paràmetres JSON disponibles, opcions de configuració, manuals i especificacions en la següent url: https://apidocs.labsmobile.com/?ruby#send-sms

Consulta de crèdits - REST API - JSON

Exemple de codi en Ruby per a la consulta del saldo d'un compte. El resultat sempre s'obté en crèdits interns de la plataforma LabsMobile.

            
require 'uri'
require 'net/http'
require 'base64'

url = URI("https://api.labsmobile.com/json/balance")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic ' + Base64::encode64("myusername:mypassword")
request["Cache-Control"] = 'no-cache'

response = http.request(request)
puts response.read_body

Enviar missatges - HTTP/GET

Exemple d'enviament per a la versió GET de la SMS API de LabsMobile. Aquest és un mètode bàsic i simple d'enviar missatges SMS des d'una aplicació o programari creada en Ruby codificant tots els paràmetres en la mateixa url.

És important codificar tots els valors com URL (amb la funció urlencode() per exemple).

Pots veure i descarregar el manual de l'API GET de LabsMobile en la següent url: https://www.labsmobile.com/ca/api-sms/versions-api/http-get

                
require 'net/http'

url = URI.parse('http://api.labsmobile.com/get/send.php?username=[X]&password=[X]&msisdn=34609036253&sender=SENDER&message=This+is+the+message')
req = Net::HTTP::Get.new(url.to_s)
res = Net::HTTP.start(url.host, url.port) {|http|
    http.request(req)
}
puts res.body

Consulta de crèdits - HTTP/GET

                
require 'net/http'

url = URI.parse('http://api.labsmobile.com/get/balance.php?username=[X]&password=[X]')
req = Net::HTTP::Get.new(url.to_s)
res = Net::HTTP.start(url.host, url.port) {|http|
    http.request(req)
}
puts res.body