信息校验-企业身份校验

POST

/v2/companyinfo/verify

描述：对传入的企业信息进行校验是否真实，并返回企业经营状态，可根据实际业务需要使用二要素、三要素。（需联系客服开通，按次收费）

二要素：企业名称、统一社会信用代码

三要素：企业名称、统一社会信用代码、法人姓名

请求参数

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

企业名称

必需

registerNo

string

统一社会信用代码

必需

legalPerson

string

法人姓名

可选

示例

{
    "companyName": "string",
    "registerNo": "string",
    "legalPerson\t": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.qiyuesuo.com/v2/companyinfo/verify' \
--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": "string",
    "registerNo": "string",
    "legalPerson\t": "string"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

result

object

必需

verificationResult

boolean

校验结果

必需

true为通过，false为未通过

failureReason

string

校验失败的具体原因

可选

目前只支持三要素

enterpriseBasicInfo

object (EnterpriseBasicInfoResponse)

校验成功后返回的该公司基本信息

可选

示例

{
    "code": 0,
    "message": "string",
    "result": {
        "verificationResult": true,
        "failureReason": "string",
        "enterpriseBasicInfo": {
            "id": "string",
            "name": "string",
            "econ_kind": "string",
            "regist_capi": "string",
            "address": "string",
            "reg_no": "string",
            "scope": "string",
            "term_start": "string",
            "term_end": "string",
            "belong_org": "string",
            "oper_name": "string",
            "start_date": "string",
            "end_date\t": "string",
            "check_date": "string",
            "status": "string",
            "org_no": "string",
            "credit_no": "string",
            "province": "string"
        }
    }
}

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

信息校验-个人身份校验

集成流程说明