审批列表(box=inbox 待我决 / box=mine 我发起;游标分页防滥用)

GET

/v1/approvals

const url = 'https://api.tansr.com/v1/approvals?box=inbox';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.tansr.com/v1/approvals?box=inbox' \
  --header 'Authorization: Bearer <token>'

Authorizations

bearerAuth

Parameters

Header Parameters

x-tansr-org

string

Org 作用域声明(org 公开 id);服务端校验成员资格与角色,非成员恒 404、角色不够 403

Query Parameters

box

string

Allowed values: inbox mine

status

string

cursor

string

Responses

200

审批单列表

application/json

object

data

required

Array<object>

object

required

string

orgId

required

string

kind

required

Any of:

string

Allowed value: expand_model

level

required

Any of:

string
string

string

Allowed value: org

requesterUserId

required

string

beneficiaryUserId

required

Any of:

string
null

string

payload

required

object

payloadHash

required

Payload 稳定序列化 sha256(决策对象防换)

string

status

required

Any of:

string

Allowed value: pending

currentStep

required

integer

expiresAt

required

Any of:

string
null

string

createdAt

required

string

decisions

required

Array<object>

object

step

required

决策步序(current_step 预留多级;W1 恒 1)

integer

deciderUserId

required

string

action

required

Any of:

string
string

string

Allowed value: approve

reason

required

Any of:

string
null

string

viaDelegationId

required

Any of:

string
null

string

decidedAt

required

string

nextCursor

string | null

Example

{
  "data": [
    {
      "kind": "expand_model",
      "level": "org",
      "status": "pending",
      "decisions": [
        {
          "action": "approve"
        }
      ]
    }
  ]
}

审批列表(box=inbox 待我决 / box=mine 我发起;游标分页防滥用)

Authorizations

Parameters

Header Parameters

Query Parameters

Responses

200

Example

本文是否有帮助?