README

Kavenegar RESTful API 文档

如需获取 API 文档的更多信息，请访问 RESTful 文档

要求

Laravel 4 或 5。

安装

首先，您需要在 Kavenegar 上注册一个账户，请从这里注册

之后，您只需从我的账户部分获取 API-KEY。

按照以下方式安装

composer require kavenegar/laravel

Laravel 5 和 6

将 Kavenegar\Laravel\ServiceProvider 提供者添加到 config/app.php 中的 providers 数组

'providers' => [
  ...
  Kavenegar\Laravel\ServiceProvider::class,
],

然后将外观添加到您的 aliases 数组

'aliases' => [
  ...
  'Kavenegar' => Kavenegar\Laravel\Facade::class,
],

最后，使用 php artisan vendor:publish 发布配置文件。或者，对于 Laravel 5，您可以使用：php artisan vendor:publish --provider="Kavenegar\Laravel\ServiceProviderLaravel5"。对于 Laravel 6：php artisan vendor:publish --provider="Kavenegar\Laravel\ServiceProviderLaravel6"。
您可以在 config/kavenegar.php 中找到它。

Laravel 4

将 Kavenegar\Laravel\ServiceProvider 提供者添加到 app/config.php 中的 providers 数组

'providers' => [
  ...
  'Kavenegar\Laravel\ServiceProvider',
],

然后将外观添加到您的 aliases 数组

'aliases' => [
  ...
  'Kavenegar' => 'Kavenegar\Laravel\Facade',
],

最后，使用 php artisan config:publish kavenegar/laravel 发布配置文件。您可以在 app/config/packages/kavenegar/laravel/config.php 中找到配置文件。

使用方法

下面是一个使用 Laravel 发送短信的示例。

try{
    $sender = "10004346";
    $message = "خدمات پیام کوتاه کاوه نگار";
    $receptor = array("09123456789","09367891011");
    $result = Kavenegar::Send($sender,$receptor,$message);
    if($result){
        foreach($result as $r){
            echo "messageid = $r->messageid";
            echo "message = $r->message";
            echo "status = $r->status";
            echo "statustext = $r->statustext";
            echo "sender = $r->sender";
            echo "receptor = $r->receptor";
            echo "date = $r->date";
            echo "cost = $r->cost";
        }
    }
}
catch(ApiException $e){
    // در صورتی که خروجی وب سرویس 200 نباشد این خطا رخ می دهد
    echo $e->errorMessage();
}
catch(HttpException $e){
    // در زمانی که مشکلی در برقرای ارتباط با وب سرویس وجود داشته باشد این خطا رخ می دهد
    echo $e->errorMessage();
}

/*
sample output
{
    "return":
    {
        "status":200,
        "message":"تایید شد"
    },
    "entries":
    [
        {
            "messageid":8792343,
            "message":"خدمات پیام کوتاه کاوه نگار",
            "status":1,
            "statustext":"در صف ارسال",
            "sender":"10004346",
            "receptor":"09123456789",
            "date":1356619709,
            "cost":120
        },
        {
            "messageid":8792344,
            "message":"خدمات پیام کوتاه کاوه نگار",
            "status":1,
            "statustext":"در صف ارسال",
            "sender":"10004346",
            "receptor":"09367891011",
            "date":1356619709,
            "cost":120
        }
    ]
}
*/

贡献欢迎提交错误修复、文档和改进！请通过 support@kavenegar.com 告诉我们

指南

介绍 Kavenegar 服务

Kavenegar 是一个用于发送和接收短信以及语音通话的 Web 服务，您可以使用它。

创建账户

如果您还不是 Kavenegar Web 服务的成员，可以通过此链接注册并获取用于测试 API 的测试账户。

文档

要查看完整的文档信息，请访问 Web 服务短信页面 Web 服务文档。

波斯语指南

如果您想阅读 Kavenegar 开发工具包的波斯语指南，请访问发送短信代码页面。

beaumind / kavenegar-laravel

维护者

详细信息