电话控制¶
发起呼叫¶
-
POST/api/user/(string: telnum)/makecall¶ 手机号码为 telnum 的用户通知服务器，将要发起呼叫
Request JSON Object: - caller (string) – 作为主叫号码专号
- callee (string) – 被叫号码
Response JSON Object: - callid (string) – 呼叫ID
注解
调用用该API之后，服务器将记录 telnum 的呼叫请求。
在 2分钟 之内，服务器如果收到 telnum 向其专号 caller 的呼叫， 就会自动接通，然后以 caller 为主叫号码，向 callee 发起呼叫，并桥接两者之间的通话。
注意
对于同一个手机号码，服务器只保存其最近一次呼叫请求。 如果同一个手机号码连续调用该接口，服务器将以最后一次请求为准。
注意
如果没有调用该接口，或者调用后又取消(POST /api/user/(string: telnum)/cancelcall)，
服务器不会接受 telnum 对 caller 的电话呼叫。
例子¶
此例中，电话号码为 1001 的用户，专号是 2001 ，他使用该专号呼叫目标号码 3001
Request
POST /api/user/1001/makecall HTTP/1.1
Host: example.com
Content-Type: application/json
{"caller": "2001", "callee": "3001"}
Response
HTTP/1.1 200 OK
Content-Type: application/json
{"callid": "12870498123"}