Welcome [Dou Code Platform]


Get the verification code API

Name Value Description
Domain https://www.jindousms.com
Agreement HTTPS
Method GET

Example of the request API return (error codes are only 1 and -1, data is a successful return value or error message)

{"code":1,"data":{"token":"*************"},"msg":"successful"}
{"code":-1,"data":"Wrong password","msg":"successful"}

Get Token

Route: /public/user/token This API cannot be called frequently, is limited to 30 times a day, and you can get token sits for a week.
Method: GET

Request parameters:

Argument name Describe Necessary
username Username yes
password Password yes
newToken “y”, get the new token (valid for 7 days, do not pass this parameter, will get the same token) no

Request parameters(Please remove the [ ]):

https://www.jindousms.com/public/user/token?username=[username]&password=[password]&newToken=y
For example:
https://www.jindousms.com/public/user/token?username=test123&password=abc123&newToken=y

Return to an example:

{"code":1,"data":{"token":"*************"},"msg":"Request is successful"}
{"code":-1,"data":"Wrong password","msg":"Request is successful"}

Get a list of projects

Route: /public/project/list
Method: GET

Request parameters:

Argument name Describe Necessary
page Page yes
limit Number of bars per page yes
keyword Keyword ssearch no
token Get from getToken API yes

Example of a request:

https://www.jindousms.com/public/project/list?page=[page]&limit=[limit]&keyword=[keyword]&token=[token]

Return to an example:

{"code":1,"data":[{"_id":"5cea527821407f5e6b7ff934","cnname":"Telegram","enname":"Telegram Indonesia","sellingPrice":50,"myPid":2000}],"msg":"Request is successful"}
{"code":-1,"data":"Error message","msg":"Request is successful"}

Return data field resolution

Argument name Describe
_id
cnname CN Name
enname EN Name
sellingPrice Price RMB(CNY) units (penny)
myPid Project ID
token Get from getToken API

Get the number of projects count

Route: /public/project/count
Method: GET

Request parameters:

Argument name Describe Necessary
keyword Keyword ssearch no

Example of a request:

https://www.jindousms.com/public/project/count?token=[token]

Return to an example:

{"code":1,"data":300,"msg":"Request is successful"}
{"code":-1,"data":"Error message","msg":"Request is successful"}

Get Number

Route: /public/sms/getNumber
Method: GET

Request parameters:

Argument name Describe Necessary
myPid Project ID yes
number Specify Number no
locale International domain name abbreviation (used when project name is not country) no
token Get from getToken API yes

Example of a request:

https://www.jindousms.com/public/sms/getNumber?myPid=[myPid]&number=[number]&locale=[locale]&token=[token]

Return to an example:

{"code":1,"data":{"number":"85591740503","orderId":"5ceac209e4fa76106b64ba97"},"msg":"Request is successful"}
{"code":-1,"data":"Number acquisition failed","msg":"Request is successful"}

Return data field resolution

Argument name Describe
orderId Get the order ID for the number
number Number
token Get from getToken API

Get verification code

Route: /public/sms/getCode
Method: GET

Request parameters:

Argument name Describe Necessary
orderId Get the order ID for the number yes
token Get from getToken API yes

Example of a request:

https://www.jindousms.com/public/sms/getCode?orderId=[orderId]&token=[token]

Return to an example:

{"code":1,"data":{"code":"56032","content":"Telegram code 56032","number":"85770937307"},"msg":"Request is successful"}
{"code":-1,"data":{"number":"85770937307"},"msg":"Request is successful"}

Return data field resolution

Argument name Describe
code Verification code
content Text message content
number Number
token Get from getToken API

Release number

Route: /public/sms/releaseNumber Release 10 seconds after acquiring number
Method: GET

Request parameters:

Argument name Describe Necessary
orderId Order ID returned by the Get number yes
token Get from getToken API yes

Example of a request:

https://www.jindousms.com/public/sms/releaseNumber?orderId=[orderId]&token=[token]

Return to an example:

{"code":1,"data":"Number released","msg":"Request is successful"}
{"code":-1,"data":"Number release failed","msg":"Request is successful"}

Number blacklisted

Route: /public/sms/shieldNumber Join the blacklist only if Number is unavailable or if the verification code is not available.
Method: GET

Request parameters:

Argument name Describe Necessary
orderId Order ID returned by the Get number yes
token Get from getToken API yes

Example of a request:

https://www.jindousms.com/public/sms/shieldNumber?orderId=[orderId]&token=[token]

Return to an example:

{"code":1,"data":"Number is blacklisted","msg":"Request is successful"}
{"code":-1,"data":"Number is blacklisted failed","msg":"Request is successful"}

Billing API

SMS orders

Route: /public/sms/order/list
Method: GET

Request parameters:

Argument name Describe Necessary
page Page yes
limit Number of bars per page yes
orderId Order ID no
number Number no
startTime Start time no
endTime End time no
token Get from getToken API yes

Example of a request:

https://www.jindousms.com/public/sms/order/list?page=[page]&limit=[limit]&orderId=[orderId]&number=[number]&startTime=[startTime]&endTime=[endTime]&token=[token]

Return to an example:

{"code":1,"data":[{"_id":"5ceb576ee4fa76106b64ba98","number":"85770937307","numberStatus":"released","smsStatus":"received","projectInfo":{"cnname":"Telegram","enname":"Telegram","sellingPrice":50,"myPid":2000},"createdAt":"2019-05-27T03:20:14.653Z","updatedAt":"2019-05-27T03:25:34.761Z","code":"56032","content":"Telegram code 56032"}],"msg":"Request is successful"}
{"code":-1,"data":"Error message","msg":"Request is successful"}

Return data field resolution

Argument name Describe
_id Order ID
code Verification code
content Text message content
number Number
numberStatus NumberState
smsStatus SMS status
projectInfo.cnname CN Name
projectInfo.enname EN Name
projectInfo.sellingPrice Price RMB(CNY) units (penny)
projectInfo.myPid project id
createdAt Creation time
updatedAt Updatetimed
token Get from getToken API

SMS order statistics

Route: /public/sms/order/count
Method: GET

Request parameters:

Argument name Describe Necessary
orderId Order ID no
number Number no
startTime Start time no
endTime End time no
token Get from getToken API yes

Example of a request:

https://www.jindousms.com/public/sms/order/count?orderId=[orderId]&number=[number]&startTime=[startTime]&endTime=[endTime]&token=[token]

Return to an example:

{"code":1,"data":1,"msg":"Request is successful"}
{"code":-1,"data":"Error message","msg":"Request is successful"}

Recharge details

Route: /public/recharge/list
Method: GET

Request parameters:

Argument name Describe Necessary
page Page yes
limit Number of bars per page yes
orderId Recharge Order ID no
status State”all” “paid” “unpaid” no
startTime Start time no
endTime End time no
token Get from getToken API yes

Example of a request:

https://www.jindousms.com/public/recharge/list?page=[page]&limit=[limit]&orderId=[orderId]&status=[status]&startTime=[startTime]&endTime=[endTime]&token=[token]

Return to an example:

{"code":1,"data":[{"status":"unpaid","_id":"5cea4aaa3bda3147bca812d7","amount":100,"payment":"alipay","createdAt":"2019-05-26T08:13:30.297Z","updatedAt":"2019-05-26T08:13:30.501Z","orderAmt":93}],"msg":"Request is successful"}
{"code":-1,"data":"Error message","msg":"Request is successful"}

Return data field resolution

Argument name Describe
_id Order ID
status Payment status
amount Amount of order RMB(CNY) units (penny)
orderAmt Actual amount paid RMB(CNY) units (penny)
payment Payment method
createdAt Creation time
updatedAt Updatetimed
token Get from getToken API

Recharge order statistics

Route: /public/recharge/count
Method: GET

Request parameters:

Argument name Describe Necessary
orderId Recharge Order ID no
status State”all” “paid” “unpaid” no
startTime Start time no
endTime End time no
token Get from getToken API yes

Example of a request:

https://www.jindousms.com/public/recharge/count?orderId=[orderId]&status=[status]&startTime=[startTime]&endTime=[endTime]&token=[token]

Return to an example:

{"code":1,"data":1,"msg":"Request is successful"}
{"code":-1,"data":"Error message","msg":"Request is successful"}

User information

Get user information

Route: /public/user/info
Method: GET

Request parameters:

Argument name Describe Necessary
token Get from getToken API yes

Example of a request:

https://www.jindousms.com/public/user/info?token=[token]

Return to an example:

{"code":1,"data":{"balance":1311,"_id":"5cdabasfsdfa5fec21a149608e0","username":"test","mobile":"13788877777","email":"[email protected]","role":{"_id":"5cd1c1b3b183bsa70460b4e","name":"Normal users","access":"normal"},"qq":""},"msg":"Request is successful"}
{"code":-1,"data":"Error message","msg":"Request is successful"}

Return data field resolution

Argument name Describe
_id User ID
username Username
mobile Mobile
balance Balance RMB(CNY) units (penny)
email Email
qq QQ
role.name Role Name
role.access Role permissions

Feedback and suggestions

Thanks for reading this help document, please contact: