Forward to Custom URL Guide

What is Forwarding to Custom URL

Note

Forwarding to Custom URL is to forward SMS to your own server via HTTP POST protocol, submitting in JSON format. This forwarding process does not go through LanrenSMS’s server at all. Once the SMS is received on the phone, it is directly submitted to your own server.

As shown in the figure below:

What are the prerequisites for using this feature?

There are 3 conditions:

• 1 The app used is Lanren SMS Forwarder
• 2 The app has been activated
• 3 You have a registered account and have logged in within the app

Where is the entry point for this feature?

Please follow these steps in Lanren SMS Forwarder app:

1 Open the forwarding rules

2 Select forward to web (you may need to log in to the app first)

Then:

3 Click Forward to custom web url button

4 Turn on the Use custom web forwarding url，and then input your own url

Request Protocol

HTTP POST protocol, submitted in JSON format. This forwarding process does not go through the Lanren SMS server at all. After receiving the SMS on the phone, it is directly submitted to your own server.

Request Parameters and Example

Submit the request using HTTP POST, with the message content in JSON format.

Request Header:

Content-Type: application/json; charset=UTF-8

Request Content Example:

{
  "body": "test 20190109202941",
  "smsFrom": "13912345678",
  "smsFromName": "testuser",
  "smsId": "1547036981966",
  "smsRecvTime": 1547036981966,
  "deviceId": "device"
}

Response Requirements

Normal situation: The HTTP status code should be 200, and the content is recommended to be in JSON format.