3.2.3 接口请求模板

POST

/path

接口说明：

协议通讯编码均为 utf-8 编码的 json 格式,并且地址与字段名都以小写形式命名，请求参数类型采用(默认即可)：application/json。

url举例：

https://addr/path?version=1.0&appid=99F0562A5F894CA7BF9A37E0A46B3493&timestamp=1728136904&sign=8FD98344E3771F558558152EC90DF6764C60A45E&token=a34a487d85b94722b82da22ce62c590f0542d6f32c8448228624a49b6a72e31bf&format=json

请求参数

Query 参数

version

string

协议版本

必需

示例值:

1.0

appid

string

必需

用户唯一凭证，由平台提供

示例值:

99F0562A5F894CA7BF9A37E0A46B3493

timestamp

string

Unix时间戳

必需

示例值:

1727966629

sign

string

必需

MD5+SHA1签名值

示例值:

8FD98344E3771F558558152EC90DF6764C60A45E

token

string

必需

用于调用接口前授权检查

示例值:

a34a487d85b94722b82da22ce62c590f0542d6f32c8448228624a49b6a72e31b

format

string

响应格式

必需

示例值:

json

Body 参数application/json

reqid

string

业务流水号，guid值

可选

param1

string

请求参数 1

必需

param2

string

请求参数 2

可选

示例

{
  "reqid": "36728b6b-dd77-4f82-9f8d-2df23cd6e8ea",
  "param1": "",
  "param2": ""
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.lingshuibao.com/path?version=1.0&appid=99F0562A5F894CA7BF9A37E0A46B3493&timestamp=1727966629&sign=8FD98344E3771F558558152EC90DF6764C60A45E&token=a34a487d85b94722b82da22ce62c590f0542d6f32c8448228624a49b6a72e31b&format=json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "reqid": "36728b6b-dd77-4f82-9f8d-2df23cd6e8ea",
  "param1": "",
  "param2": ""
}'

返回响应

🟢200成功

application/json

Body

result

string

返回结果，s 成功 f 失败

必需

response

object

返回数据信息，字符串或对象

必需

msg

string

返回值描述

必需

reqid

string

请求时的业务流水号

必需

示例

{
  "result": "s",
  "response": {
    "msg": "手机号:13097460590验证码已发送"
  },
  "reqid": "36728b6b-dd77-4f82-9f8d-2df23cd6e8ea"
}

修改于 2024-10-09 06:34:46

3.2.2 接口鉴权

3.3.1 单位账户登录

3.2.3 接口请求模板

接口说明：#

url举例：#

请求参数

示例代码

返回响应

接口说明：

url举例：