如何以特定用户身份访问？

集成时默认通过客户端模式（client_credentials）访问OC的API，不涉及到任何数据权限的控制。

若需以特定的用户身份访问接口，可以通过参数的形式指定用户上下文。

用户上下文

userIdType

enum<string>

用户ID类型

可选

枚举值:

EMAILUSERIDLOGINNAME

userId

string

userId

可选

userIdType=EMAIL时填邮箱，userIdType=USERID时填合同系统的USERID，userIdType=LOGINNAME时填合同系统的登录名

如何创建一份合同？

创建合同需要先准备好相关主数据，包含：

签署部门、业务归属部门信息：可通过 4.1 组织信息创建及更新创建部门

合同经办人信息：可通过 4.2 岗位创建及更新、4.3 员工创建及更新创建岗位、员工信息。

若集成了企微、钉钉、飞书，则可直接使用部门、员工数据。

3.上传合同相关文件：通过 3.4 合同文件上传先上传合同的主文件和相关附件。

特别注意：sourceDocumentNumber(来源单据号) 请使用您内部系统中合同的唯一ID，该字段将与OC系统中的合同建立关联关系。

4.创建合同：通过 3.40 创建合同创建一份合同。在请求示例中，只需要调整 sourceCode(来源单据号，和 3.4 合同文件上传中的sourceDocumentNumber(来源单据号)一致) 即可创建一份合同，其他字段已预设好。

查看处理结果
写入类接口一般都支持批量操作，处理耗时长，都为异步接口。将采用回调的形式将处理结果通过到您，支持为每个异步接口配置回调。

以创建合同为例，假设回调API为（请联系PM配置回调）：https://your.domain/callback/createContract

回调报文示例：
可以根据 code+subCode 判断处理状态，根据sourceSystem+sourceCode区分来源系统和单据

可通过 3.5 获取文件预览链接通过 fileKey 获取预览链接。在浏览器新窗口中打开链接后即可预览，效果如下：