README

免费和开源的营销自动化API

要求

• PHP 5.5.*或更高版本
• cURL支持

Mautic设置

API必须在Mautic中启用。在Mautic中，转到配置页面（位于设置菜单中）并在API设置中启用Mautic的API。您还可以在此处选择要使用的OAuth2协议。保存配置后，转到API凭据页面（位于设置菜单中）并创建一个新的客户端。输入请求将从中发送的回调/重定向URI。点击应用，然后将客户端ID和客户端密钥复制到将使用API的应用程序中。

安装

首先，您需要使用Composer要求此包

composer require masmaleki/laravel-mautic-api

然后，从命令行运行composer update。

然后，通过在服务提供程序中添加条目来更新config/app.php。

'providers' => [
	// ...
	'masmaleki\Mautic\MauticServiceProvider',
],

然后，通过在别名部分添加条目来注册类别名

'aliases' => [
    //.....
    'Mautic' => 'masmaleki\Mautic\Facades\Mautic',
],

最后，从命令行运行php artisan vendor:publish以发布默认配置文件。这将发布一个名为mautic.php的配置文件，consumer migration和consumer model。

运行php artisan migrate迁移命令以在数据库中创建消费者表。

配置

您需要将您的客户端ID、客户端密钥和回调URL添加到您的应用程序config目录中找到的mautic.php文件中。

授权

此库仅支持OAuth2授权，您必须创建OAuth2客户端才能使用API。

注册应用程序

为了将您的应用程序与Mautic注册，ping此URL，这是一次性注册。

http://your-app/mautic/application/register

用法

在您的控制器中添加Mautic Facade。

use Mautic;

向Mautic发送请求（示例）

在Mautic中创建一个新的联系人。

$params = array(
    'firstname' => 'Edison',
    'lastname'=> 'Costa',
    'email' => 'edison@keepcloud.io'
);

Mautic::request('POST','contacts/new',$params);

获取所有联系人的列表

Mautic::request('GET','contacts');

获取唯一的联系人

Mautic::request('GET','contacts/1');
//where 1 is unique id for a contact.

删除联系人

Mautic::request('Delete','contacts/1/delete');

并支持Mautic的更多端点。

Mautic支持的端点列表。

联系人

[
    "contacts",
    "contacts/{id}",
    "contacts/list/fields",
    "contacts/list/owners",
    "contacts/new",
    "contacts/{id}/edit",
    "contacts/{id}/delete",
    "contacts/{id}/notes",
    "contacts/{id}/segments",
    "contacts/{id}/campaigns"
]

资产

[
    "assets",
    "assets/{id}"
]

活动

[
    "campaigns",
    "campaigns/{id}",
    "campaigns/contact/{id}/add/{leadId}",
    "campaigns/contact/{id}/remove/{leadId}"
]

数据

[
    "data",
    "data/{type}",
]

电子邮件

[
    "emails",
    "emails/{id}",
    "emails/{id}/send",
    "emails/{id}/send/lead/{leadId}"
]

表单

[
    "forms",
    "forms/{id}"
]

页面

[
    "pages",
    "pages/{id}"
]

点

[
    "points",
    "points/{id}",
    "points/triggers",
    "points/triggers/{id}"
]

报告

[
    "reports",
    "reports/{id}"
]

段

[
    "segments",
    "segments/contact/{id}/add/{leadId}",
    "segments/contact/{id}/remove/{leadId}"
]

用户

[
    "roles",
    "roles/{id}",
    "users",
    "users/{id}",
    "users/list/roles",
    "users/self",
    "users/{id}/permissioncheck",
]

有关所有可自定义参数的详细信息，请参阅文档。