集成概览
通过在业务系统中集成号码认证服务，您可根据业务需要实现一键登录等场景，简化运营、管理成本。号码认证服务的集成分为客户端集成、服务端集成，本文将分别介绍客户端SDK、服务端SDK的基本信息及集成注意事项。
准备工作
在开始集成号码认证服务前，您需完成以下准备工作：
基本交互流程
客户端：通过集成客户端SDK，实现与用户的交互，并与服务端集成的OpenAPI完成交互逻辑。
服务端：通过集成阿里云SDK，调用号码认证服务提供的OpenAPI，根据客户端信息，完成认证与取号操作。
不同认证功能的具体交互流程，请参见交互流程。
客户端集成
号码认证服务提供号码认证、融合认证等不同功能产品和Android、iOS等不同客户端的SDK，您可以根据业务实际情况选择SDK进行集成。
客户端SDK详情，请参见客户端SDK参考。
服务端集成
号码认证服务通过OpenAPI开放一键登录、本机号码校验、短信认证等多种接口，通过集成阿里云SDK您可以实现服务端接口调用。
OpenAPI介绍
阿里云OpenAPI为开发者提供了一系列开放的应用程序接口，使您可以通过这些应用程序接口来方便地管理云上资源、数据和服务等内容。更多信息，请参见什么是OpenAPI。
版本说明
版本号 | 说明 |
推荐使用 |
2017-05-25代表的是API版本号而非时间概念，所展示的都是最新的API公开数据，并非自2017-05-25之后就未更新。
接入点说明
根据相关资源所在地域，选择对应的服务接入点地址，以获得最低延迟。
全局接入域名：dypnsapi.aliyuncs.com。
更多信息，请参见服务接入点。
支持的调用身份
号码认证服务支持通过如下用户身份调用OpenAPI。推荐您使用RAM用户或RAM角色，根据业务的实际情况按需分配权限后进行接口调用。
用户身份 | 支持情况 |
支持 | |
RAM用户（推荐） | 支持 |
RAM角色（推荐） | 支持 |
您阿里云账号登录OpenAPI网站后，OpenAPI默认使用您的阿里云账号进行在线OpenAPI调试。阿里云账号拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维。请根据业务的实际情况按需分配权限后进行接口调用。RAM用户需具备操作权限。具体操作，请参见使用RAM进行访问控制。
在线调试
为了能够让开发者快速高效地学习和使用云产品OpenAPI，阿里云为用户提供OpenAPI网站。它是一款集OpenAPI智能搜索、文档、在线调试、SDK获取、CodeSample、调用出错诊断、调用统计为一体的产品。您可以在OpenAPI门户中调用阿里云各云产品开放的OpenAPI，查看OpenAPI请求和返回结果。此外，OpenAPI门户会自动生成相应的SDK调用示例，帮助您快速使用阿里云产品。
调试API入口为：https://api.alibabacloud.com/api/Dypnsapi/2017-05-25/
集成方式
号码认证服务OpenAPI提供SDK等集成方式，您可以根据业务的实际需要进行选择。
阿里云SDK
阿里云为开发者提供了多种语言的SDK。您只需集成SDK，通过SDK暴露的方法直接调用OpenAPI。SDK统一封装了签名逻辑、超时机制、重试机制，并根据文档返回结构化Response对象，易于开发。更多关于阿里云SDK的介绍，请参见阿里云SDK。
号码认证服务SDK支持的语言及依赖安装方法请参见服务端SDK参考。
自定义封装API调用
若以上方案无法满足您的业务需要，您可自行封装请求调用OpenAPI（不推荐），详情请参见V3版本请求体&签名机制。
注意事项
如果调用号码认证API后返回错误，您需要根据返回的错误码提示检查传入的请求参数及其取值是否正确。更多信息，请参见错误码中心。
您也可以记录下调用返回的RequestID或SDK报错信息，通过阿里云OpenAPI诊断平台进行自助诊断。