帮助与文档

全部产品

隐私号码服务
  • 产品简介

    • 产品介绍
    • 业务场景示例
  • 用户指南

    • 服务开通
    • 号码绑定
    • 号码使用统计
  • API开发指南

    • JAVA

      • 隐私号码服务 API 概述
      • 公共请求头部
      • AXN模式绑定
      • AXN模式解绑
      • AXN模式号码指定
      • AXB模式绑定操作
      • AXB模式解绑操作
      • AXB模式转绑操作
      • AXE模式绑定操作
      • AXE模式解绑操作
      • 查询号码状态
      • 查询号码的呼叫详情
      • 号码申请接口
      • 查询全部号码接口
      • 号码退订接口
      • 录音文件下载
      • 返回码页
  • 隐私号码服务使用声明

  • 常见问题

产品介绍

最近更新时间:2018-06-08 10:16:35

隐私号码服务是海翕云平台推出的一款应用保护用户号码隐私、管理企业员工通话服务的产品,企业可以通过PaaS (API 接口调用)和SaaS(在页面点击配置)两种方式接入使用。

产品类型

  • AXB中间号:是为了保护一对一专属服务场景中的用户A、服务方B的隐私,为A、B这一对通话的专属隐私保护功能,如果可以收集用户A的号码、服务方B的号码,推荐有限使用此产品,例如打车服务平台既可以知道用户A、也知道司机B的号码。

  • AXN隐私号:在不占用手机SIM卡槽的情况下为用户A增加一个第二号码,保护用户A的隐私,其他人都可以通过拨打X号码,接通用户A,适合于只能拿到用户A号码的场景。

  • AXE分机号:为用户A分配隐私号X+分机号,A对外的号码都以X+分机号替代,所有与A的通话都通过X+分机号建立,保护A号码不泄漏,提高号码利用率。

功能描述

  • AXB中间号:X表示虚拟号码,A、B为相互保密的两个业务受益用户,A和B用户之间不知道对方真实号码的存在,他们所拨打的被叫号码都是X。AXB场景下X号码允许被多组号码进行绑定,同一个X号码不能被相同的A或者B号码同时绑定。

  • AXN隐私号:X表示虚拟号码,A为业务受益用户。A用户对外呈现的号码用X替代,所有与A用户建立的通讯都是通过X号码建立。AX场景下X号码只能被A号码独享,即不同A号码对应不同的X号码。

  • AXE分机号:A为业务受益用户,为了保护A的真实号码不被泄露,隐私保护通话平台为A绑定一个分机主号码X和一个分机号E。所有与A用户建立的通信都是通过X号码及分机号E建立。A用户拨打X号码可回呼之前通话用户或企业指定号码。AXE模式下X号码和多个号码绑定,分机号E不能重复。

产品优势

  • 稳定性好,响铃率高:基于运营商网络,语音质量好,接通率高,业务体验和用户直接打电话没有区别。

  • 行业标杆,应用广泛:行业内较早推出号码隐私保护产品,被广泛应用于海翕生态及出行、短租、金融、物流等行业。

  • 接入便捷,功能全面:有PaaS和SaaS两种接入方式,对于中小企业通过SaaS化方式接入减少了大量开发工作量 ,免去维护成本。

  • 按量付费,价格透明:根据客户的业务使用量进行计费,阶梯定价,自动跳档。

业务场景示例

最近更新时间:2018-06-08 10:16:35
模式 简介 业务场景
AXB中间号 AXB模式下的隐私保护号码主要在一对一场景下使双方隐私都得到保护,既能保持双方正常通话,又隐藏了通话双方的真实号码。 网约打车、短租、外卖派送、线上医生问诊、法律咨询等。
AXN隐私号 AX模式下的隐私保护号码主要在一对N场景下对单方号码进行隐私保护,A对外的号码都以X替代,所有与A的通话都通过X建立,保护A号码不泄露。 房产中介、咨询行业、快递服务、二手交易等。
AXE分机号 在AXN的基础上增加了分机号的概念,A对外的号码都以隐私号X+分机号替代,保护A号码不泄露,提高号码利用率,降低号码成本。 快递服务、外卖、电商等。

服务开通

最近更新时间:2018-06-08 10:16:35

隐私号码服务开通

  • 隐私保护是一款将基础运营商通信能力、号码资源创新应用的互联网产品,为用户提供隐私保护服务,企业直接 将隐私保护服务能力嵌入到自己的业务流程中,为用户提供隐私保护及点对点的安全通信服务。

  • 隐私保护产品包括AXN隐私号、AXB中间号这二种应用:

步骤

  • 1.进入隐私号码服务网页,点击免费开通

  • 2.根据提示及引导完成海翕云企业实名认证

  • 3.完成企业实名认证进入概览页,把账户内的余额划入小号余额,此后在隐私号码服务产生的所有消费均从小号余额扣除

  • 4.进入隐私号码服务控制台购买号码

  • 5.购买号码成功后跳到号码申请记录

号码绑定

最近更新时间:2018-06-08 10:16:35

号码管理页面可以查看已经购买号码的状态,并对号码进行绑定、释放等操作。

步骤

  • 1.进入隐私号码服务控制台—-号码管理页面

  • 2.点击绑定出现绑定弹框(这里以AXB为例,AXN类似),根据提示对号码进行绑定,即可体验产品功能

  • 3.点击退订出现退订弹框,退订后号码将不能继续使用,如果该X号码有绑定关系不允许退订。

号码使用统计

最近更新时间:2018-06-08 10:16:35
  • 1.进入隐私号码服务控制台—-统计页面

  • 2.点击分类统计查看通话的总体趋势

  • 3.点击呼叫记录查询页面即可根据隐私号码、A、B号码等信息查询具体某一个通话记录

隐私号码服务 API 概述

最近更新时间:2018-09-27 14:01:35

隐私号码服务相关接口

API 功能描述
AXN模式绑定 用于AXN模式下绑定
AXN模式解绑 用于AXN模式下解绑
AXN模式号码指定 用于AXN模式下指定号码
AXB模式绑定操作 用于AXB模式下绑定
AXB模式解绑操作 用于AXB模式下解绑
AXB模式转绑操作 用于AXB模式下转绑
AXE模式绑定操作 用于AXE模式下绑定
AXE模式解绑操作 用于AXE模式下解绑
查询号码状态 用于查询号码当前状态
查询号码的呼叫详情 用于查询号码呼叫详情
号码申请接口 用于号码申请
查询全部号码接口 用于查询全部号码
号码退订接口 用于号码退订
录音文件下载 用于录音文件下载

公共请求头部

最近更新时间:2018-09-27 14:01:35

描述:本文档将为您介绍在使用 API 时会使用到的公共请求头部,下文提到的头部在之后的具体 API 文档中不再赘述。

统一请求头字段

字段名称 字段值
Host pnumber.eiisys.com/pnapp

接入认证

隐私号码服务业务提供的 API 均采用“App key 认证”方式。 此种认证方式下,小号业务校验请求消息头中“AppKey +AppSecret”进行鉴权。鉴权通 过后,小号业务平台处理该请求消息。(AppKey 和 AppSecret可以再隐私号码服务平台申请)

AXN模式绑定

最近更新时间:2018-09-27 14:01:35
接口描述

功能: AXN模式绑定

接口地址:https://Host/v1/pn/ax/bind

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
app_key 必选 String 32 平台申请的AppKey
app_secret 必选 String 32 平台申请的AppSecret
virtual_number 必选 String 36 虚拟号码 示例:8613800000001
a_party 必选 String 21 号码A 示例:8613800000001
called_num_display 可选 String 2 来显号码 0虚拟号码 1真实号码 如果不携带该参数,或者参数值为空则表示默认1,显示真实号码。
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息,当绑定失败时,该字段返回为"error",成功时返回如下
message String 512 返回码的描述
code String 7 返回码
res_data主体
参数名 类型 长度 备注
subscriptionId String 36 本次绑定关系绑定id

返回码:返回码页

示例
返回成功:
{"code":"000000","res_data"{"subscriptionI":"b153aa4f-237a-4dcf-bd30-724e423a113d"},"message":"操作成功"}
返回失败:
{"code":"100002","res_data":"error","message":"该号码不属于当前AppKey"}

使用方法:demo下载

AXN模式解绑

最近更新时间:2018-09-27 14:01:35
接口描述

功能: AXN模式解绑

接口地址:https://Host/v1/pn/ax/unbind

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
app_key 必选 String 32 平台申请的AppKey
app_secret 必选 String 32 平台申请的AppSecret
virtual_number 必选 String 36 虚拟号码 示例:8613800000001
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息,当解绑失败时,该字段返回为"error",成功时返回为"ok"
message String 512 返回码的描述
code String 7 返回码

返回码:返回码页

示例
返回成功:
{"code":"000000","res_data":"ok","message":"操作成功"}
返回失败:
{"code":"100002","res_data":"error","message":"该号码不属于当前AppKey"}

使用方法:demo下载

AXN号码指定

最近更新时间:2018-09-27 14:01:35
接口描述

功能:号码指定

接口地址:https://Host/v1/pn/ax/block/number/assign

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
app_key 必选 String 32 平台申请的AppKey
app_secret 必选 String 32 平台申请的AppSecret
virtual_number 必选 String 36 虚拟号码 示例:8613800000001
block_number 必选 String 21 真实手机号 示例:8613800000001
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息,当指定失败时,该字段返回为"error",成功时返回为"ok"
message String 512 返回码的描述
code String 7 返回码

返回码:返回码页

示例
返回成功:
{"code":"000000","res_data":"ok","message":"操作成功"}
返回失败:
{"code":"400028","res_data":"error","message":"指定失败"}

使用方法:demo下载

AXB模式绑定

最近更新时间:2018-09-27 14:01:35
接口描述

功能:AXB模式绑定

接口地址:https://Host/v1/pn/axb/bind

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
app_key 必选 String 32 平台申请的AppKey
app_secret 必选 String 32 平台申请的AppSecret
virtual_number 必选 String 36 虚拟号码
a_party 必选 String 21 A方真实手机号或者固定电话 示例:手机号码:8613800000001
b_party 必选 String 21 B方真实手机号或者固定电话 示例:手机号码:8613800000001
bind_direction 可选 String 2 呼叫方向。取值:0:aParty 和 bParty 可以相互呼叫; 1:只能 aParty 呼叫 bParty;2:只能 bParty 呼叫 aPart 不带该参数 默认为0
end_time 可选 String 20 该绑定关系结束日期 格式:"2018-08-26 12:22:22" 如果携带本字段,则到期后小号平台自动解绑。
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息,当绑定失败时,该字段返回为"error",成功返回时如下表
message String 512 返回码的描述
code String 7 返回码

返回码:返回码页

示例
返回成功:
{"code":"000000","res_data":{"subscriptionI":"b153aa4f-237a-4dcf-bd30-724e423a113d"},"message":"操作成功"}
返回失败:
{"code":"100002","res_data":"error","message":"该号码不属于当前AppKey"}

使用方法:demo下载

AXB模式解绑

最近更新时间:2018-09-27 14:01:35
接口描述

功能:AXB模式解绑

接口地址:https://Host/v1/pn/axb/unbind

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
app_key 必选 String 32 平台申请的AppKey
app_secret 必选 String 32 平台申请的AppSecret
subscription_id 必选 String 36 绑定关系唯一标识示例:“27fa3484-4d5e-4020-81c5-da6c1e56a82f”
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息,当解绑失败时,该字段返回为"error",成功时返回为"ok"
message String 512 返回码的描述
code String 7 返回码

返回码:返回码页

示例
返回成功:
{"code":"000000","res_data":"ok","message":"操作成功"}
返回失败:
{"code":"400025","res_data":"error","message":"开启失败"}

使用方法:demo下载

AXB模式转绑

最近更新时间:2018-09-27 14:01:35
接口描述

功能:AXB模式转绑

接口地址:https://Host/v1/pn/axb/modify

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
app_key 必选 String 32 平台申请的AppKey
app_secret 必选 String 32 平台申请的AppSecret
subscription_id 必选 String 36 绑定关系唯一标识示例:“27fa3484-4d5e-4020-81c5-da6c1e56a82f”
a_party_new 选填 String 21 A方新号码 注意:A方新号码不能是原始绑定号码
b_party_new 选填 String 21 B方新号码 注意:B方新号码不能是原始绑定号码
call_direction_new 选填 String 2 呼叫方向  0:A和B可以相互呼叫
      1:只允许A呼叫B
      2:只允许B呼叫A
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息,当转绑失败时,该字段返回为"error",成功时返回为"ok"
message String 512 返回码的描述
code String 7 返回码

返回码:返回码页

示例
返回成功:
{"code":"000000","res_data":"ok","message":"操作成功"}
返回失败:
{"code":"400013","res_data":"error","message":"转绑失败"}

使用方法:demo下载

AXE模式绑定

最近更新时间:2019-06-5 14:01:35
接口描述

功能:AXE模式绑定

接口地址:https://Host/v1/pn/axe/bind

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
appKey 必选 String 32 平台申请的AppKey
appSecret 必选 String 32 平台申请的AppSecret
virtualNum 必选 String 32 虚拟号码 示例:8613800000001
bindNum 必选 String 32 真实号码 示例:8613800000002
displayNumMode 可选 String 11 来显号码。0为虚拟号码;1为真实号码。 如果不携带该参数,或者参数值为空 则表示默认 1,显示真实号码。
endTime 可选 String 20 该绑定关系有效时间。 格式为时间戳(毫秒)。如果携带本字段,则到期后号码绑定关系自动解绑。最大为30天。不携带该参数或者携带参数为0,系统默认永不过期。
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息,当绑定失败时,该字段返回为"error",成功返回时如下表
message String 512 返回码的描述
code String 7 返回码

返回码:返回码页

示例
返回成功:
{"res_data":{"extendNumber":"0003","subscriptionId":"3549e484-4d9f-4c2d-958e-ba9a6647c417"},"message":"绑定成功"}
返回失败:
{"code":"400001","res_data":"error","message":"该号码不属于当前AppKey"}

使用方法:demo下载

AXE模式解绑

最近更新时间:2019-06-06 14:01:35
接口描述

功能:AXE模式解绑

接口地址:https://Host/v1/pn/axe/unbind

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
appKey 必选 String 32 平台申请的AppKey
appSecret 必选 String 32 平台申请的AppSecret
virtualNum 必选 String 32 虚拟号码 示例:8613800000001
extendNumber 必选 String 10 分机号码 示例:0002
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息,当解绑失败时,该字段返回为"error",成功时返回为"ok"
message String 512 返回码的描述
code String 7 返回码

返回码:返回码页

返回成功:
{"code":"000000","res_data":"ok","message":"操作成功"}
返回失败:
{"code":"400001","res_data":"error","message":"该号码不属于当前AppKey"}

使用方法:demo下载

查询号码状态

最近更新时间:2019-08-12 14:01:35
接口描述

功能:查询号码状态

接口地址:https://Host/v1/pn/ax/number/voice/notify

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
app_key 必选 String 32 平台申请的AppKey
app_secret 必选 String 32 平台申请的AppSecret
virtual_number 可选 String 36 虚拟号码 示例:8613800000001
extend_number 可选 String 10 分机号码E(AXE模式使用)
a_party 可选 String 36 绑定时的真实号码
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息,当查询失败时,该字段返回为"error",成功返回如下表:
message String 512 返回码的描述
code String 7 返回码
res_data主体
参数名 类型 长度 备注
subscriptionId String 36 本次绑定关系绑定id
bind_status String 2 绑定关系 1.已绑定 0.未绑定
virtual_number String 36 虚拟号码 示例:8613800000001
a_party String 21 A方绑定号码 示例:8613800000001
b_party String 21 B方绑定号码 (AXB才有) 示例:8613800000001
extend_number String 10 分机号码E (AXE才有)
end_time String 20 绑定失效时间 (AXB、AXE才有) 格式"2018-08-08 18:18:18" ;为空或为0时,绑定关系永久有效
is_record String 2 是否录音 目前都为录音 1.录音 0.不录音
number_type String 10 号码类型 1.AXB 2.AXN 4.AXE
bind_direction String 2 呼叫方向 0:互相呼叫 1.A呼叫B 2.B呼叫A
bind_time String 20 绑定时间 格式"2018-08-08 18:18:18"
power_status String 2 开关状态 1:开 2:关 (AXN才有)
called_num_display String 2 号码来显 0:虚拟号码 1.真实号码(AXN、AXE才有)

返回码:返回码页

示例
返回成功:
{ "code": "000000", "res_data": [ { "subscription_id": "2351ef2f-a2fb-40f7-b491-9e2cc821e08b", "bind_status": "1", "power_status": "1", "virtual_number": "8617091650940", "a_party": "8618438655301", "is_record": "1", "number_type": "2", "called_num_display": "1", "bind_time": "2019-08-09 17:16:48" } ], "message": "操作成功" }
返回失败:
{"code":"400001","res_data":"error","message":"无效的AppKey"}

使用方法:demo下载

查询号码的呼叫记录详情

最近更新时间:2018-09-27 14:01:35
接口描述

功能:查询号码的呼叫记录详情

接口地址:https://Host/v1/pn/ax/number/voice/notify

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
app_key 必选 String 32 平台申请的AppKey
app_secret 必选 String 32 平台申请的AppSecret
virtual_number 必选 String 36 虚拟号码 示例:8613800000001
search_date 必选 String 20 查询日期或月份(2018-07,2018-07-31)
calling 可选 String 21 呼主叫号码 示例:8613800000001
called 可选 String 21 被叫号码 示例:8613800000001
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息,当绑定失败时,该字段返回为"error",成功返回为ArrayList每条数据如下表:
message String 512 返回码的描述
code String 7 返回码
res_data主体为ArrayList每条数据如下
参数名 类型 长度 备注
bind_mode String 2 绑定模式
call_identifier String 64 呼叫唯一标识
calling String 21 主叫号码
called String 21 被叫号码
virtual_number String 36 虚拟号码
timestamp String 32 呼叫事件发生的时间戳 UTC 时间。格式:YYYY-MM-DD'T'hh:mm:ss:SSS'Z' SSS 表示毫秒,注意固定字符“T”、“Z”
is_record String 2 是否录音 目前都为录音 1.录音
duration String 32 通话时长,单位秒

返回码:返回码页

示例
返回成功:
{"code":"000000","res_data":[{"duration":"3","called":"8618768126208","virtual_number":"8617091650940","calling":"8615638171230","bind_mode":"2","call_identifier":"65775282717426729611531450141973","is_record":"1","timestamp":"2018-09-11T02:49:15.940Z"},{"duration":"3","called":"8618768126208","virtual_number":"8617091650940","calling":"8615638171230","bind_mode":"2","call_identifier":"65775282717426729611531450141973","is_record":"1","timestamp":"2018-09-11T02:49:15.940Z"},{"duration":"3","called":"8618768126208","virtual_number":"8617091650940","calling":"8615638171230","bind_mode":"2","call_identifier":"65775282717426729611531450141973","is_record":"1","timestamp":"2018-09-11T02:49:15.940Z"},{"duration":"3","called":"8618768126208","virtual_number":"8617091650940","calling":"8615638171230","bind_mode":"2","call_identifier":"65775282717426729611531450141973","is_record":"1","timestamp":"2018-09-11T02:49:15.940Z"},{"duration":"3","called":"8618768126208","virtual_number":"8617091650940","calling":"8615638171230","bind_mode":"2","call_identifier":"65775282717426729611531450141973","is_record":"1","timestamp":"2018-09-11T02:49:15.940Z"}],"message":"操作成功"}
返回失败:
{"code":"400001","res_data":"error","message":"无效的AppKey"}

使用方法:demo下载

号码购买申请

最近更新时间:2018-09-27 14:01:35
接口描述

功能:号码购买申请

接口地址:https://Host/v1/pn/ax/number/buy/apply

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
app_key 必选 String 32 平台申请的AppKey
app_secret 必选 String 32 平台申请的AppSecret
bind_mode 必选 String 2 绑定模式 1.AXB 2.AXN
city_location 必选 String 10 归属地
apply_count 必选 String 10 申请个数
voice_description 必选 String 255 通话场景描述
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息,当申请失败时,该字段返回为"error",成功返回"ok"
message String 512 返回码的描述
code String 7 返回码

返回码:返回码页

示例
返回成功:
{"code":"000000","res_data":"ok","message":"操作成功"}
返回失败:
{"code":"400001","res_data":"error","message":"无效的AppKey"}

使用方法:demo下载

查询全部号码

最近更新时间:2019-07-26 14:01:35
接口描述

功能:查询所拥有的的全部未退订号码

接口地址:https://Host/v1/pn/number/query/all

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
app_key 必选 String 32 平台申请的AppKey
app_secret 必选 String 32 平台申请的AppSecret
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息,结果是存放号码的list集合
message String 512 返回码的描述
code String 7 返回码
res_data主体
参数名 备注
virtualNumber 虚拟号码,如 “8617078860000”
cityLocation 所属城市,如 “杭州”
buyTime 号码审核通过时间,如“2019-07-22 17:36:00”
bindMode 号码模式。 “1”为AXB模式,“2”为AXN模式,“4”为AXE模式
bindStatus 绑定关系。 “0” 为未绑定 ,“1” 为已绑定
aParty 绑定的A号码

返回码:返回码页

示例
返回成功:
{ "code": "000000", "res_data": [ { "buyTime": "2019-07-22 17:36:00", "cityLocation": "杭州", "virtualNumber": "8617091650940", "bindMode": "2", "bindStatus": "0", "aParty": "" }, { "buyTime": "2019-07-22 10:00:30", "cityLocation": "杭州", "virtualNumber": "8617078865642", "bindMode": "1", "bindStatus": "1", "aParty": "8615611223344" } ], "message": "操作成功" }
返回失败:
{"code":"400001","res_data":"error","message":"无效的AppKey"}

使用方法:demo下载

号码退订

最近更新时间:2018-09-27 14:01:35
接口描述

功能:号码退订

接口地址:https://Host/v1/pn/ax/number/unsubscribe

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
app_key 必选 String 32 平台申请的AppKey
app_secret 必选 String 32 平台申请的AppSecret
virtual_number 必选 String 36 虚拟号码 示例:8613800000001
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息,当退订失败时,该字段返回为"error",成功返回"ok"
message String 512 返回码的描述
code String 7 返回码

返回码:返回码页

示例
返回成功:
{"code":"000000","res_data":"ok","message":"操作成功"}
返回失败:
{"code":"400001","res_data":"error","message":"无效的AppKey"}

使用方法:demo下载

录音文件下载

最近更新时间:2018-09-27 14:01:35
接口描述

功能:录音文件下载

接口地址:https://Host/v1/pn/ax/number/voice/file/download

请求方式:POST

参数说明
参数名 要求 类型 长度 备注
app_key 必选 String 32 平台申请的AppKey
app_secret 必选 String 32 平台申请的AppSecret
call_identifier 必选 String 255 呼叫唯一标识
record_time 必选 String 32 呼叫日期 格式:2019-01-18
返回结果
参数名 类型 长度 备注
res_data - - 返回的主体信息
message String 512 返回码的描述
code String 7 返回码
res_data参数说明
参数名 说明
downloadURL 录音文件下载URL
saveFileName 录音开始时间

返回码:返回码页

示例
返回成功:
{ "code": "000000", "res_data": { "downloadURL": "https://1.189.75.75/sp-7xo74kte6y56y0lyro70ysof2d8y/19082601242412038860534.wav?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20190828T073338Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Credential=D6CA0F74A18EC5D1D1F2%2F20190828%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=a2a7f446a81a8d0e6ab1f652d18ce7b417333f9ab1877a2f316c1441e93febd2", "saveFileName": "20190826092424" }, "message": "操作成功" }
返回失败:
{"code":"400001","res_data":"error","message":"无效的AppKey"}

使用方法:demo下载

返回码页

最近更新时间:2018-09-27 14:01:35

调用API接口会产生返回码,常见返回码请参考以下列表:

返回码 返回码描述
000000 操作成功
100001 无效的AppKey
100002 AppSecret错误
400001 该号码不属于当前AppKey
400002 虚拟号码已达到绑定上限
400003 虚拟号码暂停使用
400004 绑定失败
400005 失效时间无效
400006 虚拟号码不可用
400007 无可用的虚拟号码
400008 该号码绑定关系已经存在
400009 绑定关系不符合要求
400010 码号暂停使用
400011 码号不可用
400012 解绑失败
400013 转绑失败
400014 该号码不属于AXB模式
400015 该号码不属于AXN模式
400016 号码退订操作需要先解绑
400017 虚拟号码不能为空
400018 查找日期不能为空
400019 时间格式错误
400020 只有主账号具有购买权限
400021 申请失败
400022 退订失败
400023 查询失败
400024 下载失败
400025 开启失败
400026 关闭失败
400027 参数格式错误
400028 指定失败
400029 录音记录不存在
400030 PasswordDigest校验失败
400031 时间超出限制
400032 非法请求,请检查参数格式
400033 无效的app_key
400034 平台达到系统流控制上线,请稍等一分钟
400035 A和X之间已经存在绑定关系
400036 X号码不存在
400037 号码资源不足
400038 超过允许申请的资源上限,一个A最多绑定5个号码
400039 应用未开启录音功能
400040 X号码已经和其他号码绑定
400041 该号码绑定关系不存在
400042 商户无此号码
400043 系统错误,请联系客服处理
400044 资源未申请,X号码未和app_key绑定
400045 指定的X号码不存在,请检查relationNum参数的填写是否正确
400046 资源不足,没有可分配的X号码,请释放部分绑定关系或申请新的X号码
400047 指定的X号码的绑定数量已达到上限。一个X最多同时绑定1000对关系
400048 绑定关系已存在
400049 分机号码不能为空
400050 分机号码不存在

隐私号码服务使用声明

最近更新时间:2019-05-06 10:20:35

您了解并同意,您使用海翕云提供的隐私号码服务即表明您完全理解并同意受本服务声明全部内容的约束。

一、您使用隐私号码服务应严格遵守国家相关法律、法规的规定,法律法规对此有特殊要求的,您承诺在使用隐私号码服务期限内满足该特殊要求,包括但不限于您使用海翕云隐私号码服务应取得相应的资质、许可、授权等。

二、根据《电话“黑卡”治理专项行动工作方案》要求,海翕云为您提供语音服务的号码需完成电话用户实名登记方可提供服务,您应按照海翕云要求提供相应材料,您亦同意海翕云将您实名登记材料提供给运营商备案。您承诺在申请使用隐私保护通话服务时提交的资料和信息真实、准确、完整,并符合相关法律要求,该等资料和信息发生变化的,您应及时书面通知海翕云。

三、您使用隐私号码服务应遵守骚扰电话管理的相关规定,仅向内部员工或注册用户拨打电话,并且上述用户自愿接听外呼电话。不得向未同意接听电话的用户进行呼叫,也不得向用户传播与其业务无关的信息。

四、除符合适用法律的基本规定之外,您利用本服务向用户提供应用或服务时,未经用户同意不得擅自收集用户数据,不得违反法律或约定超出范围使用用户数据,应向用户提供隐私保护政策。用户数据包含但不限于通话、短信内容。

五、您使用隐私号码服务期间,不得发布和传播含有法律法规禁止的内容的信息,或从事法律法规禁止的活动。

六、您使用隐私号码服务开展的业务仅限于事先向海翕云申请并经过海翕云认可的业务,未经海翕云同意,不得将隐私号码服务及相应的资源提供给第三方使用。任何情况下,海翕云均不向您的最终用户或任何第三方承担责任。

七、为降低运营风险,海翕云不承接如下业务,合作伙伴也不得基于海翕云提供的资源开展相关业务:

  • 1、

    限制行业:贷款、高利贷、催收催缴、贵金属交易(纸黄金等)、股票软件或股票推荐、期货、金融保险、互联网金融、医药销售、零售推销、新房营销、POS机销售、出国留学、教育推销、教育回访、呼叫中心的外呼业务、坐席盲呼业务、机器人外呼代开发票、代做账、面向个人用户的网络电话业务、号称政企业务的客服、知识产权代理、运营商业务等;

  • 2、

    引导、指导用户完成账户操作,如银行卡操作、网银操作、支付宝操作、微信操作以及其他金融相关账号操作等;

  • 3、

    骚扰用户:包括在用户表现出反感或要求不再拨打后再次呼叫,报复性拨打被叫,谩骂、侮辱被叫,休息时段呼叫用户(午休、夜间、凌晨等); 

  • 4、

    其他影响运营商、海翕云的利益或名誉的、或容易引发用户投诉的业务。

八、基于运营商的管理要求和安全管控目的,要求您的号码日投诉率低于0.3%,月投诉率低于0.5%,如投诉率超 标,海翕有权关停您的业务。

九、您使用隐私号码服务应遵守信息与网络安全相关的要求,包括但不限于:

  • 1、

    在联网测试、试运行期间、业务正式开通以及合作业务推广期间,遵守运营商的相关管理规定,不得危害对 通信网络及相关业务平台的正常运行;

  • 2、

    您应妥善保管用户账号、密码、APPKEY等关键信息,第三方基于关键信息进行的操作(包括不限于修改关 键信息、开展业务等)视同您的行为。

十、为保证资源合规使用,海翕云隐私号码服务提供录音能力和通话前放音能力和短信内容推送能力:

  • 1、

    录音可用于且仅可用于对通话过程中服务质量监控,同时为确保最终被录音通话双方有知情权。您需要采取 包含但不限于通话前放音、网站或app提醒用户“为了保证服务质量,您的通话过程会被录音”等提示性语句等 方式确保通知到通话双方;

  • 2、

    您有义务在法律规定范围内对发送的录音文件或文本做安全审核。文件或文本内容不得包含违反国家法律法 规、反党反政府反社会主义、色情、损坏安定团结社会的内容。由于您审核责任造成以上内容被播放所产生 的法律责任全部由您负责。

十一、因您违反上述约定导致的任何责任或损失,由您自行承担,因此给海翕云造成损失的,您应赔偿海翕云,且海翕云有权采取如下措施中的一个或多个:

  • 1、

    提出警告,并要求合作伙伴遵守,或要求合作伙伴整改;

  • 2、

    减少提供的资源数量或服务;

  • 3、

    未经事先通知的情况下,暂停提供全部或部分服务或资源;

  • 4、

    未经事先通知的情况下,永久关停全部或部分服务或资源;

  • 5、

    配合有关部门追究责任单位的法律责任;

  • 6、

    终止与责任单位的合作。

十二、隐私号码服务可能存在资源或通道不稳定、暂停或关闭等情形,您同意并认可对于以下场景下隐私号码服务资源或通道的不稳定、暂停或关闭等,海翕云不承担任何责任:

  • 1、

    因停电、计费系统故障、传输线路故障、通信故障及通信线路故障、检修升级、计算机错误或病毒、黑客攻 击、信息损坏、数据丢失、政府管制或其它在海翕云合理控制范围之外的原因所造成的不稳定、暂停或关闭等;

  • 2、

    海翕云有权定期或不定期地对提供网络服务的网站或相关的设备进行检修或者维护,如因此类情况而造成网 络服务在合理时间内的中断或暂停等,海翕云无需为此承担任何责任;

  • 3、

    运营商基础网络不稳定或突发情况造成资源的稳定性受影响,或造成资源的暂停、关闭;

  • 4、

    提供基础服务的运营商暂停或终止与华为合作。

十三、为适应政策和业务的需要,海翕云将在必要时对业务开展要求的内容进行调整并发布于隐私号码服务使用声明中,请您及时参阅最新要求,并遵从最新要求开展业务。

十四、本协议项下的服务均基于运营商能力和资源提供,由于通信能力、系统、网络和资源的不稳定,海翕云无法保证服务毫无瑕疵,但承诺致力于不断提升服务质量及服务水平。

十五、海翕云负责对本声明进行解释,并有权随时更新本服务声明。更新的声明在海翕云网站上发布,并在发布时立即生效。

常见问题

最近更新时间:2019-08-02 10:16:35

是否限制隐私号码绑定数量?

  • AX模式:1个X号码只能同时绑定1个A号码,1个A号码可以同时绑定5个X号码。
  • AXB模式:1个X号码允许绑定1000对用户号码,但用户号码不可重复。例如,允许同时绑定AXB和CXD,但不允许同时绑定AXB和BXC。
  • AXE模式:1个X号码可以绑定多个A号码,每个A号码分配不同的分机号E;分机号E最大4位(即0001~9999),但建议一个X号码不要绑定超过200个A号码。

隐私保护通话号码显示规则?

  • AX模式:
    A通过X呼叫B时,B用户终端显示X;
    B呼叫X,A用户终端显示B或X(号码绑定时选择:“真实号码”或“虚拟号码”)。
  • AXB模式: A或B通过X号码呼叫对方,对方的终端都显示X。
  • B呼叫X,输入分机号E转接到A,A用户终端显示X或者B(号码绑定时选择:“真实号码”或“虚拟号码”)。
    A通过X回呼B,B用户终端显示X。

录音文件可以保存多久?

录音文件保存3天。3天后下载按钮消失。

绑定关系中的A和B可以是什么号码?

隐私保护通话只支持绑定真实手机号和固定电话,不支持绑定虚拟号码、400号码和95号码。 因此,目前无法通过PC端IP电话软件、400号码和95号码使用隐私号码外呼。 但PC端、400号码、95号码可以是隐私保护通话中未绑定X号码的用户,例如AX模式中,真实手机号A绑定了隐私号码X,从PC端呼叫X,呼叫可以被转接至A。