celikmustafa89 / sendinblue-api-php
Sendinblue 版本-3 API
v1.0.9
2018-05-03 14:08 UTC
Requires
- php: >=5.3
- ext-curl: *
This package is not auto-updated.
Last update: 2024-09-21 05:20:15 UTC
README
这是 SendinBlue Php 库。它实现了各种公开的 API,您可以在 https://developers.sendinblue.com/docs 上了解更多信息。
SendinBlue API 使用通过 api key 的 HTTP 认证。您可以从 API 控制台 创建您的 api key,在您通过 SendinBlue 注册账户后。您必须使用最新版本 3.0 的访问密钥来访问 API。
本库
安装与配置
composer require celikmustafa89/sendinblue-api-php
- 以下字段必须添加到 .env 文件。
# you can get sendinblue api-key from: https://account.sendinblue.com/advanced/api
# you can get sendinblue mail-list-id from: https://my.sendinblue.com/lists
SENDINBLUE_URL=https://api.sendinblue.com/v3/
SENDINBLUE_APIKEY=XXXXXXXX<your-api-key>XXXXXXXXXX
SENDINBLUE_MAIL_LIST_ID=2
示例代码
您可以使用以下示例脚本来开始。
<?php /** * Created by PhpStorm. * User: mustafa çelik * Email: celikmustafa89@gmail.com * Date: 30.04.2018 * Time: 17:51 */ require('Mailin.php'); /* * This will initiate the API with the endpoint and your access key. * */ $mailin = new Mailin('https://api.sendinblue.com/v3/','Your access key'); /* * This will send a transactional email * */ /** Prepare variables for easy use **/ $data = array( "to" => array("to@example.net"=>"to whom!"), "cc" => array("cc@example.net"=>"cc whom!"), "bcc" =>array("bcc@example.net"=>"bcc whom!"), "from" => array("from@email.com","from email!"), "replyto" => array("replyto@email.com","reply to!"), "subject" => "My subject", "text" => "This is the text", "html" => "This is the <h1>HTML</h1><br/> This is inline image 1.<br/> <img src=\"{myinlineimage1.png}\" alt=\"image1\" border=\"0\"><br/> Some text<br/> This is inline image 2.<br/> <img src=\"{myinlineimage2.jpg}\" alt=\"image2\" border=\"0\"><br/> Some more text<br/> Re-used inline image 1.<br/> <img src=\"{myinlineimage1.png}\" alt=\"image3\" border=\"0\">", "attachment" => array(), "headers" => array("Content-Type"=> "text/html; charset=iso-8859-1","X-param1"=> "value1", "X-param2"=> "value2","X-Mailin-custom"=>"my custom value", "X-Mailin-IP"=> "102.102.1.2", "X-Mailin-Tag" => "My tag"), "inline_image" => array('myinlineimage1.png' => "your_png_files_base64_encoded_chunk_data",'myinlineimage2.jpg' => "your_jpg_files_base64_encoded_chunk_data") ); var_dump($mailin->send_email($data)); // var_dump($mailin->get_account()); // var_dump($mailin->get_smtp_details()); // $data = array("limit" => 10, "offset" => 0); // var_dump($mailin->get_folders($data)); // $data = array("name" => "test_folder"); // var_dump($mailin->create_folder($data)); // $data = array("folderId" => "5"); // var_dump($mailin->get_folder($data)); // $data = array("folderId" => "4", "name" => "test_folder_rename1"); // var_dump($mailin->update_folder($data)); // $data = array("folderId" => "4"); // var_dump($mailin->delete_folder($data)); // $data = array("limit" => "410", "offset" => "0"); // var_dump($mailin->get_folder($data)); // $data = array("folderId" => 1, "limit" => "410", "offset" => "0"); // var_dump($mailin->get_folder($data)); // $data = array("folderId" => 1, "name" => "deneme_list"); // var_dump($mailin->create_list($data)); // $data = array("folderId" => 1, "name" => "deneme_list"); // var_dump($mailin->create_list($data)); // $data = array("listId" => 9); // var_dump($mailin->get_list($data)); // $data = array("listId" => 9, "name" => "list_update_test"); // var_dump($mailin->update_list($data)); // $data = array("listId" => 9, "folderId" => 8); // var_dump($mailin->update_list($data)); // $data = array("listId" => 9); // var_dump($mailin->delete_list($data)); // // TODO: something wrong with datetime object // $date = new \DateTime("1999-12-12 12:00:00.0001"); // $data = array("listId" => 2, "modifiedSince" => date("1999-12-12 12:00:00.0001"), "limit" => 50, "offset" => 1); // var_dump( $date, $mailin->get_list_contacts($data)); // $data = array("listId" => 6, "emails" => array('mustafa.celik@epigra.com', 'celikmustafa89@gmail.com')); // var_dump($mailin->add_contacts_list($data)); // $data = array("listId" => 6, "all" => true); // var_dump($mailin->delete_contacts_list($data)); // $data = array("limit" => 50, "offset" => 0, "modifiedSince" => date("1999-12-12 12:00:00.0001")); // var_dump($mailin->get_all_contacts($data)); // $data = array("email" => "caneraa.asa@epigra.com", // "attributes" => array("firstname" => "caner", "lastname" => "asa", "sms" => "5064445566"), // "emailBlacklisted" => false, // "smsBlacklisted" => false, // "listIds" => array(2, 6), // "updateEnabled" => false); // var_dump($mailin->create_contact($data)); // $data = array("email" => "caner.asa@epigra.com"); // var_dump($mailin->retrieve_contact_information($data)); // $data = array("email" => "caner.asa@epigra.com"); // var_dump($mailin->delete_contact($data)); // $data = array("email" => "mustafa.celik@epigra.com"); // var_dump($mailin->get_campaigns_statistics_of_contact($data)); // $data = array("email" => "caner.asa@epigra.com", // "emailBlacklisted" => false, // "smsBlacklisted" => false, // "listIds" => array(2), // "unlinkListIds" => array(6)); // var_dump($mailin->update_contact($data)); ?>
- 要了解更多,您应该访问 SendinBlue v3 API 文档。
API 函数
- sms_api - SMS 函数
- contacts_api - 联系人函数
- web_hooks_api - Webhook 函数
- smtp_api - SMTP 函数
- email_campaings_api - 邮件营销函数
- process_api - 处理函数
- senders_api - 发送者函数
- resellers_api - 代理商函数
- account_api - 账户函数
支持与反馈
请务必访问 SendinBlue 官方 文档网站 以获取有关我们 API 的更多信息。
我们还支持 Composer。
如果您发现错误,请通过 github 提交问题,或通过 celikmustafa89@gmail.com 邮件联系我。