README

Marketo REST API 客户端

Marketo.com REST API 的非官方 PHP 客户端： http://developers.marketo.com/documentation/rest/。需要 PHP 5.3.3+。

安装

推荐通过 Composer 安装客户端。只需运行以下命令即可将库添加到您的 composer.json 文件中。

composer require ex3mp/marketo-rest-client

设置

客户端基于 Guzzle 3 构建，并使用工厂方法创建实例。您必须指定 Munchkin ID 或完整的 URL。

####对于 Rest Api 访问

use CSD\Marketo\Client;

$client = Client::factory(array(
    'client_id' => 'Marketo client ID',         // required
    'client_secret' => 'Marketo client secret', // required
    'munchkin_id' => '100-AEK-913' // alternatively, you can supply the full URL, e.g. 'url' => 'https://100-AEK-913.mktorest.com'
));

####对于 Bulk Api 访问

use CSD\Marketo\Client;

$client = Client::factory(array(
    'client_id' => 'Marketo client ID',         // required
    'client_secret' => 'Marketo client secret', // required
    'munchkin_id' => '100-AEK-913' // alternatively, you can supply the full URL, e.g. 'url' => 'https://100-AEK-913.mktorest.com'
    'bulk' => true // if uploading leads via file upload (e.g. csv)
));

用法

查看 src/Client.php 的源代码以获取所有可用方法。

贡献

请创建 pull 请求。希望 pull 请求能在几天内得到审查。一般来说，不要合并您自己的 pull 请求。只要在 service.json 文件中添加了操作，就可以使用操作，只要您使用 $client->getFoo()->getResult()。但大多数操作都有它们自己的访问方法，并简化了参数处理。除非操作有特殊功能，否则不需要为操作创建自己的响应类。请在此项目中尊重语义版本控制。这意味着除非计划进行主要版本更改，否则不允许破坏向后兼容性。

添加新操作的简单示例

{
    "operations": {
        "getFoo": {
            "httpMethod": "GET",
            "uri": "foo.json",
            "parameters": {},
            "responseModel": "baseResponse",
            "responseClass": "CSD\\Marketo\\Response"
        },
}

许可证

此源代码受 MIT 许可证的许可，有关详细信息，请参阅 LICENSE 文件。如果您使用此代码，我们非常希望听到您的反馈。