API概览

更新时间:
复制为 MD 格式

API标准及多语言预置SDK

本产品(Dyplsapi/2017-05-25)的OpenAPI采用RPC签名风格。我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(147535001692),在专家指导下进行签名对接。

在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

自定义签名场景

若您的业务场景有特殊需求,需通过自签名方式对接 API,建议优先咨询我们的技术支持团队(服务钉钉群:147535001692),获取专业指导以确保高效接入。

账号与安全准备

阿里云账号具备对所有资源的完全管理权限。一旦 AccessKey 泄露,所有相关资源都将面临未经授权访问的风险。为确保安全,建议创建一个仅具备 API 访问权限的RAM用户并配置其 AccessKey,同时基于最小权限原则 (PoLP) 配置 RAM 策略。仅在明确需要阿里云账号权限的特定场景下,才使用阿里云账号。

实际使用人报备A号码报备

API

标题

API概述

DeleteSecretAPhoneNoToCust 删除A号码报备记录 A号码报备数据删除。
QuerySecretAPhoneNoToCust 查询A号码报备状态 A号码报备状态查询。
CreateFixedNoAReport 提交A号码固话个人实名信息 通过API提交A号码固话个人信息报备。
GetDyplsOSSInfoForUploadFile 获取A号码报备OSS配置信息 获取OSS资源配置信息,此配置信息将用于后续OSS图片上传操作。
CreatePhoneNoAReport 提交A号码手机号个人实名信息 通过API提交A号码手机号个人信息报备。

添加号码绑定

API

标题

API概述

BindAxb AXB中间号-号码绑定 AXB中间号,是将拨打关系限定在一对一关系中,用户A可以通过中间号码X联系到用户B,用户B也可以通过中间号码X联系到用户A。
BindAxn AXN隐私号-号码绑定 添加AXN隐私号的绑定关系。AXN隐私号是为A用户分配一个专属的隐私号,任何号码N通过拨打X号码都可以转接到A。
BindAxnExtension AXN分机号-号码绑定 添加AXN分机号的绑定关系。AXN分机号与AXN隐私号功能类似,AXN分机号在AXN基础上引入了分机号,从而降低X号码的使用量,在呼叫时候首先拨打X号码,听到提示音后输入对应分机号转接到A。
BindAxg AXG隐私号-号码绑定 添加AXG号码的绑定关系。AXG产品是针对有用户分级需求、限制呼叫范围、限制抢单等场景的客户需求提供的号码隐私保护解决方案,其中G代表一个号码组,可以根据需要添加号码。
BindBatchAxg 批量添加AXG号码的绑定关系 批量添加AXG号码的绑定关系。AXG产品是针对有用户分级需求、限制呼叫范围、限制抢单等场景的客户需求提供的号码隐私保护解决方案,其中G代表一个号码组,可以根据需要添加号码。
UpdateSubscription 修改已绑定的号码 修改号码的绑定关系。
UnbindSubscription 解除已绑定的号码 解除号码的绑定关系。

查询号码绑定

API

标题

API概述

QuerySubscriptionDetail 查询号码绑定详情 查询号码的绑定详情。获取号码绑定关系状态、分机号码、是否录音、ASR状态等信息。
QuerySubsId 查询号码绑定ID 查询绑定关系的唯一标识SubsId。
QuerySecretNoDetail 查询隐私号码属性 查询隐私号码的属性信息。

G号码组

API

标题

API概述

CreateAxgGroup 创建G号码组 创建G号码组。仅AXG隐私号类型的号码池支持设置G号码组。
OperateAxgGroup 修改G号码组 修改G号码组中的号码,可以对号码进行添加、删除、全量替换操作。
DeleteAxgGroup 删除G号码组 删除G号码组。仅AXG隐私号类型的号码池支持设置G号码组。

录音及ASR获取

API

标题

API概述

QueryRecordFileDownloadUrl 获取录音文件的下载链接 根据号码池Key、呼叫记录ID、呼叫发起时间等获取录音文件的下载链接。
GetTotalPublicUrl 获取响铃放音的录音下载链接 获取响铃放音的录音下载链接。
GetSecretAsrDetail 获取ASR识别结果详情 获取ASR识别结果详情。

号码资源管理

API

标题

API概述

AddSecretBlacklist 添加黑名单 向号码池添加黑名单。仅AXN隐私号、AXN分机号、95AXN隐私号类型的号码池支持设置黑名单。
DeleteSecretBlacklist 删除黑名单 删除号码池的黑名单。仅AXN隐私号、AXN分机号、95AXN隐私号类型的号码池支持设置黑名单。
OperateBlackNo 新增或删除黑名单 新增或删除号池黑名单。仅AXN隐私号、AXN分机号、95AXN隐私号类型的号码池支持设置黑名单。
ReleaseSecretNo 释放号码 释放号码。释放后所选号码将不可继续使用。
LockSecretNo 锁定号码 锁定号码。适用于需要临时屏蔽异常号码的场景。
UnlockSecretNo 解锁号码 解锁号码。解除号码的临时屏蔽。

电商物流行业接口

API

标题

API概述

AddAxnTrackNo AXN隐私号添加运单号 AXN隐私号添加运单号。
QueryPhoneNoAByTrackNo 进行运单号广播推送 广播推送运单号。