PHPackages                             tb07/jinritemai - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. tb07/jinritemai

ActiveLibrary

tb07/jinritemai
===============

工具型抖店开放平台SDK

018PHP

Since Feb 2Pushed 3y agoCompare

[ Source](https://github.com/tb07/jinritemai)[ Packagist](https://packagist.org/packages/tb07/jinritemai)[ RSS](/packages/tb07-jinritemai/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

 jinritemai
============

[](#-jinritemai-)

 工具型抖店开放平台SDK.

[![Build Status](https://camo.githubusercontent.com/67c3a06834980df1a95ffdff07149c48b867003faa98765b270312c3bf86a6b4/68747470733a2f2f7472617669732d63692e6f72672f694d6163746f6f6c2f6a696e726974656d61692e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/iMactool/jinritemai) [![StyleCI](https://camo.githubusercontent.com/1e685396275b576ebc3e4857c1cfa19964201d5e56aaf6b8a84c5321b9e4dc90/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3334333334303731392f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/343340719?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/5a4042c857fadefc5c92c5b8228611c42062545f75ed039bb614beb00a3ebd3f/68747470733a2f2f706f7365722e707567782e6f72672f696d6163746f6f6c2f6a696e726974656d61692f76)](//packagist.org/packages/imactool/jinritemai)[![Latest Unstable Version](https://camo.githubusercontent.com/ba0c18455d368f709a5b55ca3f92ee6e1bee79f5aee72da7e020cceb326b1ae2/68747470733a2f2f706f7365722e707567782e6f72672f696d6163746f6f6c2f6a696e726974656d61692f762f756e737461626c65)](//packagist.org/packages/imactool/jinritemai)[![Total Downloads](https://camo.githubusercontent.com/ba6e589652a30ad1477f983d209a127fc2833628096475959968e96b88998c1f/68747470733a2f2f706f7365722e707567782e6f72672f696d6163746f6f6c2f6a696e726974656d61692f646f776e6c6f616473)](//packagist.org/packages/imactool/jinritemai)[![License](https://camo.githubusercontent.com/dcf0311c31613edd7bad5f8f9bf0ca6a6a63d0f55c13342e47b3c7f8cdf2a1ab/68747470733a2f2f706f7365722e707567782e6f72672f696d6163746f6f6c2f6a696e726974656d61692f6c6963656e7365)](//packagist.org/packages/imactool/jinritemai)

环境需求
----

[](#环境需求)

```
PHP >= 7.1
PHP cURL 扩展
PHP OpenSSL 扩展
```

Installing
----------

[](#installing)

```
$ composer require imactool/jinritemai
```

Usage
-----

[](#usage)

> 具体可以看 example 示例代码 ，需要 `composer install `
>
> 其中 `example/index.php` 是针对 工具类型
>
> 而 `example/self_use.php` 则是针对的 自用型

### 授权相关

[](#授权相关)

```

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

use Imactool\Jinritemai\DouDianApp;

date_default_timezone_set('PRC');

$config = [
    'app_key'       => '你的appkey',
    'app_secret'    => '你的秘钥',
    'service_id'    => '你的服务id'
];

$servic = new DouDianApp($config);

```

### 工具型应用授权

[](#工具型应用授权)

```
#1、先获取 获取店铺授权URL
$authUrl = $servic->Auth->generateAuthUrl('state');

#2、拿到 URL code 之后，需要调用一次 requestAccessToken() 获取授权方授权信息 ;
# 店铺同意授权后，使用授权code，GET方式请求可获取access_token：
$code = 'URL code ';
$accessInfo = $servic->Auth->requestAccessToken($code);

```

### 自用型应用授权

[](#自用型应用授权)

```
$shopid = 23; //$shopid 为授权方店铺的ID shop_id
try {
    $accessInfo = $servic->Auth->getShopAccessToken($shopid);
    echo "调用结果：";
    var_dump($accessInfo);
}catch (Exception $exception){
    var_dump($exception);
}

```

目前工具已支持 `自用型应用授权` 和 `工具型应用授权` 两种授权类型。主要区别如下

店铺授权类型调用方式说明工具型应用授权1、`$authUrl = $servic->Auth->generateAuthUrl('state');`先获取 获取店铺授权URL工具型应用授权2、 `$code = 'URL code'; $accessInfo = $servic->Auth->requestAccessToken($code);`拿到 URL code 之后，需要调用一次 requestAccessToken() 获取授权方授权信息 ;店铺同意授权后，使用授权code，GET方式请求可获取access\_token：自用型应用授权1、`$shopid = 23;  $servic->Auth->getShopAccessToken($shopid)`自用型 - 获取access\_token### 获取授权方实例

[](#获取授权方实例)

> 这里 `自用型应用授权` 和 `工具型应用授权` 都是一样的用法

```
# 授权方已经把店铺授权给你的抖店开放平台了，接下来的代授权方实现业务只需一行代码即可获得授权方实例。
$shopid = 2222; //$shopid 为授权方店铺的ID shop_id
$refresh_token = '授权店铺token'; //$refresh_token 为授权方的 refresh_token，可通过 获取授权方授权信息 (`$servic->Auth->requestAccessToken($code)`) 接口获得。

$app = $servic->shopApp($shopid,$refresh_token);

#3.开始调用接口
$result = $shopAccount->getShopBrandList();

```

实现接口
----

[](#实现接口)

> 基于抖店开放平台的（工具型、自用型）SDK ，即本`SDK`是服务第三方开发者创建工具型应用（工具型应用必须上架，才能走授权流程） 以下列出来的接口都是已实现的 具体可以看 src/DouDianApp.php . $app 在本文档都是指的 `$servic->shopApp($shopid,$refresh_token);` 得到的实例 不需要自己刷新 refresh\_token SDK 内部会自动实现刷新。 当如果返回 token 过期 请参考[问题](#%E9%97%AE%E9%A2%98)

#### 店铺api `$app->Shop`

[](#店铺api--app-shop)

> 例如 `$app->Shop->getShopBrandList()`

- 获取店铺的已授权品牌列表 getShopBrandList()
- 获取店铺后台供商家发布商品的类目 getShopCategory()
- 售后地址列表接口 addRessList()

#### 商品api `$app->Shop`

[](#商品api-app-shop)

> `$app->Shop->addProduct($params)`

- 运费模板查询 getFreightTemplateList()
- 添加商品 addProduct()
- 商品发布 addProductV2()
- 删除商品 delProduct()
- 获取商品详情 getProduct()
- 编辑商品 editProduct()
- 编辑商品 editProductV2()
- 编辑商品限购 setProductBuyerLimit()
- 根据商品分类获取对应的属性列表 getPrdocutCateProperty()
- 获取商品列表 getProductList()
- 商品下架 setProductOffline()
- 商品上架 setProductOnline()
- 添加SKU addSku()
- 批量添加sku addAllSku()
- 获取商品sku详情 getSku()
- 修改sku编码 editSkuCode()
- 编辑sku价格 editSkuPrice()
- 修改sku对应的供应商编码ID editSupplierId()
- 获取商品sku列表 getSkuList()
- 修改sku库存 editSkuStock()
- 批量修改sku库存 editSkuStockBatch()
- 添加规格 addSpec()
- 删除规格 delSpec()
- 获取规格列表 getSpecList()
- 获取规格详情 getSpec()
- 获取商品列表新版 getProductListV2()

#### 订单 api `$app->Order`

[](#订单-api-app-order)

- 添加订单备注 addOrderRemark()
- 设置店铺设置地址变更审核 setAddressAppliedSwitch()
- 买家地址变更确认 addressConfirm()
- 买家主动修改收货地址 addressModify()
- 取消(货到付款)订单 cancelOrder()
- 获取订单详情 getOrder() 即将下线
- 获取订单详情 getOrderDetail() 即将下线
- 获取服务单列表 getServiceOrderList()
- 获取订单列 getOrderList() 即将下线
- 获取订单列 getOrderSearchList() 新
- 回复服务请求 replyService()
- 查询商家服务单详情请求 serviceDetail()
- 获取服务请求列表 serviceList()
- 确认货到付款订单 confirmOrder()
- 未支付订单改货款 updateOrderAmount()
- 未支付订单邮费修改 updateOrderPostAmount()

#### 物流 api `$app->Logistics`

[](#物流-api-app-logistics)

- 获取区列表 areaList()
- 获取市列表 cityList()
- 获取省列表 provinceList()
- 订单发货 sendOrderLogistics()
- 一个父订单可发多个物流包裹 sendOrderLogisticsMultiPack()
- 支持多个子订单发同一个物流包裹 sendOrderLogisticsSinglePack
- 获取快递公司列表 logisticsCompanyList()
- 修改发货物流 editLogisticsEdit()
- 修改包裹里的物流信息 editLogisticsByPack()

#### 售后退款 api `$app->AfterSale`

[](#售后退款-api--app-aftersale)

- 商家为订单添加售后备注 afterSaleAddOrderRemark()
- 商家确认处理换货申请 buyerExchange()
- 商家确认是否收到换货 buyerExchangeConfirm()
- 商家发货后仅退款申请 buyerRefund()
- 商家处理退货申请 buyerReturn()
- 商家确认是否收到退货 firmReceive()
- 根据子订单ID查询退款详情 refundProcessDetail()
- 卖家提交举证信息 submitEvidence()
- 商家延长售后收货时限 timeExtend()
- 货到付款订单上传退款凭证 uploadCompensation()
- 商家处理备货中退款申请 shopRefund()
- 售后单列表查询 refundListSearch()

#### 运费险API `$app->Insurance`

[](#运费险api-app-insurance)

- 获取运费险保单详情 insurance()

#### 库存 API `$app->Stock`

[](#库存-api-app-stock)

- 查询库存 getStockNum()
- 创建单个区域仓 createWarehouse()
- 批量创建区域仓 createBatchWarehouse()
- 编辑区域仓 editWarehouse()
- 查询区域仓 getWarehouse()
- 批量查询区域仓 getWarehouseList()
- 地址与区域仓解绑 removeAddrWarehouse()
- 绑定单个地址到区域仓 setAddrWarehouse()
- 批量绑定地址与区域仓 setBatchAddrWarehouse()
- 设置指定地址下的仓的优先级 setPriorityWarehouse()

#### 账单 API `$app->Bill`

[](#账单-api-app-bill)

- 仅自用型应用可使调用该接口 ，(非工具型)暂不支持
- 仅自用型应用可使调用该接口 查询订单账单明细 settle()
- 查询联盟订单明细 getOrderList()
- 查询账单明细 getSettleBillDetail()

#### 评价 API `$app->Commnet`

[](#评价-api-app-commnet)

- 获取店铺的评论列表 getCommentList()
- 评价回复 replyComment()

#### BIC质检API `$app->Btas`

[](#bic质检api-app-btas)

> BIC 质检 也包含，这接口变动和改变的太快了~

- 查询订单是否需要质检 getInspectionOrder()
- 商家调用发货 shipping()
- 图片质检送检 saveInspectionOnline()
- 获取订单的质检结果 getOrderInspectionResult()
- 商家送检调用 saveInspectionInfo()
- 获取可图片鉴定的品牌 listBrand()

---

- BIC 质检
- 下载bic订单码 `$app->Btas->downloadOrderCodeByShop()`
- bic流程订单商家发货接口 `$app->Btas->erpShopBindOrderCode()`

问题
--

[](#问题)

- [access\_token过期了该怎么办？](https://op.jinritemai.com/help/faq/43/207)

> 工具型应用： 可以使用refresh\_token，调接口，获得新的access\_token，详见工具型应用授权指南 如果refresh\_token也过期了，则只能让商家点击“使用”按钮，会打开应用使用地址，地址参数里会带上新的授权code。然后用新的code，重新调接口，获取新的access\_token。 商家如何使用应用

License
-------

[](#license)

MIT

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity23

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/bfef34ff4e277a69373fe1967006d8df05a68d704306b95a33c0ef477d6561d4?d=identicon)[tb07](/maintainers/tb07)

---

Top Contributors

[![iMactool](https://avatars.githubusercontent.com/u/3078413?v=4)](https://github.com/iMactool "iMactool (24 commits)")

### Embed Badge

![Health badge](/badges/tb07-jinritemai/health.svg)

```
[![Health](https://phpackages.com/badges/tb07-jinritemai/health.svg)](https://phpackages.com/packages/tb07-jinritemai)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)