SMS Starter 100
10.53 USD
  • incl. gateway setup
  • incl. 100 SMS to DE
  • Credits valid for SMS and faxes
Order now
SMS Starter 150
15.75 USD
  • incl. gateway setup
  • incl. 150 SMS to DE
  • Credits valid for SMS and faxes
Order now
SMS Starter 1000
105.26 USD
  • incl. gateway setup
  • incl. 1,000 SMS to DE
  • Credits valid for SMS and faxes
Order now

phlyLabs SMS and Fax Gateway

Our products offer you a convenient interface to send fax messages nad text messages to cellphones. Besides that we offer you direct access to our gateway for use in third party applications. Below information is related to the direct interface access.

Calling the Gateway

You'll call the gateway via the base URI https://msggw.phlymail.de/http.php.
Optionally you can use plain old http://, although we don't recommend it.

Both HTTP GET and HTTP POST are supported. The gateway has the following operation modes (see parameter mode):

  • Connection test - This call allows you to check, whether the interface is up and the provided credentials are correct. A positive result inidcates, that sending messages will work.
    Example:
    msggw.phlymail.de/http.php?user=USER&encpass=SECPASS&mode=test

  • Deposit list - Use this call to see your current deposit.
    Example:
    msggw.phlymail.de/http.php?user=USER&encpass=SECPASS&mode=synchro

  • Dispatch SMS - Please see a detailed list of parameters in the table below.
    Example:
    msggw.phlymail.de/http.php?user=USER&encpass=SECPASS&mode=sms&from=TEL&to=TEL&text=TEXT

  • Dispatch Fax - Please see a detailed list of parameters in the table below.
    Example:
    msggw.phlymail.de/http.php?user=USER&encpass=SECPASS&mode=fax&from=TEL&to=TEL&file=[…]


Gateway Return Codes

The basic form of replies of the gateway is:
<CODE> <Human readable English text>\n
The list of return codes is as follows:

Request type mode Code Meaning
Connection test test 100 Success. Paramters were correct and the connection to the fateway works
401 Failed. Either username or password are wrong.
Guthabenabfrage synchro 100 Success. The human readable text returned contains your current deposit
402 Failed. Either username or password are wrong.
Dispatch sms / fax 100 Success. The human readable text returned contains the resulting number of effective SMS. On fax dispatch this is not the case, of course.
201 Failed. The message passed exceeds the allowed length limit (for ISO SMS: 1530 chars; for faxes 600 KB).
202 Failed. One or more of the required fields are missing.
203 Failed. Your current deposit is insufficient to send this message. Try shortening it.
402 Failed. Either username or password are wrong.


Parameters

Depending on the request type we require certain parameters. Furthermore there's a few restrictions on the format of the data passed. See details below. Please note, that all of your parameters have to be passed in URL encoded form so they can be safely passed through HTTP.
The character encoding of the interface is ISO-8859-1.

Paramter Meaning
user The username we assigned you. This field is mandatory.
pass Your chosen password in plain text. We recommend to only use this field in cases, where password encryptrion is impossible. Either this field or encpass must be given with each call you make.
encpass Your chosen password as MD5 hash. You should prefer this field over the unencrypted pass. Either this field or pass must be given with each call you make.
mode Defines the request type. Possible values are:
  • test - Tests connectivity and that your credentials are right
  • synchro - To query your current deposit
  • sms - Dispatches an ISO SMS. See parameters below
  • fax - Dispatches a fax. See parameters below
  • udh - Dispatches a binary SMS. Details on request
  • utf - Dispatches a Unicode SMS. Details on request


Parameter for dispatching SMS

Paramter Meaning
user The username we assigned you. This field is mandatory.
pass Your chosen password in plain text. We recommend to only use this field in cases, where password encryptrion is impossible. Either this field or encpass must be given with each call you make.
encpass Your chosen password as MD5 hash. You should prefer this field over the unencrypted pass. Either this field or pass must be given with each call you make.
mode For dispatching an SMS this field must have the value sms.
from SMS sender in international format 004917712345678 or as alphanumeric string (Characters 0-9 and A-Z) with max. 11 characters.
to SMS recipient in the form 004917712345678. Please note, that sending SMS to non-German mobile networks is not technically disabled, but cannot always be ensured. Before dispatching large amounts to foreign (i.e. non-German) networks you should test successfull disposal with a single message!
text The message's body in the encoding ISO-8859-1. Messages with more than 160 characters will be split into individual SMS with 153 chars each. The maximum length of a single message is 1530 bytes, thus making up up to 10 single SMSs. These will be charged accordingly, since this is part of the SMS standard.


Parameter dispatching faxes

Paramter Meaning
user The username we assigned you. This field is mandatory.
pass Your chosen password in plain text. We recommend to only use this field in cases, where password encryptrion is impossible. Either this field or encpass must be given with each call you make.
encpass Your chosen password as MD5 hash. You should prefer this field over the unencrypted pass. Either this field or pass must be given with each call you make.
mode For dispatching a fax this field must have the value fax.
from Sender's number in the form 00493012345678. This field is mandatory.
from_name Sender's name. This is an alphanumeric string in the encoding ISO-8859-1. This field is mandatory.
to Recipient's number in national format (03012345678). Valid recipient numbers are German landlines (standard price) or the number range 0180xxx (Charged according to our pricing list). The dispatch of faxes to Die Zustellung von Faxen an foreign numbers (outside Germany), German "Sonderrufnummern" (like Service 0900 or 0700) or mobile numbers unfortunately is impossible.
status_to Pass an email address here, if you wish to receive a status message after finishing the transfer. This contains the transfer status and a possible cause of error, if any, e.g. line busy.
file The fax to transmit as a PDF. Please use Base 64 as transfer encoding. The maximum file size is 600 kByte. For a HTTP safe transfer of the Base64 string please perform the following string replacements:
+ becomes -, / becomes _ and the = will be dropped.
Please wait