README

PHP Two Tap SDK 为 Two Tap API 提供了原生接口

安装

此库可在 包管理器 上找到。推荐通过 Composer 安装。

运行以下命令以安装 Composer、库及其依赖项

$ curl -sS https://getcomposer.org/installer | php
$ php composer.phar require two-tap/php-sdk

然后您需要安装 Guzzle

$ php composer.phar require guzzlehttp/guzzle:~6.0

或编辑 composer.json 并添加

{
    "require": {
        "two-tap/php-sdk": "~1.0"
    }
}

然后添加 Guzzle

{
    "require": {
        "guzzlehttp/guzzle": "~6.0"
    }
}

文档

有关完整 API 文档，请参阅我们的官方 文档页面。

用法

<?php

require 'vendor/autoload.php';

use TwoTap\Api;

// create an api object
$api = new Api([
    'public_token' => 'YOUR_PUBLIC_TOKEN',
    'private_token' => 'YOUR_PRIVATE_TOKEN'
]);

// ...

Product::class

get()

$api->product()->get($siteId, $md5, $destinationCountry, $productAttributesFormat);

$api->product()->get($siteId, null, null, null, $catalogKey);

search()

$api->product()->search($filter, $sort, $page, $perPage, $productAttributesFormat, $destinationCountry);

scroll()

$api->product()->scroll($filter, $size, $scrollId, $productAttributesFormat, $destinationCountry);

filters()

$api->product()->filters($filter);

taxonomy()

$api->product()->taxonomy();

Cart::class

create()

$api->cart()->create($products, $finishedUrl, $finishedProductAttributesFormat, $notes, $testMode, $cacheTime, $destinationCountry);

status()

$api->cart()->status($cartId, $productAttributesFormat, $testMode, $destinationCountry);

estimates()

$api->cart()->estimates($cartId, $fieldsInput, $products, $destinationCountry);

Purchase::class

create()

$api->purchase()->create($cartId, $fieldsInput, $affiliateLinks, $confirm, $products, $notes, $testMode, $locale);

status()

$api->purchase()->status($purchaseId, $testMode);

history()

$api->purchase()->history($since);

confirm()

$api->purchase()->confirm($purchaseId, $testMode);

Utils::class

fieldsInputValidate()

$api->utils()->fieldsInputValidate($cartId, $flatFieldsInput);

quicky()

$api->utils()->quicky($products, $smsConfirmUrl, $phone, $message);

supportedSites()

$api->utils()->supportedSites($cartId, $flatFieldsInput);

coupons()

$api->utils()->coupons($cartId, $flatFieldsInput);

PickupOptions::class

create()

$api->pickupOptions()->create($cartId, $fieldsInput, $products, $finishedUrl);

status()

$api->pickupOptions()->status($cartId);

Wallet::class

userToken()

$api->wallet()->userToken($userKey);

retrieve()

$api->wallet()->retrieve($userToken, $filterFieldTypes, $filterGroupIds);

store()

$api->wallet()->store($userToken, $fieldType, $groupId, $fields);

delete()

$api->wallet()->delete($userToken, $fieldType, $fieldGroupId);

meta()

$api->wallet()->meta($$metaFields, $fieldType, $expiresIn);

Laravel 使用方法

Two Tap API SDK 可选支持 Laravel & Lumen，并附带 Service Provider 和 Facades 以简化集成。

安装 TwoTap API SDK 后，打开您的 Laravel 配置文件 config/app.php 并添加以下行。

在 $providers 数组中添加此软件包的 Service Provider。

TwoTap\TwoTapServiceProvider::class

将此软件包的 Facade 添加到 $aliases 数组中。

'TwoTap' => TwoTap\Facades\TwoTap::class

现在 Laravel 将自动加载 TwoTap 类。

示例

// usage inside a laravel route
Route::get('/', function()
{
    $filter = [
        "keywords" => "Vans sneakers"
    ];

    $results = TwoTap::product()->search($filter);

    return $results->products;
});