bananatag/bananatag-api-php

Bananatag API PHP 库与 Bananatag 的 REST API 一起使用（目前处于alpha版本，仅应请求提供）。Bananatag REST API 允许用户访问其账户和子账户相关的所有数据。

维护者

详细信息

github.com/bananatag/bananatag-api-php

主页

源代码

问题

安装: 22

依赖: 0

建议: 0

安全性: 0

星标: 0

关注者: 15

分支: 1

开放问题: 0

0.1.0 2015-03-30 21:52 UTC

Requires

  • php: >=5.3.0

MIT 46d4293031efd463d0439221fa04e5d88a6ceb1c

  • Bananatag Systems <eric.woop@bananatag.com>

apiBananatag

This package is not auto-updated.

Last update: 2024-10-02 06:44:15 UTC

README

Bananatag API PHP 库与 Bananatag 的 REST API 一起使用（目前处于alpha版本，仅应请求提供）。Bananatag REST API 允许用户访问其账户和子账户相关的所有数据。

安装

Composer

"require": {
    "bananatag/bananatag-api-php": "dev-master"
}

尚未使用 Composer，请在此获取 Composer。

需求

  • PHP 5.3+
  • CURL 7.30.0+.

基本用法

获取所有标签

<?php
    use Bananatag\Api;
    
    // Create Api class instance
    $btag = new Api('AuthID', 'Access Key');
	
    // Make request for all tags in date range
	$results = $btag->request("tags", ['start'=>'2015-01-01', 'end'=>'2015-02-01']);
	
    // Print list of tags
    echo "Total Tags: " . count($results['data']) . "<br><hr><br>";
    
    print_r($results['data']);

分页

每次使用相同参数进行请求时，库会自动获取下一页。

<?php
$btag = new Api('AuthID', 'Access Key');

function getTags(&$btag) {
    $results = $btag->request("tags", []);

    echo $results['paging']['cursors']['next'];

    if ($results['paging']['cursors']['next'] < $results['paging']['cursors']['total']) {
        sleep(1.2);
        getTags($btag);
    }
}

getTags($btag);

上面的递归示例可以写成

<?php
// Page 1
$results = $btag->request("tags", []);
// Page 2
$results = $btag->request("tags", []);
// Page 3, etc
$results = $btag->request("tags", []);

或者您可以手动选择页面

<?php
// Page 1
$results = $btag->request("tags", ['page'=>1]);
// Page 3
$results = $btag->request("tags", ['page'=>3]);
// Page 2
$results = $btag->request("tags", ['page'=>2]);

请求限制

API 限制为每秒1个请求。

许可证

MIT 许可证。