隐私号
挪车码隐私号

【API接口】隐私号对接文档(WEBCALL)

2026-04-01 17:41:42

请求示例:

{AppSecret}:签约后技术人员会提供

{url}:yinsihao.1oc.cn

{returnurl} 需要URL编码,通话记录结果会POST至此URL。

{mobphone} 手机号(被叫)(必填)

{bmobphone} 用户手机号(主叫)(必填)

{bindtime} 绑定有效期,单位分钟(最大不超过2)(选填)

CURL

curl -i -k --post --include 'http://{url}/?module=yinsihao&file=apibind&action=getprivacynumber&mobphone={mobphone}&bmobphone={bmobphone}&bindtime={bindtime}&returnurl={returnurl}'  -H 'Authorization:{AppSecret}'

PHP

   $host="http://{url}";
   $path="/";
   $method="POST";
   $appsecret="{AppSecret}";
   $headers=array();
   array_push($headers,"Authorization:".$appsecret);
   array_push($headers,"Content-Length: 0");
   $querys="module=yinsihao&file=apibind&action=getprivacynumber&mobphone={mobphone}&bmobphone={bmobphone}&bindtime={bindtime}&returnurl={returnurl}";
   $bodys="";
   $url=$host.$path."?".$querys;
   $curl=curl_init();
   curl_setopt($curl, CURLOPT_CUSTOMREQUEST,$method);
   curl_setopt($curl, CURLOPT_URL,$url);
   curl_setopt($curl, CURLOPT_HTTPHEADER,$headers);
   curl_setopt($curl, CURLOPT_FAILONERROR,false);
   curl_setopt($curl, CURLOPT_RETURNTRANSFER,true);
   curl_setopt($curl, CURLOPT_HEADER,true);
   if(1==strpos("$".$host,"https://"))
    {
       curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,false);
       curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,false);
    }
   var_dump(curl_exec($curl));

JAVA

public static void main(String[] args) {
        String host = "http://{url}";
        String path = "/";
        String method = "GET";
        String appsecret = "{AppSecret}";
        Mapheaders = new HashMap();
        headers.put("Authorization",appsecret);
        Mapquerys = new HashMap();
        querys.put("module", "yinsihao");
        querys.put("file", "apibind");
        querys.put("action", "getprivacynumber");
        querys.put("mobphone", "{mobphone}");
        querys.put("bmobphone", "{bmobphone}");
        querys.put("bindtime", "{bindtime}");
        querys.put("returnurl", "{returnurl}");//通话记录回调地址
        try {
            /**
            * 重要提示如下:
            * HttpUtils请从
            * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
            * 下载
            *
            * 相应的依赖请参照
            * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
            */
            HttpResponse response = HttpUtils.doGet(host, path, method, headers, querys);
            System.out.println(response.toString());
            //获取response的body
            //System.out.println(EntityUtils.toString(response.getEntity()));
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

Python

import urllib, urllib2, sys
import ssl
host = 'http://{url}'
path = '/'
method = 'POST'
appsecret = "{AppSecret}";
querys = 'module=yinsihao&file=apibind&action=getprivacynumber&mobphone={mobphone}&bmobphone={bmobphone}&bindtime={bindtime}&returnurl={returnurl}'
bodys = {}
url = host + path + '?' + querys
request = urllib2.Request(url)
request.add_header('Authorization',appsecret)
ctx = ssl.create_default_context()
ctx.check_hostname = False
ctx.verify_mode = ssl.CERT_NONE
response = urllib2.urlopen(request, context=ctx)
content = response.read()
if (content):
print(content)

失败响应

{
    "code": 400, //指返回结果码,并非http状态码
    "msg": "域名校验失败",
}

成功响应

{
    "code": 200,
    "msg": "ok",
    "data": {
        "xmobphone": "",
        "webCallUrl": "https://yinsihao.1oc.cn/?module=yinsihao&file=webcall&calltoken=XXXXXX",//这是H5地址,可以在浏览器打开,也可以在微信公众号、小程序或者APP中打开
        "sbid": "17223184122084",//唯一id号
        "starttime": 1722318412,//号码绑定开始时间
        "endtime": 1722318532,//号码绑定结束时间
    }
}

通话记录POST至returnurl地址,数据如下:

{
   'sbid'=> ''
    'sb_id'=> ''//同一记录,sb_id是一样的
    'xmobphone' => ''//隐私号
    'bmobphone' => ''//主叫号码
    'mobphone' => ''//被叫号码
    'thsc' => ''//通话时长(秒)
    'mid' => ''//唯一ID
    'startime' => ''//X号码绑定时间(时间戳)
    'endtime' => ''//X号码有效期结束时间(时间戳)
    'call_starttime' => ''//呼叫开始时间(时间戳)
    'call_endtime' => ''//呼叫结束时间(时间戳)
    'status' => ''//通话状态(具体查看状态码)
    'recordurl' => ''//录音地址
    'bj_province' => ''//被叫号码所在省份
    'bj_city' => ''//被叫号码所在城市
    'bj_sp' => ''//被叫号码所在运营商
    'zj_province' => ''//主叫号码所在省份
    'zj_city' => ''//主叫号码所在城市
    'zj_sp' => ''//主叫号码所在运营商
    'op_answer_time' => ''//被叫接听时间(时间戳)
}

客户端收到结果后返回:

success
返回 隐私号 首页 分享到微信 看看我们今天更新了什么?
相关文档
31 2025-12

【API接口】查询隐私号录音转文字接口

请求示例:{AppSecret}:签约后技术人员会提供{url}:yinsihao.1oc.cn{sbid}:通话记录中有sbid的值CURLcurl-i-k--get--include'ht

18 2025-09

隐私号业务扩容,再新增一条AXE线路

随着各大平台提高了隐私号的准入门槛,很多平台已经强制需要对隐私号的主叫用户进行实名认证,很多客户转头找到我们公司,目前我公司提供的隐私号线路没有这些规定,主叫用户不需要实名认证。随着客户的增加,我公司

14 2025-06

工信部:从严整治中间号,短信端口等涉诈问题

据工信微报,6月13日,工业和信息化部召开信息通信行业防范治理电信网络诈骗工作推进会。会议强调,全行业要突出问题导向、目标导向、结果导向,强化系统思维,坚持综合施策,加大力度纵深推进行业反诈源头治理和

01 2025-05

关于隐私号/虚拟号AXE暂停每月返还分钟数的通知

原AX/AXB运营商是按照每月实际通话分钟数计费,所以我们也是按照此规则,每月按照实际通话分数阶梯退费。现在AXE没有这个要求,是按照预充值来计算的,充值越多越便宜,所以不需要每月退费,故我们暂时取消

随机文档
14 2026-04

AX/AXE主叫白名单功能上线,实现AXB一对一呼叫

AX/AXE主叫白名单功能上线,实现AXB一对一呼叫,用户在通过API接口绑定的时候,必须同时传入被叫和主叫两个手机号码。如果开启白名单,那么能够实现在有效期内,只有绑定的主叫可以拨打被叫号码。有效期

11 2026-04

隐私号接通后自动播放彩铃提示音功能上线

自定义彩铃可以实现,在被叫接通后播放提示音彩铃,比如:“您正在使用千指传媒隐私号服务”等等,这个提示音可以设置只给一方播放,也可以设置通话双方都播放彩铃提示音。

02 2026-04

053255664544投诉电话入口

本页面仅针对骚扰电话是:053255664544,其他号码投诉无效,您也可以点击页面右侧客服按钮进行投诉此号码。

02 2026-04

053255543189投诉电话入口

本页面仅针对骚扰电话是:053255543189,其他号码投诉无效,您也可以点击页面右侧客服按钮进行投诉此号码。