README

基于大淘客开放平台Api封装的 Composer Package 组件包.

目录结构：

安装：

$ composer require maxzhang/dataoke-sdk

说明:

目前完成：

分类	名称	版本	应用场景	接口说明
入库更新API
	商品详情	v1.2.3	用于查看某个具体商品的详细信息，帮助用户购买决策。可构建单品详情页	接口说明
	定时拉取	v1.2.3	用于商品增量更新，无重复拉取商品。建议开始时间为上次调用的时间，结束时间为当前时间。	接口说明
	定时拉取	v1.0.0	用于查看京东某个具体商品的详细信息，帮助用户购买决策。用于构建单品详情页。	接口说明
基础功能API
	高佣转链	v1.3.1	可用于导购平台的高拥转链工具	接口说明
	淘口令转淘口令	v1.0.0	当用户从其他渠道采集到商品口令，想要自己推广，可以将此转为自己的淘口令	接口说明
	淘口令生成	v1.0.0	该接口可以将二合一链接、长链接、短链接等各种淘宝高佣链接，生成淘口令	接口说明
搜索相关API
	大淘客搜索	v2.1.1	基于大淘客商品数据进行搜索	接口说明
	超级搜索	v1.0.1	基于大淘客和淘宝联盟的商品两个平台的数据进行搜索，优先搜索大淘客优质商品，若查不到则会请求联盟商品。推荐在CMS等导购网站中使用	接口说明
特色栏目API
	9.9包邮精选	v1.0.2	可用于搭建淘客导购软件：网站，cms，公众号，小程序等应用的特色栏目	接口说明
	各大榜单	v1.1.2	可用于搭建自己的特色榜单，帮助用户快速决策购买优质的商品，提升选品体验	接口说明
	猜你喜欢	v1.2.2	可用于用户查看某个商品详情后相关商品的推荐或首页内容推荐	接口说明
	每日爆品推荐	v1.0.0	可用于特色栏目专区搭建，或者社群分发推广	接口说明
	京东大牌折扣	v1.0.0	可用于搭建京东品牌商品特色栏目，商品质量保证，性价比高，转化高	接口说明
	历史新低商品合集	v1.0.0	可用户搭建历史新低商品合集专题	接口说明
	大淘客独家券商品	v1.0.0	大淘客平台独家优惠券，可用于创建营销栏目。	接口说明
	每日半价	v1.0.0	可用于特色营销栏目搭建或社群分发推广	接口说明
	折上折	v1.0.0	可用于搭建导购网站、APP、小程序等应用的特色栏目或社群分发推广	接口说明
	官方活动（淘宝1元购）	v1.2.0	可用于导购平台的活动推广专区	接口说明
	热门主播力荐商品	v1.0.0	可用于搭建淘宝直播商品特色栏目	接口说明
	线报	v2.0.0	可用于app、自动发单、社群等场景，提前透出商品优惠信息，便于拉新促活，提高转化，锁佣快人一步	接口说明

官方文档

使用方法(参考suning-sdk):

use MaxZhang\DataokeSdk\Request\Govbus\CategoryGetRequest;
use MaxZhang\DataokeSdk\DefaultDataokeClient;

$req = new CategoryGetRequest();
$assertArray = [
    'serverUrl' => 'https://openapi.dataoke.com',
    'appKey' => 'b49970b52c88dee1d7c1743da32cedd2',
    'appSecret' => '2ae2da81c64ae149c2aeb99a535508b0'
];
$client = new DefaultDataokeClient($assertArray['serverUrl'], $assertArray['appKey'],
    $assertArray['appSecret']);

$resp = $client->execute($req);
$reqJson = $req->getReqJson();
print_r("请求报文:\n" . $reqJson);
print_r("\n返回响应报文:\n" . $resp);

laravel 框架中使用

laravel 5.5以下安排完毕后需要自行配置ServiceProvider：

config/app.php文件providers中添加 MaxZhang\DataokeSdk\ServiceProvider::class

 'providers' => [
        ...
        MaxZhang\DataokeSdk\ServiceProvider::class
    ],

laravel >=5.5 自动注册

1.安装完毕后，config/services.php添加appkey等相关配置

'dataokeSdk' => [
    'appKey' => env('DATAOKE_SDK_APPKEY'),
    'appSecret' => env('DATAOKE_SDK_APPSECRET'),
    'serverUrl' => env('DATAOKE_SDK_SERVERURL')    
],

2. .env文件中新增配置项

DATAOKE_SDK_APPKEY= 你的appkey
DATAOKE_SDK_APPSECRET= 你的appSecret
DATAOKE_SDK_SERVERURL=https://openapi.dataoke.com

3. 配置完毕，新建控制器开始写业务代码

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use MaxZhang\DataokeSdk\Request\Govbus\CategoryGetRequest;
use MaxZhang\DataokeSdk\DefaultDataokeClient;

class CategoryGet extends Controller
{
    public function show(Request $request)
    {

        $req = new CategoryGetRequest();

        
        $resp =app('dataokeSdk')->execute($req);
        $reqJson = $req->getReqJson();
        print_r("请求报文:\n" . $reqJson);
        print_r("\n返回响应报文:\n" . $resp);
        $request->json($resp);
    }
}

如上，可以用两种方式来获取 MaxZhang\DataokeSdk\DefaultDataokeClient 实例：

方法注入

    public function show(DefaultDataokeClient $defaultDataokeClient) 
    {
        ...
        $response = $defaultDataokeClient->execute('$req');
    }

服务名访问

    public function show() 
    {
        ...
        $response =app('dataokeSdk')->execute($req);
    }

License

MIT Licence 2.0

maxzhang / dataoke-sdk

Maintainers

Details