[关闭]
@keven-gao 2018-01-11T09:26:57.000000Z 字数 2514 阅读 596

中间号开发文档

中间号

中间号项目为公共调用项目,调用方式为各配合项目统一规则调用
本文档提供数据库设计及接口文档

需求分析
关系号 晓致平台提供的通讯号
绑定 将关系号和一个真实号码一对一关联的操作

提供A号码和B号码，由平台生成一个C的虚拟号码，当A（B）拨打C号码时，将转接至B（A）号码；除A（B）号码以外的号码拨打C号码，均提示无法接通。

eg：c号码即为关系虚号，A B号码则为真实号码

  1. 业务场景
  2.     两个司机的手机号绑定一个关系虚号，彼此都可以拨打该关系虚号转至另一个人，双方来电均为关系虚号
  4.     订单完成或业务结束后解除双方的绑定关系，双方也无法再拨打原来的关系虚号联系对方。

Database Doc

  1. 数据库设计
  3. virtualBind
  5. id 自增主键
  6. wantengId 其他项目针对这条绑定记录的唯一标识
  7. seqId 万腾平台针对中间号平台的唯一标识，用于异步消息通知
  8. timestamp 用户请求的北京时间 毫秒数
  9. fmPhone 来源号码
  10. tmPhone 呼转至的号码
  11. virtualMobile 虚拟号（中间号）
  12. status 1 已绑定 2 解除绑定 3 绑定失败
  13. scene 场景id 0 -255
  14. bindTime 0 长期绑定 
  15. startTime 开始时间
  16. endTime   结束时间
  19. callRecord 通话记录表
  21. id 自增主键
  22. seqId 万腾生成的标识
  23. timestamp 时间戳
  24. virtualMobile 虚拟号
  25. fmPhone 来电号码
  26. tmPhone 被叫号码
  27. dmPhone 保密号码
  28. callStart 开始时间  时间戳
  29. callAnswer 接听时间 时间戳
  30. callEnd 挂断时间 时间戳
  31. mid 密号平台通话标识（确保三个月内不重复）
  32. fmBlong fm号码的归属地
  33. tmBlong tm号码的归属地
  34. call 被叫号码
  35. status 状态 -1：实时来电通知（是否接听状态未知，非话单记录）
  36.     0：正常接听
  37.     1：未应答
  38.     2：黑名单来电，拒接
  39.     3：虚号关机状态，未接听
  40.     4：未绑定号码
  41.     5：遇忙未接听
  42. noAnswerReason 未接听原因
  43. ext 分机号
  44. sign 签名 生成规则
  46. created_at 创建时间
  47. updated_at 更新时间
  49. tapes 录音表
  50. id 自增主键表
  51. callRecordId 通话记录id 外键id
  52. tag 标签 用于读取媒体文件时的必须参数
  53. mid 密号平台通话标识
  54. readUrl 录音文件地址，调用录音读取接口时使用 
  55. getFileUrl 商户设置IP校验情况下，可使用getFileUrl读取文件
  56. fileId 文件id wanteng平台的文件id
  57. fileName 录音文件的名称
  58. created_at 创建时间
  59. updated_at 更新时间
  63. history_log
  65. id log主键id
  66. wantengId 万腾id  项目标识
  67. type 1 绑定 2 解除绑定 3 被动推送通话记录 4 被动推送录音记录
  68. result 1 成功 2 失败
  69. resultId 实体id
  70. virtualId 虚拟表的主键id  外键
  71. created_at 创建时间
  72. updated_at 更新时间

JSON Doc

  1. bindVirtualMobile 获取并绑定中间号  post
  3. 请求    
  4.   {
  5.     wantengId  1  //调用标识 必传参数
  6.     type 1 // 项目类型 必传参数
  7.     fmPhone 15710331665 //来源手机号 必传参数
  8.     tmPhone 15710333333 //呼转至的手机号 必传参数
  9.     bindTime 0 //默认填写为0，表示长期绑定  必传参数         当设置为X时（X大于0且小于14400），绑定时间X分钟，超过指定时间后将自动释放（X最长10天），设置其它均视为长期绑定
  10.     scene 0 //场景：允许使用0-255【创建关系时有效】
  12.   }
  14.  响应 
  15. {       
  16.     errorCode:0,
  17.     data:[
  18.         virtualMobile:18121111111, //虚拟号码
  19.         expire:0 //过期时间 0为长期绑定 其他则为s
  20.     ]
  22. }
  1. relieveBind 解除绑定
  3. 请求
  4.     {
  5.         wantengId:1
  6.     }
  7. 响应
  8.     {
  9.         errorCode:0,
  10.         data:"success"
  11.     }
  1. 推送通话记录接口
  2. {
  4. 请求
  6.     "wantengId":"G1234345",
  7.     "fmPhone":15710331665,
  8.     "toPhone":17692359259,
  9.     "callAnswer":"1515144443206", //接听时间时间戳
  10.     "callEnd":"1515144490327", //挂断时间 时间戳
  11.     "status":0, //状态 0 正常接听 1未应答 2黑名单 拒接3虚号关机状态未接听 4未绑定号码 5遇忙未接听
  12.     "noAnswerReason":"11" //详细见noAnswerReason
  14. }
  16. ##2. noAnswerReason参数
  17. 参数  说明
  18. 11  主叫挂机
  19. 12  被叫挂机
  20. 13  被叫正在通话中
  21. 14  被叫无人接听
  22. 15  被叫无法接通
  23. 16  被叫关机
  24. 17  被叫空号
  25. 18  被叫暂停服务
  26. 19  被叫转接失败
  1. 推送录音接口 
  1. 获取一绑定记录下的所有通话记录和录音信息
  3. getBindInfo
  4. request
  5. {
  6.     "wantengId":1
  7. }
  8. response
  9. {
  11. "count":2,
  13. "items":    [
  14.         {
  15.             "fmPhone":15710331665,
  16.             "tmPhone":15710331666,
  17.             "vmPhone":15710331111,
  18.             "callAnswer":"1541164946000", //时间戳 通话开始时间
  19.             "callEnd":"1541164947000",//时间戳 通话挂断时间
  20.             "callTime": 36s, //通话时长
  21.             "tapFileId":"ewffuwfu3r0u03r9u30tj3rt023"//录音fileId
  22.             "tapFileName":"20180112-mid.mp3" //录音文件名称
  23.         }，
  24.         {
  25.             "fmPhone":15710331665,
  26.             "tmPhone":15710331666,
  27.             "vmPhone":15710331111,
  28.             "callAnswer":"1541164946000", //时间戳 通话开始时间
  29.             "callEnd":"1541164947000",//时间戳 通话挂断时间
  30.             "callTime": 36s, //通话时长
  31.             "tapFileId":"ewffuwfu3r0u03r9u30tj3rt023"//录音fileId
  32.             "tapFileName":"20180112-mid.mp3" //录音文件名称
  33.         }
  34.     ]
  37. }
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注