Interface Description

• 1,Document Name：CHINA SKYLINE SMS API DOCUMENTS (HTTP)
• 2,Interface protocol: HTTP
• 3,the encoding format: UTF8
• 4,the request method: GET, POST
• 5,Content-Type：application/json;charset=UTF-8
• 6,For security reasons, we have set up dynamic signatures (Sign),how to generate a Sign?
• Enter the account name , API key, and request date time to form a string and use MD5 encryption. MD5 uses 32-bit lowercase
• Example

• Note: The API key is the authentication key,not log in password. You can log into Skyline SMS system(www.globalsms.cn) to get it. The request time (datetime) needs to set GMT + 8 the current time within half an hour, not a timestamp ,include Year, month, day, hour, minute, second

BALANCE REQUEST

• 1. Interface name: getbalanceV2
• 2,Interface description: This interface is used to query account balance information
• 3, the request method: GET
• 4, the request URL: http://sms.skylinelabs.cc:20003/getbalanceV2?account=***&sign=***&datetime=**
• 5,Request parameter description

• 6,Response Example:{"status":0,"balance":"99.990000", "gift":"50.00000"}
• 7,Response Code Description

SEND SMS

• 1,Interface name: sendsmsV2
• 2,Interface description: This interface is used to send short messages, which can be sent individually or in batches,The same content is supported. It supports GET and POST request method
• 3,Request method: GET, POST
• 4,(GET)：
• URL：http://sms.skylinelabs.cc:20003 /sendsmsV2?account=***&sign=***&datetime=***&senderid=***&numbers=8613611111111,8613722222222&content=***
• 5、(POST)：
• URL：http://sms.skylinelabs.cc:20003/sendsmsV2?account=***&sign=***&datetime=***
• The POST request uses json format with the following parameters:
• {"content":"test","numbers":"8613611111111,8613722222222","senderid":"123 123"}
• Note: The account, sign, datetime parameters in the POST request must be placed in the URL, and cannot be submitted in json
• 6,Request parameter description

• 7，Response Example：
• {"status":0, "success":2, "fail":0, "array":[[8613611111111,1901281451030204206], [8613722222222,1901281450470121055]]}
• 6，Response Code Description：

SEND BULK SMS

• 1,Interface name: batchsendsmsV2
• 2,Interface description: This interface is used to send SMS in batches, and supports different numbers to send different content
• 3, the request method: POST
• 4, the request URL:
• POST /batchsendsmsV2?account=***&sign=***&datetime=**** HTTP/1.1
• Host: http://sms.skylinelabs.cc:20003
• Content-Type:application/json
• {"messages":[{"senderid":"0123456789","content":"%E5%85%BB%E8%80%81%E9%87%91%E8%","mobile":["8613611111111","8613722222222"],"smsid":"1"},{"content":"%E5%86%BB%E8%80%81%E9%87%91%E8%","mobile":["8613811111111"],"smsid":"2"}]}
• Note: The account, sign, datetime parameters in the POST request must be placed in the URL, and cannot be submitted in json
• 5,Request parameter description

• 6，Response Example
• {"success": 1,"fail": 2,"array": [[0,"8613611111111","1",1901121607180200001],[9,"13722222222","1"],[9,"13811111111","2"]]}
• 7,Response Code Description

GET REPORT

• 1,Interface name: getreportV2
• 2,Interface description: This interface is used to query the SMS sending report
• 3, the request method: GET
• 4,the request URL:
• http://sms.skylinelabs.cc:20003/getreportV2?account=***&sign=***&datetime=***&ids=1901281451030204206,1901281450470121055
• 5,Request parameter description

• 6,Response Example
• {"status":0, "success":1, "fail":1, "unsent":0, "sending":0, "nofound":0,"array":[[1901281451030204206,"86136****1111",20190128145103,0], [1901281450470121055,"8613722222222",20190128145047,3]]}
• 7，Response Code Description

Get Sent Record

• 1,the interface name: getsentrcdV2
• 2,the interface description: TInterface description: This interface is used to query the SMS sending status in batches. The results of the SMS reports that have been sent within the time period between the start time and the end time of the query. The query frequency is up to 1 query per minute. If the frequency is exceeded, the interface will return -15
• 3,the request method: GET
• 4,the request URL:
• http://sms.skylinelabs.cc:20003/getsentrcdV2?account=***&sign=***&datetime=***&date=***&begintime=***&endtime=***&startindex=***
• 5,Request parameter description

• 6，Response Example
• {"status":0, "totalcnt":2, "retcnt":2, "success":1, "fail":1,"array":[[1902010000230228223,"86136****1111",1548950424,0], [1902010000470228227,"8613722222222",1548950448,3]]}
• 7，Response Code Description

Push Status Report

• 1,Interface description: This interface actively pushes the SMS status report to the sender. After the SMS is sent, the system actively pushes the status report to the sender's server. The sender must provide the URL of the receiving interface and reply with a 200 OK response after receiving the push.
• 2,Push method: POST
• 3,Push message JSON format
• Content-Type:application/json
• { "msgid":1903121607180200001, "mobile":"8613611111111", "status":0, "timestamp":1565222888000 }
• 4,Parameter description

FAQs

• 1, Account error: {"status":-1,"desc":"user not exist"}
• Cause Analysis:
• 1) The account number sent by the SMS interface is wrong. Check whether the account number is correct.
• 2) 2) POST submission does not include account, sign, datetime in the URL.
• 2,Authentication error:{"status":-1,"desc":"auth failed"}
• Cause Analysis:
• 1) The password passed in the SMS interface is incorrect. Check whether the password is correct. The password is an authentication key, not a login password. The authentication key must be obtained by logging into the Skyline SMS system.
• 2) The datetime used in the sign parameter passed in the sending interface is inconsistent with the datetime passed in the interface.
• 3) The http protocol is not enabled, you can log in to Skyline SMS system and enable it in My Settings-API Settings.
• 3,Time expires: {"status":-1,"desc":"timestamp expires"}
• Cause analysis: The incoming datetime of the SMS interface is expired. The datetime must use the current time within half an hour of GMT + 8, and the time format is year, month, day, hour, minute, second, and non-timestamp. Note that time conversion is required
• 4, wrong number: {"status":-9}
• Cause analysis: The incoming number of the sending interface is incorrect. The common reasons are as follows:
• 1) The receiving number is not added with the country code or the country code is followed by 0. The Skyline system requires the incoming number to be a complete international number with the country code. Correct examples: Indonesia 6281211111111, incorrect examples: 81211111111, 0812111111111, 62081211111111.
• 2) The receiving number is not within the scope of business cooperation. For example, if the business only cooperates with Indonesia, then this account can only send Indonesian numbers, and other countries' numbers will return -9.
• 3) The receiving number is within the scope of business cooperation and the number format is correct. Then the number segment of this number is not allowed in the number segment of the skyline system. Please confirm whether the number exists. If it is confirmed, you can contact the skyline business manager to add it
• 5，Frequency limit: {"status":-15,"desc":"Frequent Queries "}
• Cause analysis: The query frequency of the getsentrcd interface exceeds the limit. The maximum query frequency is 1 query per minute. The query frequency must be controlled within the allowed range.