navarr/verticalresponse

Vertical Response API 包装器 - 从官方 Vertical Response 仓库转换而来

v3.0 2016-07-30 14:22 UTC

This package is auto-updated.

Last update: 2024-09-12 03:56:08 UTC


README

Latest Stable Version License Scrutinizer Total Downloads

简介

每个人都喜欢 API 包装器!这个包装器封装了 VerticalResponse API (v1)。

VerticalResponse 自己的包装器相当不错 - 但在一个 PHP 文件夹中,没有 composer 支持,类名很奇怪,等等 - 我认为现在是时候更新它了!

如何使用

安装

因为我疯了,我试图让这个库对发送 HTTP 请求的库没有意见。这很酷,因为它意味着你可以加入你自己的 HTTP 客户端。

然而,我也让它默认使用 Guzzle,如果你没有指定的话 - 这样你可以尽可能保持构造函数的简洁。

但是,我不想在每个安装中都包含所有的 Guzzle - 所以它只是一个 建议的 依赖项。

总结:要使用这个库,建议你 composer require navarr/verticalresponse navarr/verticalresponse-guzzle

代码中的使用

你首先需要从 VerticalResponse OAuth 2.0 API 端点获取授权令牌。这留给读者作为练习。

一旦你做到了,只需将它传递到 VerticalResponse 客户端,如下所示

$vr = new \VerticalResponse\Client($authorizationToken);
$response = $vr->get('lists');
var_dump($response);

对于一个新垂直响应账户,输出可能如下所示

class stdClass#35 (3) {
  public $url =>
  string(47) "https://vrapi.verticalresponse.com/api/v1/lists"
  public $items =>
  array(1) {
    [0] =>
    class stdClass#29 (2) {
      public $url =>
      string(62) "https://vrapi.verticalresponse.com/api/v1/lists/25288767452069"
      public $attributes =>
      class stdClass#22 (4) {
        ...
      }
    }
  }
  public $links =>
  class stdClass#33 (1) {
    public $up =>
    class stdClass#36 (1) {
      public $url =>
      string(41) "https://vrapi.verticalresponse.com/api/v1"
    }
  }
}

当前版本的此库不提供任何用于管理此 API 数据的 ActiveRecord 工具。这也留给了读者作为练习。