Exemples de codi en C

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

També disposes d'exemples de codi en C++, C# 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 C 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.

              
CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.labsmobile.com/json/send");
curl_easy_setopt(hnd, CURLOPT_HTTPAUTH, (long)CURLAUTH_BASIC);
curl_easy_setopt(hnd, CURLOPT_USERNAME, "myusername");
curl_easy_setopt(hnd, CURLOPT_PASSWORD, "mypassword");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Cache-Control: no-cache");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\"message\":\"Text of the SMS message\", \"tpoa\":\"Sender\",\"recipient\":[{\"msisdn\":\"12015550123\"},{\"msisdn\":\"447400123456\"},{\"msisdn\":\"5212221234567\"}]}");

CURLcode ret = curl_easy_perform(hnd);

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

Consulta de crèdits - REST API - JSON

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

              
CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.labsmobile.com/json/balance");
curl_easy_setopt(hnd, CURLOPT_HTTPAUTH, (long)CURLAUTH_BASIC);
curl_easy_setopt(hnd, CURLOPT_USERNAME, "myusername");
curl_easy_setopt(hnd, CURLOPT_PASSWORD, "mypassword");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Cache-Control: no-cache");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

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 C 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

                
void main() {
	long http_code = 0;
	CURL *curl;
  	CURLcode res;

	curl = curl_easy_init();

	if(curl) {

		curl_easy_setopt(curl,CURLOPT_URL, "http://api.labsmobile.com/get/send.php?username=[X]&password=[X]&msisdn=34609036253&sender=SENDER&message=This+is+the+message");

		res = curl_easy_perform(curl);

		if(CURLE_OK == res) {
		    curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &http_code);

		    if(http_code == 200) {
		        puts("Received 200 status code");
		    } else {
		        puts("Did not received 200 status code");
		    }
		}
	} else {
	    puts("Could not initialize curl");
	}
}

Consulta de crèdits - HTTP/GET

                
void main() {
	long http_code = 0;
	CURL *curl;
  	CURLcode res;

	curl = curl_easy_init();

	if(curl) {

		curl_easy_setopt(curl,CURLOPT_URL, "http://api.labsmobile.com/get/balance.php?username=[X]&password=[X]");

		res = curl_easy_perform(curl);

		if(CURLE_OK == res) {
		    curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &http_code);

		    if(http_code == 200) {
		        puts("Received 200 status code");
		    } else {
		        puts("Did not received 200 status code");
		    }
		}
	} else {
	    puts("Could not initialize curl");
	}
}