/**
* WEB service for MBS services admistration tasks
*
* @package MBS
* @subpackage Service
* @author Valdas Petrulis
* @author Šarūnas Davalga
*
History of changes:
- 2010-05-07 WEB service prototype created
- 2010-05-11 Functions and parameters presented
- 2010-06-19 Functions presented - keywordCheck(), keywordCreate(), keywordSunscriptionCreate(), serviceGet(), serviceDelete()
- 2010-07-02 Functions presented - numberList(), priceList(), categoryList()
- 2010-07-10 Functions presented - wapCreate(), wapSubscriptionCreate()
- 2010-07-27 Stable version released (can create SMS keyword, SMS subscription, WAP billing, WAP subscription)
- 2010-10-26 Possibility to notify service actions (activate, reject, comment, archive, operator_enable, operator_disable events) to your system URL
- 2011-04-19 Changed keywordCreate, keywordEdit method signature, implemented method keywordEdit, presented new method keywordGetServiceId
Common errors:
ERROR_UNKNOWN = 1 Unknown function error
ERROR_NOT_IMPLEMENTED = 2 Accessing not implemented function
ERROR_PERMISSION_DENIED = 3 Accessing denied function, service, other object
Function parameters errors:
ERROR_INVALID_PARAMS = 20 Wrong arguments given
ERROR_INVALID_COUNTRY = 21 Invalid country given (LT, LV etc.)
ERROR_INVALID_LANGUAGE = 22 Invalid language given (LT, LV ir tt.)
ERROR_INVALID_OPERATOR = 23 Invalid operator given (bite_lt, tele2_lv, etc.)
ERROR_INVALID_SHORT_NUMBER = 24 Invalid short number given (1679, 1656, 1654, etc.)
ERROR_INVALID_PRICE = 25 Invalid price given, price should be in cents (0, 30, 100, 200, etc.)
Service parameters errors:
ERROR_INVALID_SERVICE = 100 Invalid service given (does not exist, deleted)
ERROR_INVALID_SERVICE_PARAMETER = 101 Invalid, unknown service parameter
ERROR_RESERVED_KEYWORD = 102 Given keyword is already reserved
ERROR_INVALID_SERVICE_CATEGORY = 103 Invalid service category given (1, 2, 3 etc.)
Service administration notifications:
This feature can be turned on by giving parameter 'notify_admin_url' when creating new service
Notification message example:
http://mbs.vero.lt/simple/notify_sms.php?id=1&service_id=1&event=reject&comment=rejected&s1=7b8f8abdd0cb19e1e6792c1cc0aa3b0036bf0936&s2=OsHCn0ekLg8RBduOPxO4ibSPTgfhBH2V3sPgOIcLQU%2FyHI27JCRrWXsCQD2PfK41AzIPG02CTe1sOpss7QJg7Lf4tA%2BvhFkZf1NRwcqZGYm2XS2cVlfzLiiAmsdZ5fCJhnrVYdl62fJ9JsD288WHLPzVbeP6auy2r9dO0MCpI7c%3D
Notification message parameters:
id Unique message id
service_id Service id
event Service action (activate, reject, comment, archive, operator_enable, operator_disable)
comment If present - administrator or operator event comment
s1 Lower security signature
s2 Highest security signature
Possible service events:
activate Manager activated your service
reject Manager rejected your service
comment Your service was commented by manager or operator
archive Manager deleted your service
operator_enable One or several operators turned on your service
operator_disable One or several operators turned off your service
Notification messages are signed with security keys.
More information available by downloading MBS documentation - http://www.veromobile.eu/en/manuals-download?manualId=30
Annex A – Security
*/