README

如果你好奇的话，Buffer是一个社交应用，允许你自动将更新发布到你的社交资料。我写这篇文章是为了向你展示如何使用Buffer的API来发布更新。

首先，你需要（当然）一个Buffer账户，你可以在https://www.buffer.com创建。一旦你注册了，你需要通过访问https://buffer.com/developers/apps/create来创建一个应用。填写所有必填字段，并将回调URL设置为"urn:ietf:wg:oauth:2.0:oob"。完成后，点击“创建应用”，你应该会被重定向到一个包含“访问令牌”的页面，你需要记录这个令牌以供将来使用。

由于我们使用PHP来创建此应用，并且截至撰写本文时，Buffer的API只有一个Ruby库，所以我编写了这个PHP类来利用Buffer的API。现在让我们看看如何使用这个PHP类，以便你可以在未来日期发布更新。

首先，你需要使用以下代码包含PHP类。你需要之前创建的应用的访问令牌。

// If not using composer use the following line, replacing [path].
// require_once '[path]/src/BufferPHP.php';

use jcnventura\BufferPHP\BufferPHP;

$buffer = new BufferPHP('YOUR ACCESS TOKEN');

现在，对于下一部分的代码，你需要配置文件ID，这样Buffer就知道要将更新发布到哪些社交资料上。为了获取这些信息，我去了我的仪表板（https://buffer.com/app），点击了我想要的社会资料的标签页，配置文件ID位于仪表板和挂起之间（例如：http://bufferapp.com/dashboard/YOUR SOCIAL PROFILE ID/pending>）。一旦你确定了要使用哪些，将它们放入以下代码中

$data = array('profile_ids' => array());
$data['profile_ids'][] = 'PROFILE ID';
$data['profile_ids'][] = 'PROFILE ID';

接下来，你需要确定你将在更新中写什么。确定后，将其输入以下代码

$data['text'] = '这是一个示例';

所以，假设你想要在你的更新中添加一张图片或一个链接，那么事情就会变得稍微复杂一些。对于链接来说很简单，你只需要添加一个URL，就像这样

$data['media'] = array('link' => 'http://example.com/');

如果你想要在URL中添加图片，那么你需要三样东西。第一是图片（很显然）。第二是图片的缩略图。第三，你需要知道图片的URL（通常像http://example.com/images/whiskers.png和http://example.com/images/whiskers_thumb.png）。如果你有这三样东西，你就可以像这样在更新中添加图片

$data['media'] = array(
  'picture' => 'http://example.com/images/whiskers.png',
  'thumbnail' => 'http://example.com/images/whiskers_thumb.png',
);

（注意：你只能在更新中添加链接或图片，但不能两者都添加）

现在你已经有了所需的信息，你需要使用以下代码将其发送到Buffer的API

$ret = $buffer->post('updates/create', $data);

大家好！一旦您运行了这个PHP脚本（并且希望您没有遇到任何错误），更新应该会显示在您的Buffer仪表板上。如果没有显示，请提出您遇到的问题错误，我会尽力帮助您。如果您是“PHP大师”，那么您可以扩展此脚本，使其每天、每周等自动向Buffer发布预定义的更新，但这取决于您。PHP类和示例脚本属于公有领域，任何人都可以为任何目的使用它。

jcnventura / bufferphp

维护者

详细信息

README