Go to file
C-Duv 6b68de17e9 [Shell] fix(http): URL-encode message parameter
Message was not URL-encoded when sent (as "msg" URI parameter) which
could cause issues with some messages (because of spaces).

This commits uses cURL's "--data-urlencode" option for "msg" parameter
so that cURL does the encoding for us.
As a consequence, the script don't have to manually convert newlines (to
$NEWLINE_CHAR) anymore: cURL also does that for us.
2020-01-02 00:52:15 +01:00
LICENSE Initial commit 2014-06-11 22:59:52 +02:00
README.md Fix Markdown syntax typo 2017-02-11 15:27:23 +01:00
send-notification.sh [Shell] fix(http): URL-encode message parameter 2020-01-02 00:52:15 +01:00

README.md

freemobile-smsapi-client

API client for the Free Mobile SMS notification service

Theses clients send SMS notifications via Free Mobile mobile broadband company native SMS-notification API. This service can only send SMS to line's owner: it cannot be used to send SMS to any mobile number, group or massive spam.

Shell Client

Possible usages:

send-notification.sh [options] "All your base are belong to us"
uptime | send-notification.sh [options]

See send-notification.sh -h.

Configuration :

Script can be configured using the following variables:

  • USER_LOGIN: The login to use the API.
  • API_KEY: The secret key associated to USER_LOGIN.
  • MESSAGE_HEADER (Optional): Will be prepended to all the messages.
  • MESSAGE_FOOTER (Optional): Will be appended to all the messages.
  • NEWLINE_CHAR (Optional): Char to use to create a new line (it depends on receiving terminal).

Theses can be directly changed in the send-notification.sh file or set in a separate configuration file named .freemobile-smsapi next to the script or in the user's home directory. A given filepath can also be specify using the -c script at runtime (send-notification.sh -c foobar).

Configuration load process is as follows:

  1. Uses what's in send-notification.sh file.
  2. If -c option is set, test given file existence and uses what's inside. Will not load any other configuration file (stops load process here).
  3. Checks if a .freemobile-smsapi file exists next to the script and uses what's inside. Will not load any other configuration file (stops load process here).
  4. Checks if a .freemobile-smsapi file exists in user's home directory (${HOME}) and uses what's inside. Will not load any other configuration file (stops load process here).

PHP Client

Soon