Envoi par WebServices

Les WebServices permettent d'accèder à votre compte SMSBull.com depuis vos propres applications. Vous pouvez donc envoyer des messages, ou consulter votre historique ou vos crédit en tout simplicité !
Pour accèder aux WebServices de SMSBull.com, il vous suffit de connaitre l'URL du WSDL : http://www.smsbull.com/webservices.php?_p=smsbull&wsdl=1.
Ce fichier décrit les fonctions disponibles et les différents paramètres et retour de ces fonctions. Avec ceci, rien de plus simple pour accèder à votre compte !

Exemple en PHP 5 :
<?
$ws = new SoapClient ('http://www.smsbull.com/webservices.php?_p=smsbull&wsdl=1');
if ($ws->login('smsbull@example.net', 'monMotDePasse'))
{
	echo 'Mon crédit est de '.$ws->accountGetCredit();
}
else
{
	echo 'Erreur d\'authentification';
}
?>
				


Fonctions

login

Arguments :
  • login(string) : Adresse email de l'utilisateur
  • pass(string) : Mot de passe de l'utilisateur

Valeur de retour :
  • boolean

Cette fonction permet d'identifier l'utilisateur. Elle doit être appelée à chaque début de session avec les WebServices

accountGetCredit

Arguments :
  • Sans arguments

Valeur de retour :
  • float

Cette fonction retourne le credit disponible sur le compte du client.

sendersList

Arguments :
  • Sans arguments

Valeur de retour :
  • string[]

Cette fonction retourne la liste de tous les numéros d'expéditeurs valides de votre compte

smsSend

Arguments :
  • receivers(string[]) : Tableau de destinataires
  • text(string) : Message à envoyer
  • sender(string) : Expéditeur à indiquer. Il doit être validé sur le site SMSBull.com. Cette valeur peut être NULL si aucune personnalisation n'est souhaitée.
  • hide(boolean) : Indique si le message ne doit pas être affiché

Valeur de retour :
  • string

Cette fonction envoie un (ou plusieurs) SMS. Le paramêtre "receivers" doit être un tableau (même si il ne contient qu'un seul élément). Elle retourne une chaine, le Message-ID, qui peut être utilisé pour consulter l'état du message

historyGetNbMessages

Arguments :
  • Sans arguments

Valeur de retour :
  • int

Cette fonction retourne le nombre de message dans l'historique

historyGetMessages

Arguments :
  • offset(int) : Le premier enregistrement à retourner
  • limit(int) : Le nombre d'enregistrements à retourner

Valeur de retour :
Cette fonction retourne une liste de message de l'historique.

historyGetMessage

Arguments :
  • msgId(string) : Le Message-ID (retourné par historyGetMessages ou smsSend)

Valeur de retour :
Cette fonction retourne les details sur un message précis.