jxx0410/zhetaoke

折淘客 SDK for PHP

Maintainers

Details

gitee.com/lix0410/ztk

Installs: 8

Dependents: 0

Suggesters: 0

Security: 0

v1.0.1 2022-09-27 02:57 UTC

Requires

MIT 25297118515ef568ac6ee12a81a4fd1d11b8c214

  • jxx0410 <516036855.woop@qq.com>

This package is auto-updated.

Last update: 2024-04-27 06:50:09 UTC

README

基于 折淘客开放平台 的 PHP 淘宝客组件

声明

更改于levelooygithub的项目

php8.0 无法composer 所以自己更改了一下

安装

$ composer require jxx0410/zhetaoke

配置

在使用本扩展之前，你需要去 折淘客开放平台 注册账户，获取 Appkey，并对淘宝客账号 授权 以获取 sid

使用

<?php
use Jxxztk\Zhetaoke\Application;

require __DIR__.'/vendor/autoload.php';

$options = [
    'app_key' => 'ac3d46dt3o4tt77a***',
    'sid' => '10',
];

$app = new Application($options);

智能高佣转链

  • 只需一行代码搞定 N 个需求
  • 可以传入: 商品编号/淘口令/带淘口令的文案/各种链接/喵口令
  • 返回: 商品详情、最大佣金比例、转链后的淘口令、二合一链接、商品链接（长链接）、短链接

$app->tool->smartConvert('商品编号/淘口令/带淘口令的文案/各种链接/喵口令', '要关联的淘宝客 Pid');

订单查询


// 查询从 2019-02-02 00:00:00 开始，1200 秒内创建的订单
$app->tool->ordersByCreateAt('2019-02-02 00:00:00', '1200');

// 查询从 2019-02-02 00:00:00 开始，1200 秒内结算的订单
$app->tool->ordersByCompleteAt('2019-02-02 00:00:00', '1200');

商品库

  • 一行代码搞定所有商品库需求
  • 所有查询条件支持链式操作，支持任意顺序
  • 对应开放平台 领券API

// 获取站内所有商品（第 2 页）
$app->good->list(2);

// 按分类获取站内商品：女装、第 3 页
$app->good->category(1)->list(3);

// 排序，支持'new', 'sale_num', 'commission_rate_asc', 'commission_rate_desc', 'price_asc', 'price_desc'
// 女装、按照总销量从大到小排序、第 1 页
$app->good->category(1)->sort('sale_num')->list(1);

// 每页显示 30 条
$app->good->category(1)->sort('sale_num')->pageSize(30)->list(1);

// 关键字（内衣）
$app->good->category(1)->keyword('内衣')->sort('sale_num')->pageSize(30)->list(1);

// 只显示天猫商品
$app->good->tmall()->category(1)->keyword('内衣')->sort('sale_num')->pageSize(30)->list(1);

// 金牌卖家商品
$app->good->goldSeller()->list(1);

// 淘抢购商品
$app->good->taoQiangGou()->list(1);

// 聚划算商品
$app->good->juHuaSuan()->list(1);

// 海淘商品
$app->good->haiTao()->list(1);

// 极有家商品
$app->good->jiYouJia()->list(1);

// 今日商品
$app->good->today()->list(1);

// 精选品牌商品
$app->good->brand()->list(1);

// 9.9 元商品
$app->good->price(0, 9.9)->list(1);

// 19.9 元商品
$app->good->price(0, 19.9)->list(1);

// 100 元到 199 元商品
$app->good->price(100, 199)->list(1);

// 高佣商品（佣金比例大于 40%）
$app->good->commission(40)->list(1);

// 高销量商品（销量大于 100000）
$app->good->volume(100000)->list(1);

// 高评分商品（评分大于 4.9）
$app->good->score(4.9)->list(1);

// 大额券商品（优惠券金额大于 200 元）
$app->good->couponAmount(200)->list(1);

// 两小时销量榜
$app->good->top('2hours')->sort('sale_num')->price(0, 19.9)->list(1);

// 24 小时销量榜
$app->good->top('1day')->sort('new')->score(4.9)->list(1);

// 实时人气榜
$app->good->top('now')->sort('new')->score(4.9)->list(1);

// 咚咚抢商品
$app->good->top('ddq')->sort('new')->score(4.9)->list(1);

> 一般情况下，以上接口就够用了，如果要单独调用，请继续往下看。。。

站内商品详情


$app->good->item('商品 ID');

对淘口令或者带淘口令的文案高佣转链

  • 支持￥TdJCbN68klT￥、TdJCbN68klT、(TdJCbN68klT)、€TdJCbN68klT€、💰TdJCbN68klT💰等格式。
  • 对应开放平台 高佣转链API（淘口令）

$app->tool->convertTpwd('要转链的淘口令或者带淘口令的文案', '要关联的淘宝客 Pid');

可以传第三个参数为 true，将同时返回额外的信息，包括创建淘口令、短地址、商品详情（全网）

对商品 ID 进行高佣转链


$app->tool->convertGoodId('商品 ID', '要关联的淘宝客 Pid');

可以传第三个参数为 true，将同时返回额外的信息，包括创建淘口令、短地址、商品详情（全网）

解析出商品 ID

  • 对应开放平台 解析商品编号API
  • 支持从淘口令、淘口令文案、长链接、二合一链接、短链接、喵口令中解析出商品 ID

$app->tool->parseGoodId('需解析的内容');

解析获取其他优惠券

  • 对应开放平台 其它优惠券获取API
  • 支持从淘口令文案、二合一链接、长链接、短链接中解析出使用的其它优惠券编号

$app->tool->parseActivityId('需解析的内容');

生成淘口令

  • 对应开放平台 淘口令生成API
  • 支持二合一链接、长链接、短链接等各种淘宝高佣链接，必须以 https 开头

$app->tool->createTpwd($title, $url, $logo);

全网商品详情（简版）


$app->tool->detail('商品编号');

生成短链接


$app->tool->shortUrl($url, 'sina');
$app->tool->shortUrl($url, 'baidu');

在 Laravel 中的使用

配置

  1. 在 config/app.php 注册 ServiceProvider 和 Facade (Laravel 5.5 无需手动注册)
'providers' => [
    // ...
    Levelooy\Zhetaoke\ServiceProviderForLaravel::class,
],
'aliases' => [
    // ...
    'Zhetaoke' => Levelooy\Zhetaoke\Facade::class,
],
  1. 创建配置文件：
php artisan vendor:publish --tag="zhetaoke"

  1. 修改应用根目录下的 config/zhetaoke.php 中对应的参数即可。

  2. 支持多账号，默认为 default。

使用

// 使用默认配置
app('zhetaoke')->tool->smartConvert('商品编号/淘口令/带淘口令的文案/各种链接/喵口令', '要关联的淘宝客 Pid');
// 使用 account1 的配置
app('zhetaoke.account1')->tool->smartConvert('商品编号/淘口令/带淘口令的文案/各种链接/喵口令', '要关联的淘宝客 Pid');
// 还可以使用外观
Zhetaoke::good()->list();
Zhetaoke::good('account1')->list();

License

MIT