接口调用

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

接口支持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.身份证号确实不存在。