# tuangou-java

**Repository Path**: yunfeiwork/tuangou-java

## Basic Information

- **Project Name**: tuangou-java
- **Description**: 抖音美团团购券码核销接口SDK，支持抖音美团团购券查询、核销，为中小企业开发者提供稳定、高性能的团购验券API接口解决方案，加速您的开发进程，如果您对我们的SDK感兴趣，请点击下方「主页」联系我们，接收版本更新信息记得点个Star
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://wspace.yunfeiwork.com/apihub/index.html?channelCode=javasdk
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-11-30
- **Last Updated**: 2025-12-02

## Categories & Tags

**Categories**: ecommerce

**Tags**: None

## README

## 本地生活团购 Java SDK [在线文档](https://wspace.yunfeiwork.com/apihub/index.html?channelCode=javasdk)

### [聚合团购核销](https://wspace.yunfeiwork.com/apihub/index.html?channelCode=javasdk)`Java`开发工具包，支持包括美团、大众点评、抖音的团购券码核销、团购商品信息查询。

### 重要信息
1. 商务合作洽谈请联系微信`18201986514`（在微信里自行搜索并添加好友，请注明来意） 或点击[【联系作者】](https://wspace.yunfeiwork.com/apihub/index.html?channelCode=javasdk)
2. 新手重要提示：本项目仅是一个SDK开发工具包，未提供Web实现，建议使用 `maven` 或 `gradle` 引用本项目即可使用本SDK提供的各种功能
3. 新手或者Java开发新手提问或新开Issue提问前，请先阅读[【常见问题汇总】](https://gitee.com/yunfeiwork/tuangou-java/wikis/QA)，并确保已查阅过 [【抖音美团团购核销API接口文档】](https://gitee.com/yunfeiwork/tuangou-java/wikis/Home) ，避免浪费大家的宝贵时间；


### 其他说明
1. **阅读源码的同学请注意，本SDK为简化代码编译时加入了`lombok`支持，如果不了解`lombok`的话，请先学习下相关知识**
2. 如有新功能需求，发现BUG，或者由于官方接口调整导致的代码问题，可以直接在[【Issues】](https://gitee.com/yunfeiwork/yunfei-tuangou-java/issues)页提出issue，便于讨论追踪问题；
3. 目前本`SDK`最新版本要求的`JDK`最低版本是`8`，而其他更早的JDK版本则需要自己改造实现。

### 模块说明
- tuangou-java-common: SDK公共模块, 如：工具类、异常处理等
- tuangou-java-partner: 聚合团购各接口实现模块, 如：美团、大众点评、抖音查券、查团购商品信息、核销验券等

### Maven引用方式

#### settings.xml
找到`settings.xml`文件，配置如下
```xml
<!-- 请在 settings.xml 文件<servers></servers>中设置以下仓库的访问凭证，通常settings.xml在$HOME/.m2/文件目录下。-->
<server>
    <id>tuangou-java</id>
    <username>6775f438d497cd558d6307ba</username>
    <password>7x9I6tkB]mKv</password>
</server>

<!-- 在settings.xml文件<repositories></repositories>节点中加入对应的仓库使用地址；或将这个配置配在你当前项目的pom.xml文件中也可以-->
<repositories>
    <repository>
        <id>tuangou-java</id>
        <url>https://packages.aliyun.com/692c1367ccf3499544d9cf5a/maven/tuangou-java</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

<!-- 如遇到配置后报错或提示401 Unauthorized 请主动联系我方技术人员 -->
```
![输入图片说明](/static/img_1.png "屏幕截图")

#### pom.xml
```xml

<dependency>
    <groupId>com.yunfeiwork</groupId>
    <artifactId>tuangou-java-partner</artifactId>
    <version>1.0.B</version>
</dependency>

```
![输入图片说明](/static/img_2.png "屏幕截图")

**配置后可能会出现下载包不成功导致本地仓库有目录缓存的问题，可以尝试删除你们本地maven仓库 com/yunfeiwork 下的相关目录，然后重新 `reload all maven` 你的本地项目即可**

![输入图片说明](/static/img_3.png "屏幕截图")

### 调用案例
```java

// @Autowired
// private StringRedisTemplate stringRedisTemplate;

public static void main(String[] args) {
    PartnerServiceImpl partnerService = new PartnerServiceImpl();
    // 纯内存管理token
    PartnerDefaultConfigImpl config = new PartnerDefaultConfigImpl();
    config.setAppId("你的appId");
    config.setAppSecret("你的appSecret");

    // （推荐）如果你希望使用redis管理token，请使用如下代码，请注入StringRedisTemplate
    // RedisTemplateRedisOps redisOps = new RedisTemplateRedisOps(stringRedisTemplate);
    // PartnerRedisConfigImpl config = new PartnerRedisConfigImpl(redisOps, "tuangou_sdk");

    //String accessToken = partnerService.getAccessToken();
    //System.out.println(accessToken);

    PartnerBizService partnerBizService = partnerService.getPartnerBizService();

    // 查询余额
    Response<ApiBalanceResult> apiBalanceResponse = partnerBizService.apiBalance();
    System.out.println(JSON.toJSONString(apiBalanceResponse));

    // 绑定到店综合门店
    //Response<AppBindShopResult> appBindShopResultResponse = partnerBizService.bindMeituanShop(AppBindMeituanShop.ddzhShop("美团账号Id", "美团账号名称", "美团门店Id", "抖音门店Id", "门店名称", "门店地址", "城市名称"));
    //System.out.println(JSON.toJSONString(appBindShopResultResponse));

    // 绑定到店餐饮门店
    //Response<CouponInfoResult> couponInfoResultResponse = partnerBizService.queryMeituanCoupon("绑定门店成功后返回的opPoiId", "0103607253231");
    //System.out.println(JSON.toJSONString(couponInfoResultResponse));

    // 绑定抖音门店
    Response<AppBindShopResult> appBindShopResultResponse = partnerBizService.bindDouyinShop( "抖音账号ID", "抖音门店ID");
    //Response<AppBindShopResult> appBindShopResultResponse = partnerBizService.bindDouyinShop("绑定美团门店成功后返回的opPoiId", "抖音账号ID", "抖音门店ID");

    // 查门店信息
    //Response<List<OpPoiInfoResult>> poiInfoResponse = partnerBizService.poiInfoList(null, 1);
    //System.out.println(JSON.toJSONString(poiInfoResponse));

    // 查询美团团购产品
    Response<List<TuangouProductInfo>> listResponse = partnerBizService.queryMeituanTuangouProduct(1, "绑定门店成功后返回的opPoiId");
    System.out.println(JSON.toJSONString(listResponse));

    // 查询抖音团购产品
    Response<List<TuangouProductInfo>> tuangouProductResponse = partnerBizService.queryDouyinTuangouProduct("绑定门店成功后返回的opPoiId", null);
    System.out.println(JSON.toJSONString(tuangouProductResponse));

    // 查询团购券信息（自动区分是美团券还是抖音券）
    Response<CouponInfoResult> couponInfoResultResponse = partnerBizService.easyQueryCoupon("绑定门店成功后返回的opPoiId", "0103607253231");
    System.out.println(JSON.toJSONString(couponInfoResultResponse));

    // 查询美团团购券信息
    //Response<CouponInfoResult> couponInfoResultResponse = partnerBizService.queryMeituanCoupon("绑定门店成功后返回的opPoiId", "0103607253231");

    // 查询抖音团购券信息
    //Response<CouponInfoResult> couponInfoResultResponse = partnerBizService.queryDouyinCoupon("绑定门店成功后返回的opPoiId", "1075910001130098");
    //System.out.println(JSON.toJSONString(couponInfoResultResponse));
}
```

### 技术支持
![输入图片说明](https://foruda.gitee.com/images/1742530950212709239/695f98b7_15605968.png "屏幕截图")
- 只负责技术支持，咨询接口调用费用，请加商务的企业微信
- **问问题请携带提供给您的 `appId` 接口返回的 `tid` 等请求参数以及问题截图**
- **工作时间：9:30~18:30 ( 周一至周五)**

### 商务合作请扫码添加下方二维码
![输入图片说明](https://foruda.gitee.com/images/1742530810715595208/707a4c19_15605968.png "屏幕截图")