鉴权 - C300-OpenAPI

校验指定用户的 session 或 token 是否有权限访问某个接口。

请求示例

curl 'https://c2.xinheyun.com/api/open/authority/certify'
-X PUT \
-H 'content-type: application/json'
--data-raw '{
"body": {
"method": "POST",
"uri": "/api/manufacture/workOrder/list",
"session": "NWM0YWQxODgtNmM5Yy00MDg3LWIyOTktNTNmMmFlZDQ0ZTZj",
"token": "7383A52EDC64E8FDFC35A444086924D6"
}
}'

请求体参数

┌─────────┬────────┬──────┬──────────────────────────────────────────────────────────────┐
│ 字段 │ 类型 │ 必填 │ 说明 │
├─────────┼────────┼──────┼──────────────────────────────────────────────────────────────┤
│ method │ string │ 是 │ 被鉴权接口的 HTTP 方法，枚举值：GET / POST / PUT / DELETE │
├─────────┼────────┼──────┼──────────────────────────────────────────────────────────────┤
│ uri │ string │ 是 │ 被鉴权接口的路径，不含域名，例如 /manufacture/workOrder/list │
├─────────┼────────┼──────┼──────────────────────────────────────────────────────────────┤
│ session │ string │ 否 │ 用户 Session ID，与 token 二选一或同时传 │
├─────────┼────────┼──────┼──────────────────────────────────────────────────────────────┤
│ token │ string │ 否 │ 用户 Token，与 session 二选一或同时传 │
└─────────┴────────┴──────┴──────────────────────────────────────────────────────────────┘

参数来源说明

浏览器发出的请求里，这几个值都藏在 Cookie 里，打开开发者工具 → Network → 任意请求 → Request Headers → Cookie，找到以下字段：

SESSION=NWM0YWQxODgtNmM5Yy00MDg3LWIyOTktNTNmMmFlZDQ0ZTZj ← 对应 session
TOKEN=7383A52EDC64E8FDFC35A444086924D6 ← 对应 token

┌──────────┬─────────────┬──────────────────────────────────────────────────┐
│ 接口参数 │ Cookie 字段 │ 示例值 │
├──────────┼─────────────┼──────────────────────────────────────────────────┤
│ session │ SESSION │ NWM0YWQxODgtNmM5Yy00MDg3LWIyOTktNTNmMmFlZDQ0ZTZj │
├──────────┼─────────────┼──────────────────────────────────────────────────┤
│ token │ TOKEN │ 7383A52EDC64E8FDFC35A444086924D6 │
├──────────┼─────────────┼──────────────────────────────────────────────────┤
│ method │ — │ 取你要鉴权的目标接口的 HTTP 方法 │
├──────────┼─────────────┼──────────────────────────────────────────────────┤
│ uri │ — │ 取你要鉴权的目标接口的路径（去掉域名） │
└──────────┴─────────────┴──────────────────────────────────────────────────┘

▎ 注意：本接口的鉴权，还是使用openapi的通用鉴权方式！！！

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

鉴权

请求参数

请求示例代码

返回响应