3.2.1 接口鉴权

POST

/agent/service/v1/auth

接口说明

为保证用户数据的安全与隐私，您需要取得用户的授权，即获取访问用户数据的授权令牌Access_Token。这种情况下，您的应用需要用户完成使用帐号“登录授权”的流程。获取凭证后在有效时间内未使用则失效,重新获取凭证后将生效。
协议通讯编码均为 utf-8 编码的 json 格式，请求参数类型采用(默认即可)：application/json。

url举例

https://agentapi.lingshuibao.com/agent/service/v1/auth?appid=Zu4PXFeyu7gX&timestamp=1746975232&sign=4caf47e4952184d3417954ae5d5c7f41a36069958b58eba71c31cdee067c59dd

请求参数

Query 参数

appid

string

必需

appid值，由平台提供

示例值:

Zu4PXFeyu7gX

timestamp

integer

必需

Unix 时间戳，秒

示例值:

1746938895

sign

string

必需

hmac+sha256 加密

示例值:

4caf47e4952184d3417954ae5d5c7f41a36069958b58eba71c31cdee067c59dd

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://agentapi.lingshuibao.com/agent/service/v1/auth?appid=Zu4PXFeyu7gX&timestamp=1746938895&sign=4caf47e4952184d3417954ae5d5c7f41a36069958b58eba71c31cdee067c59dd'

返回响应

🟢200成功

application/json

Body

code

integer

错误码

可选

data

object

可选

username

string

可选

token

string

可选

expire_seconds

string

可选

msg

string

错误信息

可选

示例

{
    "code": 0,
    "data": {
        "username": "Zu4PXFeyu7gX",
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NDcxMDMwODEsImp0aSI6ImlkIiwiaWF0IjoxNzQ3MTAxMjgxLCJuYmYiOjE3NDcxMDEyODEsInN1YiI6IntcIm5zcnNiaFwiOlwiOTE1MzAzMDJNQUQ0NzU3NDNCXCIsXCJzdGF0dXNcIjowLFwiaWRcIjoyLFwidXNlcm5hbWVcIjpcIlp1NFBYRmV5dTdnWFwiLFwibW9iaWxlXCI6XCIxMzAwNDE2MDIyNVwifSJ9.XVwTpHH3gzpf2UQzyl4eQImj6ud2RySIrXYY3Dh6yTE",
        "expire_seconds": 1800
    },
    "msg": ""
}

🟠400请求有误

🔴500服务器错误

3.2.1 税务接口通信协议

3.3.1 单位账户登录

3.2.1 接口鉴权

接口说明#

url举例#

请求参数

示例代码

返回响应

接口说明

url举例