README

为Laravel 5.*提供的简单Buffer API包。

安装

要安装，请在项目目录中运行以下命令

$ composer require mbarwick83/buffer dev-master

然后在 config/app.php 中将以下内容添加到 providers 数组中

Mbarwick83\Buffer\BufferServiceProvider::class

此外，如果您必须（建议您不要），请将外观类添加到 config/app.php 中的 aliases 数组中

'Buffer'    => Mbarwick83\Buffer\Facades\Buffer::class

但最好是直接注入类，如下所示（这应该很熟悉）

use Mbarwick83\Buffer\Buffer;

配置

要发布包配置文件，请运行以下 vendor:publish 命令

php artisan vendor:publish

这将创建一个 buffer.php 文件在您的配置目录中。在这里您必须输入您的Buffer API密钥。您可以在 https://buffer.com/developers/api 获取API密钥。

示例用法

use Mbarwick83\Buffer\Buffer;

// Get login url:
public function index(Buffer $buffer)
{
	return $buffer->getLoginUrl();
}

// Get access token on callback, once user has authorized via above method
public function callback(Request $request, Buffer $buffer)
{
	$response = $buffer->getAccessToken($request->code);

	if (isset($response['code']))
        throw new \Exception($response['error_message'], $response['code']);

	return $buffer->getUserDetails($response['access_token']);
}

这些是API包中的唯一三个自定义类（即 getLoginUrl()、getAccessToken() 和 getUserDetails()。其余的API基于Buffers的端点使用 POST 和 GET 请求来保持此包 极其简单。您可以在此处查看所有端点。

您只需指定请求是 POST 还是 GET 请求，指定 仅端点 以及所需的任何URL查询（为数组）。例如

public function index(Buffer $buffer)
{
    $user_profiles = $this->buffer->get('1/profiles.json', ['access_token' => $access_token]);
    return $user_profiles;
}

非常简单易懂！

贡献

请参阅CONTRIBUTING 和 CONDUCT 获取详细信息。

鸣谢

• Mike Barwick
• 所有贡献者

许可证

MIT许可证（MIT）。请参阅许可证文件获取更多信息。