README

使用 Guzzle 与 Shutterstock API 交互的 PHP 客户端。

安装

使用 Composer 安装依赖项。

$ composer require shutterstock/api

使用方法

实例化客户端需要传递客户端 ID 和密钥，您可以在 Shutterstock 开发者网站上注册。

<?php

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

$client = new Shutterstock\Api\Client($clientId, $clientSecret);

与不同端点交互就像阅读 API 文档一样简单。客户端有两个主要方法来处理 - Client::get 和 Client::post - 它们将端点作为第一个参数，客户端参数作为第二个参数。

// perform an image search for puppies
$client->get('images/search', array('query' => 'puppies'));

// retrieve details for a handful of image ids
$client->get('images', array('id' => array(1, 2, 3)));

// create a lightbox
$client->post('images/collections', array('name' => 'Lightbox Name Here'));

每个请求将返回一个 PSR-7 响应对象，您可以在 Guzzle/PSR7 仓库中了解更多信息。响应对象体已经装饰了 JsonSerializable 接口，以便更容易处理默认 API 响应。

$imageResponse = $client->get('images', array('id' => array(1, 2, 3)));
if ($imageResponse->getStatusCode() != 200) {
    // error handler
}
$images = $imageResponse->getBody()->jsonSerialize()['data'];
// etc

如果您的应用程序已配置为处理异步 CURL 请求，您还可以进行 Client::getAsync 和 Client::postAsync 调用，这些调用返回 Guzzle Promises。

有关更多示例和演示应用程序，请参阅 [链接在此处]。

shutterstock / api

维护者

详细信息

README

安装

使用方法

许可