celikmustafa89/sendinblue-api-php

Sendinblue 版本-3 API

v1.0.9 2018-05-03 14:08 UTC

README

这是 SendinBlue Php 库。它实现了各种公开的 API,您可以在 https://developers.sendinblue.com/docs 上了解更多信息。

SendinBlue API 使用通过 api key 的 HTTP 认证。您可以从 API 控制台 创建您的 api key,在您通过 SendinBlue 注册账户后。您必须使用最新版本 3.0 的访问密钥来访问 API。

本库

安装与配置

  1. composer require celikmustafa89/sendinblue-api-php
  2. 以下字段必须添加到 .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));

?>

API 函数

支持与反馈

请务必访问 SendinBlue 官方 文档网站 以获取有关我们 API 的更多信息。

我们还支持 Composer

如果您发现错误,请通过 github 提交问题,或通过 celikmustafa89@gmail.com 邮件联系我。