apprise icon indicating copy to clipboard operation
apprise copied to clipboard

Free Mobile GET/POST URL -> SMS to your phone

Open schklom opened this issue 3 years ago • 0 comments

:loudspeaker: What is the name of the service? Free Mobile SMS

Basically, you send a GET/POST request to a special URL, and you receive a SMS sent by your number.

:link: Provide some details about the service that can help with it's development.

  • Homepage: only available to subscribers, in French (https://mobile.free.fr/account/mes-options/notifications-sms)
  • API Reference: idem. Here is original text
L'envoi du SMS se fait en appelant le lien suivant :

https://smsapi.free-mobile.fr/sendmsg
avec les paramètres suivants :

    user : votre login
    pass : votre clé d'identification générée automatiquement par notre service
    msg : le contenu du SMS encodé sous forme d'url (Percent-encoding)

Exemple : Envoyer le message "Hello World !" sur votre mobile :

https://smsapi.free-mobile.fr/sendmsg?user=AAAA&pass=BBBB&msg=Hello%20World%20!

Vous pouvez également, si vous le préférez, envoyer les paramètres en POST.
Dans ce cas, le contenu du message n'a pas besoin d'être encodé.
Le code de retour HTTP indique le succès ou non de l'opération :

    200 : Le SMS a été envoyé sur votre mobile.
    400 : Un des paramètres obligatoires est manquant.
    402 : Trop de SMS ont été envoyés en trop peu de temps.
    403 : Le service n'est pas activé sur l'espace abonné, ou login / clé incorrect.
    500 : Erreur côté serveur. Veuillez réessayer ultérieurement.

and my translation

Sending an SMS is done by calling the following URL:

https://smsapi.free-mobile.fr/sendmsg
with the following parameters:

    user : your login
    pass : your identification key that is automatically generated by our service
    msg : the content of the encoded SMS as a URL (Percent-encoding)

Example : Send the message "Hello World !" on your phone:

https://smsapi.free-mobile.fr/sendmsg?user=AAAA&pass=BBBB&msg=Hello%20World%20!

You can also, if you prefer, send the parameters via POST.
In this case, the message content does not need to be encoded.
The HTTP return code indicates whether the operation was successful or not:

    200 : The SMS was sent to your phone.
    400 : A mandatory parameter is missing.
    402 : Too many SMS were sent in too little time.
    403 : The service is not activated in your subscriber space, or login / key incorrect.
    500 : Server error. Please try again later.

:bulb: Anything else?

A way to use custom plugins via HTTP requests. https://github.com/caronc/apprise/wiki/decorator_notify only documents using the CLI. And ideally, a complete simple example for custom plugins. I have trouble figuring out how to write one to do a simple HTTP GET/POST request. Last, thank you so much for this service. I just started using it and already find it great! :100:

schklom avatar Aug 24 '22 21:08 schklom