常见问题解答

查找关于淋欧斯认证开放平台的常见问题与解决方案。如果找不到您需要的问题,请联系我们的技术支持团队。

🔍

未找到相关问题

请尝试其他关键词,或直接联系技术支持获取帮助。

账号与实名认证

如何注册淋欧斯认证开放平台账号?

+

注册流程如下:

  1. 访问官网 https://www.verify.linos.cn
  2. 点击右上角"注册"按钮
  3. 填写账号、邮箱、设置密码(≥6位)
  4. 获取并填写邮箱验证码
  5. 阅读并同意《服务条款》和《隐私政策》
  6. 点击"注册"完成账号创建
注意:注册后需要完成实名认证才能使用API服务。

为什么需要实名认证?如何进行实名认证?

+

实名认证必要性:

  • 根据《网络安全法》和《反电信网络诈骗法》,提供实名认证服务必须进行实名登记
  • 确保API调用者身份可追溯,防范违法违规使用
  • 企业用户可享受更高额度的API调用权限

实名认证流程:

  1. 登录控制台,进入"账号中心" → "实名认证"
  2. 选择认证类型:个人认证或企业认证
  3. 个人认证:上传身份证正反面照片,进行人脸识别
  4. 企业认证:上传营业执照、法定代表人身份证,填写对公账户信息
  5. 提交审核,通常1-2个工作日内完成
企业认证通过后,可申请增值税专用发票。

忘记密码怎么办?

+

找回密码步骤:

  1. 在登录页面点击"忘记密码"
  2. 输入注册时使用的邮箱地址
  3. 查收邮件,点击重置密码链接(链接24小时内有效)
  4. 设置新密码(≥6位,建议包含字母、数字和特殊字符)
  5. 使用新密码登录
如果邮箱已无法使用,请联系客服提供账号信息和身份证明进行人工重置。

账号被冻结或禁用怎么办?

+

账号可能被冻结的原因:

  • 长时间未登录(超过365天)
  • 账户余额为负且超过30天未补缴
  • 违反《服务条款》,如用于违法违规用途
  • 被监管部门要求配合调查

解决方法:

  1. 登录控制台查看冻结原因和通知
  2. 如果是余额问题,请及时充值
  3. 如果是违规问题,请根据提示整改后联系客服申诉
  4. 紧急情况可发送邮件至 Linos@Linos.cn 说明情况
API接入与使用

如何获取API密钥(SecretId/SecretKey)?

+

获取API密钥步骤:

  1. 登录控制台,进入"用户中心" → "API管理"
  2. 点击"创建密钥"按钮
  3. 系统将生成SecretId和SecretKey
  4. 立即复制并妥善保存SecretKey(仅显示一次)
  5. SecretId可随时在控制台查看
⚠️ 安全警告:SecretKey相当于您的账号密码,请勿在前端代码中硬编码,也不要通过邮件、聊天工具传输。

HMAC-SHA256签名总是错误,如何正确生成?

+

签名生成常见问题及解决方法:

  • 时间戳问题:确保使用Unix秒级时间戳,与服务器时间差不超过±300秒
  • BodyHash计算:GET请求BodyHash是对空字符串的SHA256;POST请求必须是原始请求体的SHA256
  • 换行符问题:使用LF(\n)而非CRLF(\r\n),末尾不要额外换行
  • 编码问题:所有字符串使用UTF-8编码
  • Action大小写:Action必须是小写(如"verify"而非"Verify")

正确示例:

# 待签字符串格式
1735689600\n
POST\n
verify\n
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

我们提供了详细的签名计算示例,包括PHP、Python、Java等语言的代码示例。

API调用频率限制是多少?

+

不同接口的默认频率限制:

接口类型 默认限制 说明
实名认证(verify) 100次/秒 二要素核验
人脸核身发起(face_start) 50次/秒 生成认证链接
人脸核身查询(face_result) 200次/秒 轮询结果
账户查询(account) 10次/秒 查询余额和用量

如需提高限额,请联系客服申请。企业认证用户可获得更高默认限额。

当触发频率限制时,API将返回HTTP 429状态码,错误信息为"RateLimitExceeded"。

如何测试API而不产生实际费用?

+

我们提供以下测试方式:

  1. 沙箱环境:使用测试环境API地址 https://api-test.verify.linos.cn,所有调用不产生费用
  2. 控制台在线测试:在"API管理" → "在线测试"中测试,默认使用测试模式(不扣费)
  3. 测试专用SKU:使用test_alipaytest_wechat等测试SKU,返回模拟数据
  4. 免费额度:新用户注册后赠送100次免费调用额度
沙箱环境与生产环境API完全兼容,返回固定的模拟数据,适合开发和调试阶段使用。
计费与充值

平台如何计费?有哪些收费项目?

+

计费模式:预付费模式,先充值后使用。

收费项目:

  • 实名认证二要素:0.3元/次(支付宝/微信通道)
  • 人脸核身:1.0-1.5元/次(不同通道价格不同)
  • 企业信息核验:1.0元/次
  • 银行卡核验:0.5元/次(三要素)/0.8元/次(四要素)

计费规则:

  • 只要接口返回明确结果(一致/不一致/无记录),无论是否满足业务预期,均视为一次有效调用并扣费
  • 仅当系统故障、网络超时等导致无结果返回时不扣费
  • 人脸核身在用户完成认证后才扣费,发起核身链接时不扣费
详细价格请查看控制台"价格中心"或调用/account接口获取实时价格。

如何充值?支持哪些支付方式?

+

充值步骤:

  1. 登录控制台,进入"费用中心" → "充值"
  2. 选择充值金额(最低50元)
  3. 选择支付方式
  4. 完成支付,余额实时到账

支持的支付方式:

  • 支付宝:支持个人和企业支付宝账户
  • 微信支付:支持个人微信支付
  • 企业对公转账:支持银行柜台、网银转账(需备注账号ID)
  • API充值:通过企业API对接,适合大额自动充值
对公转账通常需要1-3个工作日到账,请提前安排。充值后如需发票,请在"发票管理"中申请。

余额不足会有什么影响?如何设置余额预警?

+

余额不足影响:

  • 当余额低于单次调用费用时,API调用将失败,返回"余额不足"错误
  • 余额为负时,账号将被暂停服务,直到补缴欠款
  • 连续30天余额为负,账号可能被注销

设置余额预警:

  1. 登录控制台,进入"费用中心" → "余额预警"
  2. 设置预警阈值(如50元、100元)
  3. 添加接收预警的手机号、邮箱
  4. 开启预警开关

当余额低于阈值时,系统会自动发送短信、邮件和站内信通知。

建议企业用户设置多个预警联系人,避免因未及时充值导致业务中断。

如何开具发票?发票类型有哪些?

+

发票类型:

  • 增值税普通发票:个人或企业均可申请,电子发票发送至邮箱
  • 增值税专用发票:仅企业认证用户可申请,纸质发票邮寄

申请流程:

  1. 登录控制台,进入"费用中心" → "发票管理"
  2. 点击"申请发票",选择发票类型
  3. 填写发票抬头、税号等信息
  4. 选择需要开票的充值记录(发票金额不能超过已充值总额)
  5. 提交申请,审核通过后1-3个工作日内开具
发票内容为"技术服务费"。企业认证用户首次申请专票需上传营业执照和一般纳税人证明。
人脸核身

人脸核身有哪些通道?如何选择?

+

人脸核身通道对比:

通道SKU 名称 价格 特点
alipay_face 支付宝人脸 1.0元 需用支付宝APP扫码,准确率高
wechat_auth 微信授权实名 1.0元 无刷脸,仅实名信息核验
wechat_face 腾讯人脸核身 1.5元 需用微信APP扫码,支持H5
wechat_eid 微信E证通 1.5元 微信内打开,体验最佳
aliyun_face 阿里云金融级实人 1.5元 支持H5、APP,准确率高

选择建议:

  • 支付宝用户多:选择alipay_face
  • 微信生态内:选择wechat_eid
  • 追求最高准确率:选择aliyun_face
  • 仅需实名信息:选择wechat_auth(最便宜)

人脸核身链接有效期是多久?超时如何处理?

+

有效期:人脸核身链接默认有效期为10分钟(600秒),从调用face_start接口成功时开始计算。

超时处理:

  1. 当链接超时后,用户扫码或打开链接会看到"认证已过期"提示
  2. 调用face_result查询时,状态为expired,错误信息为"认证超时未完成"
  3. 超时不会扣费,需要重新调用face_start生成新的认证链接

最佳实践:

  • 在生成链接后,立即展示给用户,避免用户等待过久
  • 前端页面显示倒计时,提醒用户剩余时间
  • 设置合理的轮询间隔(建议3-5秒),及时获取结果
  • 当检测到即将超时时,可提示用户刷新页面重新发起
超时不等于认证失败,只是用户未在有效期内完成操作。如果用户中途退出,也会返回expired状态。

人脸核身失败常见原因有哪些?

+

技术原因:

  • 光线问题:过暗、过亮、逆光、强光反射
  • 角度问题:人脸倾斜、侧脸、低头、仰头
  • 遮挡问题:帽子、口罩、头发、眼镜反光
  • 质量问题:模糊、分辨率低、运动模糊
  • 环境问题:背景复杂、多人脸、动态背景

业务原因:

  • 信息不匹配:姓名、身份证号与权威数据源不一致
  • 证件问题:身份证已过期、已注销、伪造
  • 年龄限制:未成年人(部分通道不支持)
  • 户籍问题:港澳台及外籍人士(部分通道不支持)

用户引导建议:

  1. 提示用户在光线充足、均匀的环境下操作
  2. 要求用户正对摄像头,露出整个面部
  3. 移除帽子、口罩等遮挡物
  4. 确保网络连接稳定
  5. 提供清晰的语音/文字引导
当认证失败时,face_result接口会返回具体的失败原因,可在前端展示给用户,帮助其纠正。
错误码排查

常见API错误码及解决方法

+

鉴权类错误:

错误码 错误信息 解决方法
101001 Unauthorized 检查SecretId是否正确,是否已启用API
101002 SignatureError 检查签名算法,特别是时间戳、BodyHash、换行符
101003 TimestampExpired 确保服务器时间与标准时间同步,误差不超过5分钟

业务类错误:

错误码 错误信息 解决方法
103001 InsufficientBalance 及时充值,确保余额充足
104001 NotFound 检查API路径是否正确,action是否小写
105001 RateLimitExceeded 降低调用频率,或申请提高限额

数据源错误:

  • NO_RECORD:数据源中无此记录,可能是身份证号错误或未入库
  • EXPIRED:证件已过期或注销
  • SERVICE_UNAVAILABLE:第三方数据源暂时不可用,建议重试
所有错误响应都包含详细的错误信息,请仔细阅读msg字段。如果问题持续,请联系技术支持并提供request_id

API返回成功但结果不符合预期怎么办?

+

当API返回code:200但结果不符合预期时,请按以下步骤排查:

  1. 检查输入参数:确认姓名、身份证号等参数是否正确,特别注意空格、特殊字符
  2. 核对数据源:不同通道使用的数据源可能不同,支付宝和微信的结果可能有差异
  3. 验证测试数据:使用已知正确的测试数据进行对比测试
  4. 查看详细日志:在控制台"调用记录"中查看完整的请求和响应
  5. 检查SKU选择:确保使用了正确的SKU,如alipaywechat是不同的通道
  6. 确认证件状态:用户证件可能已过期、挂失或注销

常见问题场景:

  • 新办身份证:刚办理的身份证可能需要3-7个工作日才能同步到数据源
  • 户籍迁移:户口迁移后,信息更新可能有延迟
  • 姓名变更:改名后,新旧名字可能同时存在一段时间
  • 军人证件:部分通道不支持军官证、士兵证等特殊证件
如果确认输入正确但结果持续异常,请提供request_id联系技术支持,我们会协助核查数据源情况。
安全合规

如何确保API调用安全?

+

安全最佳实践:

  1. 密钥管理
    • SecretKey仅存储在服务端,绝不暴露在前端
    • 定期轮换密钥(建议每90天)
    • 不同环境(开发、测试、生产)使用不同密钥
    • 为团队成员分配最小必要权限
  2. 传输安全
    • 始终使用HTTPS调用API
    • 启用TLS 1.2及以上版本
    • 敏感字段(姓名、身份证号)使用RSA公钥加密
  3. 访问控制
    • 配置IP白名单,限制API调用来源
    • 启用操作日志审计,监控异常调用
    • 设置API调用频率限制
  4. 代码安全
    • 不在代码中硬编码密钥,使用环境变量
    • 定期更新SDK和依赖库
    • 进行安全代码审查
我们提供IP白名单、操作日志、频率限制等安全功能,请在控制台"安全设置"中配置。

平台如何处理用户隐私数据?

+

我们严格遵守《个人信息保护法》《数据安全法》等相关法律法规:

  • 数据收集:仅收集提供服务所必需的最小范围个人信息
  • 数据存储:敏感信息(身份证号、人脸特征)加密存储,存储期限不超过必要时间
  • 数据使用:仅用于身份核验,不用于其他目的,不对外共享
  • 数据删除:用户注销账号后,30天内删除所有个人数据
  • 数据跨境:所有数据存储在境内服务器,不向境外传输

人脸信息处理特别说明:

  1. 人脸信息属于生物识别敏感信息,我们仅提取特征值,不存储原始图像
  2. 特征值加密存储,访问受严格控制
  3. 留存期限为3年,之后匿名化处理
  4. 使用前必须取得用户单独同意
详细信息请参阅我们的《隐私政策》。如需数据删除、导出等权利行使,请联系客服。

合规性要求有哪些?如何满足监管要求?

+

主要合规要求:

  • 《网络安全法》:网络运营者需对用户身份进行核验
  • 《反电信网络诈骗法》:建立反诈内部控制机制,对涉诈异常账号重新核验
  • 《个人信息保护法》:处理个人信息需取得个人同意,遵循最小必要原则
  • 《人脸识别技术应用安全管理办法》:人脸信息需单独同意,不得强制使用

用户侧合规建议:

  1. 明示告知:在隐私政策中明确说明身份核验的目的、方式、范围
  2. 单独同意:对人脸识别等敏感信息处理取得用户单独同意
  3. 最小必要:仅收集业务必需的个人信息,不超范围收集
  4. 安全保护:采取技术措施保障个人信息安全
  5. 记录留存:保存核验记录至少3年,以备监管检查

平台提供的合规支持:

  • 提供标准化的用户授权页面模板
  • 记录完整的核验日志,包括时间、IP、结果
  • 支持数据导出,便于用户行使个人信息权利
  • 定期发布合规指南和更新
建议企业用户建立内部的个人信息保护合规制度,定期进行合规培训。
其他问题

如何联系技术支持?

+

技术支持渠道:

  • 在线工单:登录控制台,进入"工单系统"提交问题(推荐)
  • 客服邮箱:Linos@Linos.cn(24小时内回复)
  • 电话支持:19029088749(工作日9:00-18:00)
  • 在线客服:官网右下角在线聊天(工作日9:00-21:00)
  • 官网客服 https://www.linos.cn/kefu

问题反馈建议:

  1. 提供详细的错误描述和复现步骤
  2. 附上request_id(API调用返回的)
  3. 提供调用时间、接口名称、SKU等信息
  4. 如涉及代码问题,提供代码片段(隐去密钥)
  5. 说明紧急程度和影响范围
企业认证用户享有优先技术支持服务。紧急问题请直接致电客服热线。

服务等级协议(SLA)是什么?

+

可用性承诺:

  • API服务月度可用性不低于99.9%
  • 计划维护提前24小时通知,单次不超过4小时
  • 紧急维护尽可能缩短时间,事后提供报告

性能承诺:

  • API平均响应时间:实名认证≤800ms,人脸核身≤1500ms
  • 99%的请求在承诺时间内完成
  • 数据传输加密,完整性校验

故障响应:

  • 严重故障(服务完全不可用):15分钟内响应,2小时内恢复
  • 一般故障(部分功能异常):1小时内响应,4小时内恢复
  • 轻微故障(性能下降):4小时内响应,24小时内恢复

赔偿方案:

  • 可用性低于99.9%但高于99.0%:赔偿当月费用的10%
  • 可用性低于99.0%:赔偿当月费用的30%
  • 数据丢失或泄露:根据实际损失协商赔偿
详细SLA条款请查阅《服务等级协议》。不可抗力(如自然灾害、网络骨干故障)导致的服务中断不在赔偿范围内。

平台未来规划和新功能预告

+

近期规划(2026年Q4):

  • 企业信息核验增强:支持更多维度的企业信息核验,包括股东信息、对外投资等
  • 银行卡核验升级:支持信用卡核验,增加银行卡BIN信息查询
  • 多语言SDK:发布Java、Go、Node.js、C#等语言的官方SDK
  • 可视化数据分析:提供调用量、成功率、趋势等可视化报表

中期规划(2027年Q1-Q2):

  • 区块链存证:核验结果上链存证,提供司法采信证明
  • AI风控引擎:基于机器学习的欺诈风险识别和预警
  • 全球化支持:支持港澳台及外籍人士身份核验
  • 私有化部署:为企业客户提供私有化部署方案

长期愿景:

  • 构建可信数字身份生态系统
  • 推动跨平台身份互认
  • 探索去中心化身份认证(DID)技术
  • 成为国内领先的数字身份服务提供商
您可以在控制台"产品动态"中查看最新功能发布和路线图更新。如有特定需求,欢迎通过工单系统反馈。