共绩科技

任务自定义YAML校验接口

POST

/api/deployment/task/encrypt/check

共绩算力 Open API/任务

验证部署配置的数字签名，确保配置内容在传输过程中未被篡改。

*使用非对称加密技术验证配置签名
*支持RSA/SM2双算法模式
*需配合密钥管理系统(KMS)使用

请求参数

Header 参数

token

string

会话令牌

必需

示例值:

1464a876-7cd0-4e1f-89d3-63dbc24cd7f9-20250619093506

正则匹配:

^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}-\d{14}$

version

string

API版本号

必需

示例值:

1.0.0

timestamp

integer <int64>

请求时间戳(毫秒)

必需

示例值:

1750386314983

sign_str

string

必需

RSA-2048请求签名

示例值:

rfdat1CMQuHv+qp1kpWfciflkhtHWte3J3Skk8Cs496Uj53CiUb6YLLHsojZcb38iU93rEDkjK4gJ0T17QMjDGCVvzOySMbDayhJhbKcYhylqTw8aIpHez5Rwkcw8oMOPcL4xjuBrWS6MIXOLbn2Tl+cgKK0pJ2H96CDqv/zBLEadN8NbsKDXL6BnUtridLGR+5V6dCRSF2T7Hv5wz9PyhU0OdEqOzknVe9lSeCAUIliubA6znbhMl8QkhOu0YHOrENaJmXrZhN0+c+NNsyxAEjWq3P96W6goC1n6xvL236BwB2Y1o/HZjLecv3NVSLo5d5moCMA37eUpJLw/utchQ==

Body 参数application/x-www-form-urlencoded

config_signature

string

必需

配置内容签名值(Base64)

示例值:

MIIEpAIBAAKCAQEA3Z4vI9yV...

public_key_id

string

KMS中的公钥标识

必需

示例值:

kms_key_rsa_2025q3

algorithm

enum<string>

签名算法类型

可选

枚举值:

RSA_2048SM2

默认值:

RSA_2048

示例值:

RSA_2048

hash_method

enum<string>

哈希算法类型

可选

枚举值:

SHA256SM3

默认值:

SHA256

示例值:

SHA256

original_checksum

string

必需

原始配置的SHA256校验和

示例值:

a1b2c3d4e5f67890abcdef1234567890abcdef1234567890abcdef123456

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.suanli.cn/api/deployment/task/encrypt/check' \
--header 'token: 1464a876-7cd0-4e1f-89d3-63dbc24cd7f9-20250619093506' \
--header 'version: 1.0.0' \
--header 'timestamp: 1750386314983' \
--header 'sign_str: rfdat1CMQuHv+qp1kpWfciflkhtHWte3J3Skk8Cs496Uj53CiUb6YLLHsojZcb38iU93rEDkjK4gJ0T17QMjDGCVvzOySMbDayhJhbKcYhylqTw8aIpHez5Rwkcw8oMOPcL4xjuBrWS6MIXOLbn2Tl+cgKK0pJ2H96CDqv/zBLEadN8NbsKDXL6BnUtridLGR+5V6dCRSF2T7Hv5wz9PyhU0OdEqOzknVe9lSeCAUIliubA6znbhMl8QkhOu0YHOrENaJmXrZhN0+c+NNsyxAEjWq3P96W6goC1n6xvL236BwB2Y1o/HZjLecv3NVSLo5d5moCMA37eUpJLw/utchQ==' \
--data-urlencode 'config_signature=MIIEpAIBAAKCAQEA3Z4vI9yV...' \
--data-urlencode 'public_key_id=kms_key_rsa_2025q3' \
--data-urlencode 'original_checksum=a1b2c3d4e5f67890abcdef1234567890abcdef1234567890abcdef123456'

返回响应

🟢200成功

application/json

验证成功

Headers

x-envoy-upstream-service-time

integer

可选

示例值:

Body

code

string

必需

示例值:

0000

validity

boolean

签名是否有效

必需

示例值:

true

verification_time

string <date-time>

可选

示例值:

2025-06-20T02:25:14Z

public_key_status

enum<string>

可选

枚举值:

ACTIVENEAR_EXPIRYREVOKED

示例值:

ACTIVE

示例

{
    "code": "0000",
    "validity": true,
    "verification_time": "2025-06-20T02:25:14Z",
    "public_key_status": "ACTIVE"
}

🟠400请求有误

🟠403禁止访问

修改于 2025-06-20 14:07:46

任务修改接口

任务节点列表查询接口