# 接口调用

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

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

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

目前提供的 SDK 包括: Java SDK, Android 慧眼身份核验SDK, IOS 慧眼身份核验SDK

# 如何升级SDK

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

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

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

# 慧眼平台的服务是什么？

慧眼平台的服务主要是指姓名核验，活体核验，企业信息核验，对公打款，资料上传，数字签名等对用户提供的功能。对开发者而言这些功能我们往往以 API 的形式提供，所以在慧眼的开发者文档中我们往往讲服务API简述为服务，服务API权限简述为服务权限。

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

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

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

您可以在慧眼平台使用手机号注册，登陆后可以在 我的应用 查看您的应用。应用信息中包含您的 Appkey 等信息，对应的密钥则需要根据您的联系方式发送至您的手机。

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

您可以在慧眼平台我的应用创建20个应用并取得相应的 Appkey，但是请注意每个 Appkey 的权限并非完全相同。

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

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

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

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

详见： API错误码说明

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

问题排查步骤：

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

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

3.响应超时时，排查确认是访问我们的一个接口超时还是所有接口都超时，如果所有的接口都出现超时，极大可能是网络问题。若只有个别接口访问超时，请联系我们。

# 库中无此号的原因

1.现役军人，刚退役不到2年的军人（一般为2年）、特殊部门人员；

2.身份真实，大学生户口迁移；

3.户口迁出，且没有在新的迁入地迁入；

4.户口迁入新迁入地，当地公安系统未上报到公安部（上报时间有地域差异）；

5.更改姓名，当地公安系统未上报到公安部（上报时间有地域差异）；

6.身份真实，但是逾期未办理；

7.身份真实，未更换二代身份证；

8.移民和死亡；

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