# shareApi

**Repository Path**: shmily8023/share-api

## Basic Information

- **Project Name**: shareApi
- **Description**: 111111111111
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-04
- **Last Updated**: 2026-07-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Distribution SDK

统一分销SDK，支持美团、饿了么、抖音、快手、淘宝、京东、拼多多、唯品会、蘑菇街、微信 大麦 淘票票 猫眼 票付通  等主流电商和本地生活平台。
票付通 sdk基本完成 正在分析完善 票付通的 下一步联调
对接个税
对接银企直连
实名认证接口 好几个元素
分佣规则配置接口
分佣计算接口
分佣明细接口
佣金结算接口
结算对账接口
企享云？

## 功能特性

- **统一接口**: 统一的API接口设计，易于使用
- **多平台支持**: 支持10+主流电商和本地生活平台
- **配置灵活**: 支持YAML配置文件加载
- **HTTP客户端**: 基于OkHttp的稳定HTTP请求
- **JSON解析**: 基于Gson的JSON解析

## 支持的平台

| 平台 | 所属|客户端类 | 主要功能                   |
|------|---------|------------------------|
| 美团..... | 美团|`MeituanClient` | 推广链接、商品搜索、订单查询、佣金查询    |
| 饿了么 |A里集团| `EleClient` | 推广链接、店铺搜索、订单查询         |
| 抖音 |字节跳动| `DouyinClient` | 推广链接、商品搜索、订单查询、佣金查询    |
| 快手 | 快手|`KuaishouClient` | 推广链接、商品搜索、订单查询、佣金查询    |
| 淘宝 |A里集团 |`TaobaoClient` | 推广链接、商品搜索、订单查询、佣金查询    |
| 京东 | 京东|`JingdongClient` | 推广链接、商品搜索、订单查询、佣金查询    |
| 拼多多 |拼多多| `PinduoduoClient` | 推广链接、商品搜索、订单查询、佣金查询    |
| 唯品会 | 唯品会|`VipshopClient` | 推广链接、商品搜索、订单查询、佣金查询    |
| 蘑菇街 | 蘑菇街|`MogujieClient` | 推广链接、商品搜索、订单查询、佣金查询    |
| 微信 |腾讯集团| `WechatClient` | Access Token、小程序码、订阅消息 |
| 大麦 | `DamaiClient` | 推广链接、商品搜索、订单查询、佣金查询    |
| 淘票票 |阿里集团| `TaopiaopiaoClient` | 推广链接、商品搜索、订单查询、佣金查询    |
| 猫眼 |美团| `MaoyanClient` | 推广链接、商品搜索、订单查询、佣金查询    |
| 票付通 |票付通| `TiketClient` | 推广链接、商品搜索、订单查询、佣金查询    |
| 优保联 |优保联| `TiketClient` | 推广链接、商品搜索、订单查询、佣金查询 初级直接分销 支付交给他 后期直接提升 预留接口   |
|滴滴加油 |小橘集团| `TiketClient` | 推广链接、商品搜索、订单查询、佣金查询 初级直接分销 支付交给他 后期直接提升 预留接口   |
|滴滴打车 |小橘集团| `TiketClient` | 推广链接、商品搜索、订单查询、佣金查询 初级直接分销 支付交给他 后期直接提升 预留接口   |
|花小猪|小橘集团| `TiketClient` | 推广链接、商品搜索、订单查询、佣金查询 初级直接分销 支付交给他 后期直接提升 预留接口   |
京东集团
淘宝集团
小桔集团
抖音集团
美团集团
拼多多集团

高德打车
淘宝 / 天猫购物券
淘宝 加油卡
京东快递
京东购物
京东的加油卡
京东的影视会员
滴滴网约车
小桔加油
小桔充电
滴滴代驾
滴滴共享出行
抖音团购
抖音会员
剪映会员
番茄小说会员
美团外卖
美团酒旅
美团打车、美团单车 / 电单车
猫眼电影
拼多多 多多金宝
拼多多影音会员
腾讯视频号
## 快速开始

### 1. 添加Maven依赖

```xml
<dependency>
    <groupId>com.share</groupId>
    <artifactId>distribution-sdk</artifactId>
    <version>1.0.0</version>
</dependency>
```

### 2. 创建配置文件

创建 `config.yaml` 配置文件：

```yaml
# 美团配置
meituan:
  app_key: "your_meituan_app_key"
  app_secret: "your_meituan_app_secret"
  pid: "your_meituan_pid"

# 淘宝配置
taobao:
  app_key: "your_taobao_app_key"
  app_secret: "your_taobao_app_secret"
  pid: "your_taobao_pid"
  adzone_id: "your_adzone_id"
```

### 3. 使用SDK

```java
import coma.share.sdk.DistributionSDK;

// 从配置文件加载
DistributionSDK sdk = DistributionSDK.fromConfig("config.yaml");

        // 获取各平台客户端
        MeituanClient meituan = sdk.meituan();
        TaobaoClient taobao = sdk.taobao();

        // 生成推广链接
        PromoLink link = meituan.generatePromoLink("123456", "your_pid");
System.out.

        println("推广链接: "+link.getLink());

        // 搜索商品
        List<Product> products = taobao.searchProducts("手机", 1, 10);
```

## API文档

### 生成推广链接

```java
PromoLink link = client.generatePromoLink("product_id", "pid");
String url = link.getLink();
String shortUrl = link.getShortLink();
String qrCodeUrl = link.getQrCodeUrl();
```

### 搜索商品

```java
List<Product> products = client.searchProducts("关键词", page, pageSize);
for (Product product : products) {
    System.out.println("商品: " + product.getTitle());
    System.out.println("价格: " + product.getPrice());
}
```

### 获取订单列表

```java
List<Order> orders = client.getOrders("2024-01-01", "2024-01-31", 1, 20);
for (Order order : orders) {
    System.out.println("订单号: " + order.getOrderId());
    System.out.println("金额: " + order.getOrderAmount());
}
```

### 获取佣金信息

```java
Commission commission = client.getCommission();
System.out.println("可提现: " + commission.getWithdrawableAmount());
```

## 目录结构

```
distribution-sdk/
├── pom.xml                          # Maven配置文件
├── README.md                         # 项目说明
├── config.yaml                       # 配置文件示例
├── examples/
│   └── Example.java                  # 使用示例
└── src/main/java/com/share/sdk/
    ├── DistributionSDK.java         # SDK统一入口
    ├── config/
    │   └── SDKConfig.java           # 配置类
    ├── client/
    │   ├── BaseClient.java          # 基础HTTP客户端
    │   ├── MeituanClient.java       # 美团客户端
    │   ├── EleClient.java           # 饿了么客户端
    │   ├── DouyinClient.java        # 抖音客户端
    │   ├── KuaishouClient.java      # 快手客户端
    │   ├── TaobaoClient.java        # 淘宝客户端
    │   ├── JingdongClient.java      # 京东客户端
    │   ├── PinduoduoClient.java     # 拼多多客户端
    │   ├── VipshopClient.java       # 唯品会客户端
    │   ├── MogujieClient.java       # 蘑菇街客户端
    │   └── WechatClient.java         # 微信客户端
    ├── model/
    │   └── ResponseModels.java       # 统一数据模型
    ├── exception/
    │   └── SDKException.java         # 异常类
    └── util/
        └── JsonUtils.java            # JSON工具类
```

## 异常处理

```java
try {
    PromoLink link = client.generatePromoLink("123456", "pid");
} catch (SDKException e) {
    System.err.println("错误码: " + e.getErrorCode());
    System.err.println("错误信息: " + e.getErrorMessage());
}
```

## 编译运行

```bash
# 编译项目
mvn clean compile

# 运行示例
mvn exec:java -Dexec.mainClass="com.share.sdk.examples.Example"
```

## License

MIT License