# 接口调用

# 接口是通过什么协议访问的?

接口支持HTTP,HTTPS GET/POST请求,所有接口需在请求中加入公共参数,请求及返回结果都使用 UTF-8 字符集进行编码。

# 接口有哪些SDK可以直接使用?

目前提供的SDK包括: 识蛛云服务 Java SDK,PKI云服务 Java SDK

# 如何升级SDK

SDK教程中详细记录了SDK各个版本的变动详情,请对照当前使用的版本至最新版本的说明,以确保服务的兼容。

# 如何开启/关闭SDK错误日志

//开启日志
ApiLogger.setNeedEnableLogger(true);
//关闭日志
ApiLogger.setNeedEnableLogger(false);

# 识蛛平台的服务是什么?

识蛛平台的服务主要是指姓名核验,活体核验等对用户提供的功能。对开发者而言这些功能我们往往以 API 的形式提供,所以在识蛛的开发者文档中我们往往讲服务API简述为服务, 服务API权限简述为服务权限。

# 为什么要开启数字签名?

开启数字签名,可以确保您的Key被安全地调用。 例如,在数字签名未开启的情况下,您的Key泄露,极易发起非法访问;如果非法访问被平台策略自动识别,我们会对该Key进行强制处理,导致Key不能正常使用;如果开启数字签名,即使Key被泄露,窃取者在拿不到数字签名的情况下,是无法正常使用该Key发起请求,极大地保障您的Key安全和正常使用。

# 如何获取应用APPKEY和密钥?

您可以在识蛛平台使用手机号或邮箱注册,登陆后可以在 我的应用 查看您的应用。应用信息中包含您的APPKEY等信息,对应的密钥则需要根据您的联系方式发送至您的手机或邮箱。

# 每个账号可以创建多少个应用?

您可以在识蛛平台我的应用创建多个应用并取得响应的appkey,但是请注意每个appkey的权限并非完全相同。

# 应用如何获取服务(API)访问权限?

# 通过应用申请

您可以在识蛛平台 我的应用 在应用信息左侧操作栏点击:

[API申请] -> [服务申请] -> [申请新服务]

查看当前识蛛平台提供的服务,勾选您需要使用的服务并提申请,我们的工作人员将会在1~2工作日内尽快受理您的申请为您提供服务。 申请通过之后您将拥有此服务权限并将此权限授权给对应的key。

# 通过服务信息申请

您可以在识蛛平台 我的识蛛 的主页面当中可以看到当前用户已经申请的服务,点击左侧的 查看全部服务 可以看到当前用户已经拥有的服务。

点击 [申请新服务]

查看当前识蛛平台提供的服务,勾选您需要使用的服务并提申请,我们的工作人员将会在1~2工作日内尽快受理您的申请为您提供服务。申请通过之后用户将 拥有对应的服务权限。用户拥有服务权限后可以自主为自己的应用分配,无需再度提交申请。

# 服务API访问出错怎么办?

当您遇到服务API访问出错的情况,请您先对照错误码表,查询您的错误原因和解决方案。

# 服务API返回的全局错误码有哪些?

合作伙伴调用相关的服务接口时,响应正文中包含了常见的错误的错误码和错误描述。对应的信息都可以在我们提供的API错误码说明中找到。

详见: API错误码说明

# 如何解决接口访问超时的问题?

问题排查步骤:

1.先确认是链接超时还是响应超时?

2.链接超时时,多数情况下是您网络环境存在问题,请排查您的网络环境。

3.响应超时时,排查确认是访问我们的一个接口超时还是所有接口都超时,如果所有的接口都出现超时,极大可能是网络问题。若只有个别接口访问超时,请联系我们。 您可以在 [我的应用]-[在线测试] 测试功能是否正常。

# 人像图片过大如何处理?

人脸比对等业务对上传的图片大小有限,为减少开发人员在此处花费的精力,我们提供了几种对图片操作的示例(包括对图片大小,格式等处理),以供开发者参考

详见: 图片处理

# 如何支持旧版15位证件号

# 方法1. 全局开启15位证件号码转换

DefaultApiClient.enabledIdcard15To18();

# 方法2. 手动使用15为证件号码转换工具类 (推荐)

String idcard15 = "15位证件号码";
String idcard18 = Utils.transformIdcard15to18(idcard15);

# 库中无此号的原因

1.现役军人,刚退役不到2年的军人(一般为2年)、特殊部门人员;

2.身份真实,大学生户口迁移;

3.户口迁出,且没有在新的迁入地迁入;

4.户口迁入新迁入地,当地公安系统未上报到公安部(上报时间有地域差异);

5.更改姓名,当地公安系统未上报到公安部(上报时间有地域差异);

6.身份真实,但是逾期未办理;

7.身份真实,未更换二代身份证;

8.移民和死亡;

9.身份证号确实不存在。

最后更新于: 3/10/2023, 4:48:16 PM