契约锁 API

企业认证-获取企业认证链接PC

POST

/companyauth/pcpage

请求参数

Header 参数

x-qys-open-accesstoken

string

可选

默认值:

x-qys-open-timestamp

string

可选

默认值:

x-qys-open-nonce

string

可选

默认值:

x-qys-open-signature

string

可选

默认值:

Body 参数application/json

companyName

string

待认证公司名称

必需

applicant

object (UserRequest)

认证提交人

必需

企业认证通过后，认证提交人会自动成为该企业的系统管理员

contact

string

联系方式

必需

contactType

enum<string>

联系类型

必需

MOBILE（手机号），EMAIL（邮箱），EMPLOYEEID（员工ID），NUMBER（员工编号），BIZID（用户在对接方系统的唯一标识）

枚举值:

MOBILEEMAILEMPLOYEEIDNUMBERBIZID

name

string

姓名

可选

registerNo

string

待认证公司注册号

可选

legalPerson

string

待认证公司法人姓名

可选

callbackUrl

string

认证回调地址

可选

closeButton

boolean

是否显示关闭按钮

可选

默认为true

modifyFields

string

可修改项参数

可选

支持传入字段：corpName（待认证公司名称）、registerNo（待认证公司注册号）、legalPerson（待认证公司法人姓名），传入的字段，用户在企业认证页面可支持修改，多个字段用逗号隔开（例：corpName,registerNo）

lang

enum<string>

指定页面语言

可选

cn（中文）、en（英文）；默认为企业认证申请人在契约锁设置的语言

枚举值:

cneg

pageStyle

object

页面风格

可选

themeColor

string

自定义页面主题色

可选

RGB颜色(16进制)，默认取业务系统令牌配置的主题色

示例

{
    "companyName":"西街村食品有限公司",
    "applicant":{
    "name":"邓茜茜",
        "contact":"19000009093",
        "contactType":"MOBILE"
    },
    "callbackUrl":"http://www.qiyuesuo.com"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.qiyuesuo.com/companyauth/pcpage' \
--header 'x-qys-open-accesstoken: {{x-qys-open-accesstoken}}' \
--header 'x-qys-open-timestamp: {{x-qys-open-timestamp}}' \
--header 'x-qys-open-nonce: {{x-qys-open-nonce}}' \
--header 'x-qys-open-signature: {{x-qys-open-signature}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "companyName":"西街村食品有限公司",
    "applicant":{
    "name":"邓茜茜",
        "contact":"19000009093",
        "contactType":"MOBILE"
    },
    "callbackUrl":"http://www.qiyuesuo.com"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

result

object (CorpAuthResponse)

必需

authUrl

string

认证链接

可选

requestId

string

认证请求ID

可选

用于查询认证结果

示例

{
    "result": {
        "authUrl": "https://auth.qiyuesuo.me/enterprise-pc/home?ticket=yr%2Bvoy9%2F7a6qyZPXY%2BV%2FwCSV7DhEc5SCdzUx8V0HXyKeHDk%2F9MaG4JLHJLqXl1Wb&closeButton=true",
        "requestId": "bce56e83-1cf2-4aa4-99c7-b7528b7ded6d"
    },
    "code": 0,
    "message": "SUCCESS"
}

修改于 2023-01-19 03:00:26

个人认证-查询个人认证状态

企业认证-获取企业认证链接H5