Skip to content

Latest commit

 

History

History
1089 lines (723 loc) · 26.8 KB

实名鉴权.md

File metadata and controls

1089 lines (723 loc) · 26.8 KB
Raw

[danger] 本章节涉嫌违规，整改中

企业开票信息查询

根据公司名称/社会统一信用代码查询企业开票信息

最低 0.2元/次

请求地址

GET https://api.isoyu.com/enterprise/creditcode

请求参数

名称 必填 类型 说明
appCode 是 string 用户授权码，参考API调用
keyword 是 String 公司名称或社会统一信用代码

返回参数

名称 类型 说明
  name string 企业名称
creditcode string 社会统一信用代码(纳税人识别号)
econkind string 企业类型
status string 企业状态
address string 地址
tel string 联系电话
bank string 开户行
bankaccount string 开户行账号

SDK调用

$client = new Client("YourAppCode");



$result = $client->enterpriseCreditcode()

    ->withKeyword('9132059455117770X5')

    ->request();

dump($result);

返回数据示例：

{
	"code":0,
	"message":"操作成功",
	"data":{
	    "name":"天聚地合(苏州)数据股份有限公司",

		"creditcode":"9132059455117770X5",

		"econkind":"股份有限公司(非上市)",

		"status":"在业",

		"address":"苏州工业园区启月街288号紫金东方大厦307室",

		"tel":"0512-62391880",

		"bank":"浙商银行苏州分行营业部",

		"bankaccount":"3050020010120100129207"
    }
}

[danger] 返回code为0时计费。

企业三要素核验

核验企业名称、社会统一信用代码、法人一致性

最低 0.08元/次

请求地址

GET https://api.isoyu.com/enterprise/verify

请求参数

名称 必填 类型 说明
appCode 是 string 用户授权码，参考API调用
keyword 是 string 注册号/统一社会信用代码(注册号支持15位，统一社会信用代码支持18位)
name 是 string 公司名称
operName 是 string 企业法人

返回参数

名称 类型 说明
oper_name string 匹配的企业法人
name string 匹配的公司名称
status int 匹配详情,1:全匹配;2:全不匹配;12:公司匹配,法人不匹配;13:公司不匹配,法人匹配

SDK调用

$client = new Client("YourAppCode");



$result = $client->enterpriseVerify()

    ->withKeyword('注册号/统一社会信用代码')

    ->withName('公司名')
    ->withOperName('法人姓名')
    ->request();

dump($result);

返回数据示例：

{
	"code":0,
	"message":"操作成功",
	"data":{
            "oper_name": "匹配的法人姓名",

            "name": "匹配的公司名称",

            "status": 2
	}
}

[danger] 返回code为0时计费。

企业信息精确查询

根据企业全名/注册号/统一社会信用代码获取企业工商详细信息

最低 0.35元/次

请求地址

GET https://api.isoyu.com/enterprise/detail_info

请求参数

名称 必填 类型 说明
appCode 是 string 用户授权码，参考API调用
keyword 是 string 企业全名/注册号/统一社会信用代码

返回参数

名称 类型 说明
name string 公司名称
econ_kind string 企业类型
addresses string 地址
reg_no string 企业注册号
scope string 经营范围
term_start string 营业开始日期
term_end string 营业结束日期
belong_org string 所属工商局
oper_name string 法人
start_date string 成立日期
end_date string 注销日期
status string 在业
org_no string 组织机构号
credit_no string 统一社会信用代码
province string 省份缩写
employees.job_title string 主要人员职位
employees.name string 主要人员姓名
brances.name string 分支机构名称
changerecords.change_item string 变更项目
changerecords.change_date string 变更日期
changerecords.before_content string 变更前内容
changerecords.after_content string 变更后内容
partners.name string 股东姓名
partners.stock_type string 股东类型
partners.identify_type string 证照/证件类型(返回固定"非公示项")
partners.identify_no string 证照/证件号码(非公示项,返回"-")
partners.should_capi_items.shoud_capi string 认缴出资额
partners.should_capi_items.invest_type string 出资方式
partners.should_capi_items.should_capi_date string 出资时间
partners.real_capi_items.real_capi string 实缴出资额
partners.real_capi_items.invest_type string 出资方式
partners.real_capi_items.real_capi_date string 实缴时间
abnormal_items.in_reason string 经营异常列入原因
abnormal_items.in_date string 列入日期
abnormal_items.out_reason string 移出原因
abnormal_items.out_date string 移出时间
regist_capi_new string 注册资本（新）
currency_unit string 货币单位

SDK调用

$client = new Client("YourAppCode");



$result = $client->enterpriseDetailInfo()

    ->withKeyword('企业名称/注册号/统一社会信用代码')

    ->request();

dump($result);

返回数据示例：

{
	"code":0,
	"message":"操作成功",
	"data":{
		"sign":"95964acf21ee4503be0deb37b283f21c",
		"data":{
			"name":"天聚地合（苏州）数据股份有限公司北京分公司",
			"econ_kind":"股份有限公司分公司(非上市、自然人投资或控股)",
			"regist_capi":"-",
			"scope":"网络技术服务；会议服务；设计、制作、代理、发布广告；承办展览展示活动。（企业依法自主选择经营项目，开展经营活动；依法须经批准的项目，经相关部门批准后依批准的内容开展经营活动；不得从事本市产业政策禁止和限制类项目的经营活动。）",
			"term_start":"2016-05-10",
			"term_end":"-",
			"belong_org":"海淀分局",
			"oper_name":"左磊",
			"check_date":"2017-11-29",
			"start_date":"2016-05-10",
			"end_date":"-",
			"status":"在业",
			"org_no":"MA005BCA2",
			"credit_no":"91110108MA005BCA25",
			"province":"BJ",
			"id":"2d79de67-481c-402f-9eac-2a6e6a4afc5a",
			"abnormal_items":[
				
			],
			"reg_no":"-",
			"address":"北京市海淀区永澄北路2号院1号楼A座四层405-200",
			"employees":[
				{
					"name":"左磊",
					"job_title":"负责人"
				}
			],
			"branches":[
				
			],
			"changerecords":[
				{
					"change_item":"企业名称",
					"change_date":"2017-11-29",
					"before_content":"苏州新科兰德科技有限公司北京分公司",
					"after_content":"天聚地合（苏州）数据股份有限公司北京分公司"
				}
			],
			"partners":[
				
			],
			"regist_capi_new":"-",
			"currency_unit":"-"
		}
	}
}

[danger] 返回code为0时计费。

企业著作权查询

支持全国企业著作权信息查询

最低 0.2元/次

请求地址

GET https://api.isoyu.com/enterprise/copyright

请求参数

名称 必填 类型 说明
appCode 是 string 用户授权码，参考API调用
keyword 是 string 关键字(公司名或keyNo)
pageIndex 否 int 请求页码，默认为1
pageSize 否 int 请求数据条数， 默认10条

返回参数

名称 类型 说明
Owner String 作品著作权人
Category String 类别
Name String 作品名称
RegisterNo String 登记号
RegisterDate String 登记日期
PublishDate String 首次发布日期
FinishDate String 创作完成日期

SDK调用

$client = new Client("YourAppCode");



$result = $client->enterpriseCopyright()

    ->withKeyword('小米科技有限责任公司')

    ->request();

dump($result);

返回数据示例：

{
	"code":0,
	"message":"操作成功",
	"data":{
   "pageSize": 10,

        "pageIndex": 1,

        "totalRecords": 143,

        "data": [

            {

                "Category": "美术",

                "Name": "米兔趣味童年",

                "Owner": "小米科技有限责任公司",

                "RegisterNo": "国作登字-2018-F-00576287",

                "RegisterDate": "2018-07-09 00:00:00",

                "FinishDate": "2018-07-09 00:00:00",

                "PublishDate": "2018-07-09 00:00:00"

            },

            {

                "Category": "文字",

                "Name": "爱的梦想（客服之歌）",

                "Owner": "小米科技有限责任公司",

                "RegisterNo": "国作登字-2018-A-00548611",

                "RegisterDate": "2018-05-18 00:00:00",

                "FinishDate": "2018-05-18 00:00:00",

                "PublishDate": "2018-05-18 00:00:00"

            },

            {

                "Category": "美术",

                "Name": "Mitype17",

                "Owner": "小米科技有限责任公司",

                "RegisterNo": "国作登字-2018-F-00501179",

                "RegisterDate": "2018-03-16 00:00:00",

                "FinishDate": "2018-03-16 00:00:00",

                "PublishDate": "2018-03-16 00:00:00"

            },

            {

                "Category": "美术",

                "Name": "米家定制logo",

                "Owner": "小米科技有限责任公司",

                "RegisterNo": "国作登字-2017-F-00477188",

                "RegisterDate": "2017-06-20 00:00:00",

                "FinishDate": "2017-06-20 00:00:00",

                "PublishDate": "2017-06-20 00:00:00"

            },

            {

                "Category": "美术",

                "Name": "Mi图形",

                "Owner": "小米科技有限责任公司",

                "RegisterNo": "国作登字-2017-F-00360143",

                "RegisterDate": "2017-03-01 00:00:00",

                "FinishDate": "2017-03-01 00:00:00",

                "PublishDate": "2017-03-01 00:00:00"

            },

            {

                "Category": "美术",

                "Name": "MIJIA及图形",

                "Owner": "小米科技有限责任公司",

                "RegisterNo": "国作登字-2016-F-00269796",

                "RegisterDate": "2016-05-17 00:00:00",

                "FinishDate": "2015-05-13 00:00:00",

                "PublishDate": "2015-05-14 00:00:00"

            },

            {

                "Category": "",

                "Name": "短信铃音",

                "Owner": "小米科技有限责任公司",

                "RegisterNo": "国作登字-2014-S-00134992",

                "RegisterDate": "2014-07-25 00:00:00",

                "FinishDate": "2014-07-25 00:00:00",

                "PublishDate": "2014-07-25 00:00:00"

            },

            {

                "Category": "音乐",

                "Name": "手机铃音",

                "Owner": "小米科技有限责任公司",

                "RegisterNo": "国作登字-2014-B-00128894",

                "RegisterDate": "2014-07-15 00:00:00",

                "FinishDate": "2010-08-23 00:00:00",

                "PublishDate": "2010-08-24 00:00:00"

            },

            {

                "Category": "美术",

                "Name": "小米桌面天气图标",

                "Owner": "小米科技有限责任公司",

                "RegisterNo": "国作登字-2013-F-00117358",

                "RegisterDate": "2013-12-13 00:00:00",

                "FinishDate": "2013-08-31 00:00:00",

                "PublishDate": "2013-09-18 00:00:00"

            },

            {

                "Category": "美术",

                "Name": "MI图形",

                "Owner": "北京小米科技有限责任公司",

                "RegisterNo": "国作登字-2013-F-00094023",

                "RegisterDate": "2013-06-03 00:00:00",

                "FinishDate": "2010-05-30 00:00:00",

                "PublishDate": "2010-08-13 00:00:00"

            }

        ]
	}
}

[danger] 返回code为0时计费。

三网手机实名制认证（详版）

检验姓名、身份证、手机号码是否一致，并返回不一致详情，支持移动、联通和电信。

最低 0.32元/次

请求地址

GET https://api.isoyu.com/telecom/detail

请求参数

名称 必填 类型 说明
appCode 是 string 用户授权码，参考API调用
realname 是 string 姓名
idcard 是 string 身份证号码
mobile 是 string 手机号码

返回data参数

名称 类型 说明
res int 匹配结果 1 匹配 2 不匹配
resmsg string 匹配说明
type string 手机运营商
province string 归属地省
city string 归属地市
rescode string 11:匹配,21:姓名不匹配,22:身份证不匹配,23:姓名身份证均不匹配,33:身份证和姓名不一致

SDK调用

$client = new Client("YourAppCode");



$result = $client->telecomDetail()

    ->withIdcard('身份证号码')

    ->withRealname('真实姓名')

    ->withMobile('手机号码')
    ->request();

dump($result);

返回数据示例：

{
    "message": "查询成功",
    "data": {
        "orderid":"J339201812031141197115QV",/*流水号*/

        "res": 2,/*匹配结果：1匹配 2不匹配*/

        "resmsg": "三要素身份验证不一致",/*说明*/

         "type": "移动",/*手机运营商*/

        "province":"广东省",/*归属地省*/

        "city" : "惠州市",/**归属地城市*/

        "rescode":"24",/*匹配详情码,11:匹配,21:姓名不匹配,22:身份证不匹配,

23:姓名身份证均不匹配*/
    },
    "code": 0
}

[danger] 返回code为0时计费。

三网手机实名制认证

检验姓名、身份证、手机号码是否一致，支持移动、联通和电信。

最低 0.28元/次

请求地址

GET https://api.isoyu.com/telecom/query

请求参数

名称 必填 类型 说明
appCode 是 string 用户授权码，参考API调用
realname 是 string 姓名
idcard 是 string 身份证号码
mobile 是 string 手机号码
type 否 int 1:返回手机运营商,不输入及其他值则不返回
province 否 int 1:返回手机号归属地，province,city,不输入不返回

返回data参数

名称 类型 说明
realname string 姓名
idcard string 身份证号码
mobile string 手机号码
res int 匹配结果 1 匹配 2 不匹配
resmsg string 匹配说明
type string 手机运营商
province string 归属地省
city string 归属地市
rescode string 11:匹配,24:不匹配,具体要素不匹配未知

SDK调用

$client = new Client("YourAppCode");



$result = $client->telecomQuery()

    ->withIdcard('身份证号码')

    ->withRealname('真实姓名')

    ->withMobile('手机号码')
    ->withProvince(1)
    ->request();

dump($result);

返回数据示例：

{
    "message": "查询成功",
    "data": {
        "realname": "***",
        "mobile": "***********",
        "idcard": "******************",
        "res": 2,
        "resmsg": "三要素身份验证不一致,"
         "type": "移动"/*手机运营商,输入参数type为1时返回*/
        "orderid":"J201712251904163782Ay",
        "province":"广东省",/*归属地省*/
        "city" : "惠州市",/**归属地城市*/
        "rescode":"24",
    },
    "code": 0
}

[danger] 返回code为0时计费。

身份证实名认证

检测姓名和身份证号是否一致，身份证验证。

功能介绍

  1. 通过传递姓名+身份证号码，校验信息是否一致
  2. 适用于电商、游戏、直播、金融等需要用户实名认证的场景。

最低 0.10元/次

请求地址

GET https://api.isoyu.com/idcard/auth

请求参数

名称 必填 类型 说明
appCode 是 string 用户授权码，参考API调用
idNum 是 string 身份证号码
name 是 string 姓名(UTF-8)

返回data参数

名称 类型 说明
orderNo string 业务唯一流水号。例：011569554991100011
handleTime string 查询时间 例：2018-04-09 15:05:01
province string 身份
result string 返回结果 01-认证一致(收费) 02-认证不一致(收费) 03-认证不确定（收费） 04-认证失败(不收费)
gender string 性别，1-男 2-女
age string 年龄 例：26
remark string 备注 ，例：一致
city string 市
country string 县区
birthday string 生日

SDK调用

$client = new Client("YourAppCode");



$result = $client->idcardAuth()

    ->withIdNum('身份证号码')

    ->withName('真实姓名')

    ->request();

dump($result);

返回数据示例：

{
    "code": 0,
    "message": "成功",
    "data": {
       orderNo: "011569554991100011",
       handleTime: "2018-06-29 13:18:24",
       result: "02",
       province: "湖南省",
       city: "怀化市",
       country: "辰溪县",
       birthday: "19890725",
       age: "29",
       gender: "1",
       remark: "不一致"
    },
}

[danger] 返回code为0时计费。

银行卡三四元素检测（简版）

该接口可以同时检测银行卡三四要素，检测输入的姓名、身份证号码、银行卡号及手机号（如果不传则不验证手机）是否一致。

最低 0.20元/次

[danger] 建议对同一卡号查询做次数限制，分为连续错误次数限制和总请求次数限制两种，超过其中一种就会触发银联风控机制暂停调验。具体规则为连续错误3次，则第4次被锁定，当日总次数超过10次后锁定。恢复规则分为12h后恢复和次日0时恢复。锁定期间建议不要再反复提交，否者锁定时间会延长。另：若银行限制级别高于银联限制，则以银行限制要求为准。

请求地址

GET https://api.isoyu.com/bankcard/auth

请求参数

名称 必填 类型 说明
appCode 是 string 用户授权码，参考API调用
name 是 string 姓名
idNum 是 string 身份证号码
cardNo 是 string 银行卡卡号
mobile 否 string 银行预留手机号码，限单个，仅支持国内号码，11位 如果不传就不验证

返回参数

名称 类型 说明
handleTime string 查询时间 样例：2018-04-09 15:05:01
result string 认证结果。01：一致  02：不一致  03：认证不确定  04：认证失败。01、02收费
remark string 备注。样例：信息认证未通过(验证不一致)
bankName string 银行卡所属银行。样例：招商银行
cardType string 银行卡类型 样例：金穗借记卡
cardCategory string 银行卡类别 样例：借记卡
orderNo string 业务唯一流水号

SDK调用

$client = new Client("YourAppCode");



$result = $client->bankcardAuth()

    ->withName('姓名')

    ->withIdNum('身份证号码')

    ->withCardNo('银行卡号')
    ->withMobile('手机号')
    ->request();

dump($result);

返回示例：

{
    "message": "成功",
    "data": {
        "orderNo": "011608306716436130",

        "handleTime": "2020-12-18 23:51:56",

        "result": "02",

        "remark": "信息认证未通过(验证不一致)",

        "bankName": "招商银行",

        "cardType": "一卡通(银联卡)",

        "cardCategory": "借记卡"
    },
    "code": 0
}

银行卡三四元素检测（详版）

该接口可以同时检测银行卡三四要素，检测输入的姓名、身份证号码、银行卡号及手机号（如果不传则不验证手机）是否一致，并返回不一致详情。

最低 0.30元/次

[danger] 建议对同一卡号查询做次数限制，分为连续错误次数限制和总请求次数限制两种，超过其中一种就会触发银联风控机制暂停调验。具体规则为连续错误3次，则第4次被锁定，当日总次数超过10次后锁定。恢复规则分为12h后恢复和次日0时恢复。锁定期间建议不要再反复提交，否者锁定时间会延长。另：若银行限制级别高于银联限制，则以银行限制要求为准。

请求地址

GET https://api.isoyu.com/bankcard/auth_detail

请求参数

名称 必填 类型 说明
appCode 是 string 用户授权码，参考API调用
name 是 string 姓名
idNum 是 string 身份证号码
cardNo 是 string 银行卡卡号
mobile 否 string 银行预留手机号码，限单个，仅支持国内号码，11位 如果不传则不验证

返回参数

名称 类型 说明
handleTime string 查询时间
result string 认证结果代码。01:认证一致02:认证不一致03:认证不确定04:认证失败05:手机号码不匹配06:身份证号码不匹配07:姓名不匹配 01, 02, 05, 06, 07收费，其他不收费
remark string 备注。样例：信息认证未通过(验证不一致)
bankName string 银行卡所属银行。样例：招商银行
cardType string 银行卡类型 样例：金穗借记卡
cardCategory string 银行卡类别 样例：借记卡
orderNo string 业务唯一流水号

SDK调用

$client = new Client("YourAppCode");



$result = $client->bankcardAuthDetail()

    ->withName('姓名')

    ->withIdNum('身份证号码')

    ->withCardNo('银行卡号')
    ->withMobile('手机号')
    ->request();

dump($result);

返回示例：

{
    "message": "成功",
    "data": {
        "orderNo": "011608306716436130",

        "handleTime": "2020-12-18 23:51:56",

        "result": "07",

        "remark": "姓名不匹配",

        "bankName": "招商银行",

        "cardType": "一卡通(银联卡)",

        "cardCategory": "借记卡"
    },
    "code": 0
}

银行卡三元素检测

检测输入的姓名、身份证号码、银行卡号是否一致。

最低 0.20元/次

[danger] 建议对同一卡号查询做次数限制，分为连续错误次数限制和总请求次数限制两种，超过其中一种就会触发银联风控机制暂停调验。具体规则为连续错误3次，则第4次被锁定，当日总次数超过10次后锁定。恢复规则分为12h后恢复和次日0时恢复。锁定期间建议不要再反复提交，否者锁定时间会延长。另：若银行限制级别高于银联限制，则以银行限制要求为准。

请求地址

GET https://api.isoyu.com/verifybankcard3/query

请求参数

名称 必填 类型 说明
appCode 是 string 用户授权码，参考API调用
realname 是 string 姓名
idcard 是 string 身份证号码
bankcard 是 string 银行卡卡号
uorderid 否 string 用户订单号,8到32位数字字母组合，要保证唯一
isshow 否 int 是否显示匹配信息,0默认不显示，1显示

返回参数

名称 类型 说明
bankcard string 银行卡卡号
realname string 姓名
idcard string 身份证号码
res int 匹配结果，1:匹配 2:不匹配
message string 只有参数isshow不为空且不为0时显示

SDK调用

$client = new Client("YourAppCode");



$result = $client->verifybankcard3Query()

    ->withRealname('姓名')

    ->withIdcard('身份证号码')

    ->withBankcard('银行卡号')
    ->request();

dump($result);

返回示例：

{
    "message": "成功",
    "data": {
        "jobid": "JH2071191112162139847181e7",
        "bankcard": "*************",
        "realname": "***",
        "idcard": "***************",
        "res": 2,
        "message": "认证信息不匹配，银行卡无效"
    },
    "code": 0
}

银行卡四元素校验

通过传递姓名+身份证号码+手机号+银行卡卡号，校验信息是否一致。 毫秒级相应、直联保障，支持全国所有银联卡。 支持信息加密传输方式。 支持身份证、护照、港澳通行证等证件。

最低 0.20元/次

[danger] 建议对同一卡号查询做次数限制，分为连续错误次数限制和总请求次数限制两种，超过其中一种就会触发银联风控机制暂停调验。具体规则为连续错误3次，则第4次被锁定，当日总次数超过10次后锁定。恢复规则分为12h后恢复和次日0时恢复。锁定期间建议不要再反复提交，否者锁定时间会延长。另：若银行限制级别高于银联限制，则以银行限制要求为准。

请求地址

GET https://api.isoyu.com/verifybankcard4/query

请求参数

名称 必填 类型 说明
appCode 是 string 用户授权码，参考API调用
realname 是 string 姓名
idcard 是 string 身份证号码
bankcard 是 string 银行卡卡号
mobile 是 string 手机号码
uorderid 否 string 用户订单号,8到32位数字字母组合，要保证唯一

返回参数

名称 类型 说明
bankcard string 银行卡卡号
realname string 姓名
idcard string 身份证号码
res string 匹配结果，1:匹配 2:不匹配
mobile string 手机号码

SDK调用

$client = new Client("YourAppCode");



$result = $client->verifybankcard4Query()

    ->withRealname('姓名')

    ->withIdcard('身份证号码')

    ->withBankcard('银行卡号')
    ->withMobile('手机号码')
    ->request();

dump($result);

返回示例：

{
    "message": "成功",
    "data": {
        "jobid": "JH2131191113105116991630Np",/*本次查询流水号*/
        "realname": "****",/*姓名*/
        "bankcard": "************",/*银行卡卡号*/
        "idcard": ""************",/*身份证号码*/
        "mobile": "***********",/*预留手机号码*/
        "res": "2",/*验证结果，1:匹配 2:不匹配*/
        "message": "认证信息不匹配"/*描述*/
    },
    "code": 0
}