Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

互联互通接口标准v1.1.0更新 #15

Merged
merged 1 commit into from
Dec 23, 2024

Conversation

interconn-pec
Copy link
Contributor

修订内容

互联互通接口标准v1.1.0版本更新主要包括互联互通接口勘误以及新增两部分,相关接口内容已通过互联互通技术社区评审以及投票,具体内容如下。

互联互通接口勘误

类别 接口 原内容 修订内容 备注
管理面接口 3.1 合作申请接口 请求体 inst_id、node_id、name、institution等信息发送的是对方节点信息 请求体inst_id、node_id、name、instituition等信息发送本方节点信息给对面,对方node_id由请求头字段x-target-node-id字段进行指定 必选
4.3 数据集授权申请 请求体 audit_id、auth_scope、contract_id、dataset_id、time_limit 请求体新增times_limit字段,数据类型int32,表述数据集访问次数限制 必选
4.4 数据集授权意向更新 请求体 resource_permit结构体中resourse_node_id、resourse_inst_id 请求体中resourse_node_id、resourse_inst_id修改为resource_node_id、resource_inst_id 必选
6.1 公开组件列表查询 请求体 category、contractId、developer、page_num、page_size 请求体 contractId修改为contract_id 必选
控制层接口 3.10 作业审批确认 作业审批确认接口 删除该接口,作业审批上提至管理面 必选
通用报文头规范 通用报文头规范 x-auth-sign:利用签约时指定的算法构造的签名值,用于安全校验
x-csrf-protection:避免跨站点请求伪造攻击,POST时必选
x-source-node-id:请求方节点id
x-target-node_id:目的方节点id
x-nonce:系统生成的防重放随机串,如UUID
x-trace-id:业务自定义标识,用于全链路追踪
x-timestamp:调用方毫秒时间戳
x-mprac-token-set:多方资源访问控制的许可凭证
x-auth-sign新增说明:节点信息查询、合作申请、更新合作意向接口header无需包含x-auth-sign,节点签约完成后才能生成签名值;
x-csrf-protection新增说明:x-csrf-protection是一个token
必选
返回码 返回码 code:200 code:0 必选

互联互通新增接口

类别 接口名称 请求方式 功能说明 备注
管理面接口 作业审批申请 POST 作业审批申请 必选
作业审批确认 POST 作业审批确认 必选
作业审批解除 POST 作业审批解除 可选

Copy link

@UniqueMarvin UniqueMarvin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Copy link
Collaborator

@shaojian-ant shaojian-ant left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@shaojian-ant shaojian-ant merged commit a844370 into secretflow:main Dec 23, 2024
1 check passed
@github-actions github-actions bot locked and limited conversation to collaborators Dec 23, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants