aliromero/kavengar

PHP 对 Kavenegar API 的封装

dev-master 2023-04-11 16:56 UTC

This package is auto-updated.

Last update: 2024-09-11 20:04:52 UTC


README

Latest Stable Version Total Downloads

Kavenegar RESTful API 文档

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

安装

首先,您需要从 此处 在 Kavenegar 上创建一个账户

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

使用以下方式

composer require kavenegar/php

或添加

"kavenegar/php": "*"

使用以下命令通过 composer 下载扩展

$ composer update

使用方法

以下是一个使用 PHP 发送短信的示例。

require __DIR__ . '/vendor/autoload.php';

try{
	$api = new \Kavenegar\KavenegarApi( "API Key" );
	$sender = "10004346";
	$message = "خدمات پیام کوتاه کاوه نگار";
	$receptor = array("09123456789","09367891011");
	$result = $api->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(\Kavenegar\Exceptions\ApiException $e){
	// در صورتی که خروجی وب سرویس 200 نباشد این خطا رخ می دهد
	echo $e->errorMessage();
}
catch(\Kavenegar\Exceptions\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 开发套件的波斯语指南,请访问 发送短信代码 页面。

更多信息

要了解更多信息,请访问 Kavenegar 短信 Web 服务 的介绍页面。

如果您在使用 Kavenegar 服务套件时遇到问题或有建议,请通过 Pull Request 或发送电子邮件到 support@kavenegar.com 来让我们高兴。

http://kavenegar.com

http://kavenegar.com