Comment utiliser le package NuGet Ozeki Rest SMS Api

Nuget est le gestionnaire de packages du framework .NET. Vous pouvez utiliser un package Nuget dans n'importe quelle application basée sur .NET. Si vous utilisez Visual Studio 2019, vous pouvez installer un package Nuget en quelques clics. Dans les vidéos suivantes, je vais vous montrer comment créer une application console en C#, et comment utiliser le package NuGet Ozeki.Libs.Rest dans cette application console écrite en C#.

  1. Créez une nouvelle application console en C# dans Visual Studio
  2. Installez le package NuGet Ozeki.Libs.Rest
  3. Importez le package NuGet précédemment installé avec using Ozeki.Libs.Rest;
  4. Créez une nouvelle Configuration, un Message et un objet MessageApi en utilisant le package Ozeki.Libs.Rest
  5. Utilisez l'objet MessageApi pour envoyer le message précédemment créé

Qu'est-ce que NuGet ?

NuGet est le gestionnaire de packages officiel pour .NET, créé par Microsoft.

Étape 1 - Comment créer une nouvelle application console en C#

Vidéo 1 - Comment créer une application console en C# (Tutoriel vidéo)

Étape 2 - Comment installer le package NuGet Ozeki.Libs.Rest

Pour installer un package NuGet dans Visual Studio, vous devez faire un clic droit sur l'icône du projet, puis sélectionner "Gérer les packages NuGet" dans le menu déroulant. Ensuite, vous devez rechercher le package que vous souhaitez installer, dans ce cas c'est le package Ozeki.Libs.Rest. Lorsque vous avez trouvé le package Ozeki.Libs.Rest, vous devez l'installer en cliquant sur le bouton "Installer". Une fois installé, vous pouvez importer et utiliser le package dans votre projet.

Vidéo 2 - Comment installer le package NuGet Ozeki.Libs.Rest (Tutoriel vidéo)

Gérer les packages NuGet

Pour accéder au menu où vous pouvez gérer vos packages NuGet, faites un clic droit sur le titre du projet dans l'Explorateur de solutions. Un sous-menu apparaîtra où vous trouverez le bouton 'Gérer les packages NuGet...' (Figure 1). Cliquez dessus pour ouvrir l'installateur de packages NuGet.

comment installer un package nuget étape 1
Figure 1 - Gérer les packages NuGet

Installer le package Ozeki.Libs.Rest

Tapez le texte suivant dans la barre de recherche du gestionnaire de packages NuGet : 'Ozeki.Libs.Rest'. Le moteur de recherche affichera le package dont vous avez besoin. Sélectionnez-le en cliquant. Comme vous pouvez le voir sur la Figure 2, à droite du panneau, vous trouverez un bouton 'Installer'. Cliquez dessus pour démarrer le processus d'installation.

comment installer un package nuget étape 2
Figure 2 - Installer le package Ozeki.Libs.Rest

Le package installé

Maintenant, la liste des packages 'installés', précédemment vide, contient un package. C'est le package Ozeki.Libs.Rest installé. Vous pouvez maintenant commencer à l'utiliser. Si vous souhaitez installer d'autres packages dans Visual Studio Code, répétez le processus, mais recherchez d'autres packages.

comment installer un package nuget étape 3
Figure 3 - Le package installé

Étape 3 - Comment utiliser le package Ozeki.Libs.Rest dans votre application C#

Pour utiliser le contenu du package Ozeki.Libs.Rest, vous devez l'importer en utilisant la ligne de code suivante : 

using Ozeki.Libs.Rest;

Code 1 - Comment importer le package NuGet Ozeki.Libs.Rest dans une application C#

Créer un programme qui utilise Ozeki.Libs.Rest

Dans cette vidéo, nous allons vous montrer comment utiliser le package NuGet Ozeki.Libs.Rest dans une application C#. La vidéo commencera avec un éditeur de code vide, et vous verrez l'application fonctionnelle d'envoi de SMS à la fin de la vidéo. Vous apprendrez à écrire un code qui utilise Ozeki.Libs.Rest pour envoyer des SMS via la passerelle SMS Ozeki. La vidéo est très détaillée, vous pouvez voir toutes les lignes de code que vous devez fournir pour avoir un système fonctionnel. Il ne faut que 1:46 pour regarder la vidéo, mais vous comprendrez le processus à la fin.

Vidéo 3 - Comment utiliser le package NuGet Ozeki.Libs.Rest dans une application C# (Tutoriel vidéo)

Le code source du projet

Sur la Figure 4, vous pouvez voir le code source du projet. Comme vous pouvez le voir, les variables 'username' et 'password' contiennent les identifiants de connexion pour l'utilisateur HTTP. Les variables 'Toaddress' et 'Text' contiennent l'adresse et le texte du message. Si vous êtes familier avec le langage de programmation C#, n'hésitez pas à modifier les valeurs des variables pour envoyer un message personnalisé.

send sms sln solution visual studio
Figure 4 - SendSms.sln

Si vous exécutez votre programme, vous verrez le résultat dans la 'Console de débogage'. Vous verrez le texte 'Succès' et quelques informations sur le message ensuite. Cela signifie que l'envoi du message a réussi. Appuyez sur une touche pour fermer la console de débogage.

Figure 5 - Le résultat du programme C#

Vérifiez le dossier envoyé

Après avoir terminé le processus, vous pouvez vérifier le dossier Envoyés dans Ozeki SMS Gateway (Figure 6). Vous y verrez votre message test, ainsi que tout autre message envoyé précédemment. Vous pouvez obtenir plus d'informations sur un message en cliquant dessus.

Figure 6 - Le message apparaît dans le dossier Envoyés de http_user

Résumé

Cet article a expliqué comment utiliser le package Nuget Ozeki Rest SMS Api. Cette innovation peut être très utile si vous souhaitez envoyer des messages texte depuis C#.

La synergie entre les codes C# et Ozeki SMS Gateway garantit des performances optimales. Ozeki SMS Gateway offre d'excellentes capacités de journalisation, ce qui signifie que vous pouvez identifier rapidement les erreurs et réduire les temps d'arrêt.

Ne vous arrêtez pas ici, consultez la page de tutoriels d'Ozeki où vous trouverez plus d'informations sur des sujets comme réception en C#. Maintenant, il ne vous reste plus qu'à télécharger Ozeki SMS Gateway et commencer à travailler !

More information