README

Master:

功能

• 电话管理
• 查询和发送短信
• 查询和发送TTS
• 查询和发送音频
• 账户管理
• 总机管理

要求

• PHP 5.5+
• PSR-4兼容的Autoloader

安装

要安装库，只需通过composer添加

composer require tvce/client 1.0.5

到composer.json

{
    "tvce/client": "1.0.5"
}

测试

我们可以使用composer运行测试

composer test

或使用.phar

php composer.phar test

使用

要使用此库，您首先需要在Total Voice API网站上注册。注册后，将提供AccessToken以访问API。

有了AccessToken，就可以根据API文档进行查询/注册。

以下是一个如何使用此库的简单示例。

在两个号码A和B之间进行电话通话

<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado

use Tvce\SocketClient;
use Tvce\Call\CallService;
use Tvce\SocketClientException;

try {
    
    $client = new SocketClient('{YOUR-ACCESS-TOKEN}', 'api.totalvoice.com.br');
    $service = new CallService($client);
    $response = $service->call('NUMERO-A', 'NUMERO-B');
    echo $response;

    $client->close();

} catch(SocketClientException $ex) {
    echo $ex->getMessage();
}

通过ID查询通话

<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado

use Tvce\SocketClient;
use Tvce\Call\CallService;
use Tvce\SocketClientException;

try {
    
    $client = new SocketClient('{YOUR-ACCESS-TOKEN}', 'api.totalvoice.com.br');
    $service = new CallService($client);
    $response = $service->getCall('ID_CHAMADA');
    echo $response; // {}

    $client->close();

} catch(SocketClientException $ex) {
    echo $ex->getMessage();
}

结束活跃通话

<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado

use Tvce\SocketClient;
use Tvce\Call\CallService;
use Tvce\SocketClientException;

try {
    
    $client = new SocketClient('{YOUR-ACCESS-TOKEN}', 'api.totalvoice.com.br');
    $service = new CallService($client);
    $response = $service->finish('ID_CHAMADA');
    echo $response; // {}

} catch(SocketClientException $ex) {
    echo $ex->getMessage();
}

发送短信

<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado

use Tvce\SocketClient;
use Tvce\SMS\SMSService;
use Tvce\SocketClientException;

try {
    
    $client = new SocketClient('{YOUR-ACCESS-TOKEN}', 'api.totalvoice.com.br');
    $service = new SMSService($client);
    $response = $service->send('NUMERO-DESTINO', 'MENSAGEM');
    echo $response; // {}

} catch(SocketClientException $ex) {
    echo $ex->getMessage();
}

发送TTS

<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado

use Tvce\SocketClient;
use Tvce\TTS\TTSService;
use Tvce\SocketClientException;

try {
    
    $client = new SocketClient('{YOUR-ACCESS-TOKEN}', 'api.totalvoice.com.br');
    $service = new TTSService($client);
    $response = $service->send('NUMERO-DESTINO', 'MENSAGEM');
    echo $response; // {}

} catch(SocketClientException $ex) {
    echo $ex->getMessage();
}

发送音频

<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado

use Tvce\SocketClient;
use Tvce\Audio\AudioService;
use Tvce\SocketClientException;

try {
    
    $client = new SocketClient('{YOUR-ACCESS-TOKEN}', 'api.totalvoice.com.br');
    $service = new AudioService($client);
    $response = $service->send('NUMERO-DESTINO', 'MENSAGEM');
    echo $response; // {}

} catch(SocketClientException $ex) {
    echo $ex->getMessage();
}

电话总机配置

<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado

use Tvce\SocketClient;
use Tvce\Central\CentralService;
use Tvce\SocketClientException;

try {
    
    $client = new SocketClient('{YOUR-ACCESS-TOKEN}', 'api.totalvoice.com.br');
    $service = new CentralService($client);
    $response = $service->create();
    echo $response; // {}

} catch(SocketClientException $ex) {
    echo $ex->getMessage();
}

账户数据管理

<?php
// Considero que já existe um autoloader compatível com a PSR-4 registrado

use Tvce\SocketClient;
use Tvce\Account\AccountService;
use Tvce\SocketClientException;

try {
    
    $client = new SocketClient('{YOUR-ACCESS-TOKEN}', 'api.totalvoice.com.br');
    $service = new AccountService($client);
    $response = $service->get('ID_CONTA');
    echo $response; // {}

} catch(SocketClientException $ex) {
    echo $ex->getMessage();
}

有关可用方法的更多信息，请参阅API文档

许可

此库遵循MIT的使用条款