Envoi par WebServices

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 :

• HistoryMessage[]

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 :

• HistoryMessageDetails

Cette fonction retourne les details sur un message précis.