HTTP protocol

The Rapporto company offers partners the HTTP interface for SMS traffic transfer in the directions from the subscriber to the Partner and from the Partner to the subscriber. The HTTP interface is simple in realization and is convenient in debugging. Its is recommended for use in cases when a peak traffic doesn't exceed 10 messages per second.

Interaction under the HTTP protocol between Rapporto's platform and system of the Partner is carried out by means of usual GET-inquiries. Names of the parameters corresponding to attributes of the message, such as "customer address", "service number" both on reception, and on transfer if necessary are adjusted on the Rapporto platform. Inadmissible symbols in URL have to be coded (URLEncoded) according to the UTF-8 coding. Protection of the interface is carried out by IP addresses. Each of interacting systems (Rapporto and the Partner) adjusts the list of IP addresses from which access to the interface is allowed, and rejects all other addresses. In case of need, additional encrypting of a traffic with the use of VPN-connection between systems of Rapporto and the Partner is possible.

For interface setup on Rapporto side Partner should provide the following information:

  • a Set of IP addresses of the Partner from which it is necessary to allow access to the interface.

  • Service number or set of numbers which will be used at interaction. If it is required to allow sending messages from any number (the dynamic signature) — it should be specified separately.

  • If the Partner needs to process MO traffic, it is necessary to specify URL on which Rapporto's platform will send messages on processing.

  • If it is required to the Partner to receive reports on delivery to his system, it is necessary to specify URL on which Rapporto's platform will send these reports, and/or inform Rapporto if he needs polling mechanism.

  • If the postponed delivery of SMS is planned (delivery in certain time), it is necessary to specify it, so that the settings were made on the certain part of a platform.

  • If the interface is adjusted in a testing mode, it is necessary to specify the following parameters in addition:

    • the estimated volume of tests (number of sent messages)

    • the period of testing after which the decision of interface use or not will be made.

    • whether the interface in a test mode has to carry out real delivery of SMS to phone numbers.

After carrying out necessary settings the following parameters will be sent to Partner, if it is needed:

  • URL for asynchronous sending of MT messages;

  • URL for inquiry of the statuses of delivery;

  • The login/password for an access to the personal account with functions of viewing of statistical reports.