羊腿Api 开发者文档 羊腿Api 开发者文档
首页
  • 入门

    • 简 介
    • 安 装
    • 快速开始
    • 返回响应码
  • 请求

    • 请求示例代码
  • API接口

    • 毒鸡汤
    • 获取IP信息归属地
    • 土味情话
    • 星座运势
    • 天气详细信息
    • 随机壁纸
    • 微博热搜实时榜单
    • 获取输入名称(测试连接)
  • 使用配置
开发者笔记
在线调试 (opens new window)
赞助
GitHub (opens new window)
首页
  • 入门

    • 简 介
    • 安 装
    • 快速开始
    • 返回响应码
  • 请求

    • 请求示例代码
  • API接口

    • 毒鸡汤
    • 获取IP信息归属地
    • 土味情话
    • 星座运势
    • 天气详细信息
    • 随机壁纸
    • 微博热搜实时榜单
    • 获取输入名称(测试连接)
  • 使用配置
开发者笔记
在线调试 (opens new window)
赞助
GitHub (opens new window)
  • 文档

    • 简 介
    • 安 装
    • 快速开始
      • 👌 新手需知
      • 📦 安 装
        • 🍊 Maven
        • 🍐 Gradle
        • ⚙️ 配置客户端
        • 1. 前往羊腿API 接口开放平台 获取开发者密钥对
        • 2. 初始化客户端QiApiClient对象
        • 3. 使用API服务
        • 4. 发起请求示例
      • 🐞 提供bug反馈或建议
    • 返回响应码
  • API接口

    • 获取输入名称
    • 毒鸡汤
    • 获取IP信息归属地
    • 土味情话
    • 星座运势
    • 天气详细信息
    • 随机壁纸
    • 微博热搜实时榜单
  • 请求

    • 请求代码示例
目录

快速开始

# 👌 新手需知

  1. java开发环境
  2. 熟悉 Spring Boot
  3. 熟悉 Maven

# 📦 安 装

# 🍊 Maven

在项目的pom.xml的dependencies中加入以下内容:(必选)

<dependency>
    <groupId>top.panyuwen/groupId>
    <artifactId>gigoapi-sdk</artifactId>
    <version>0.0.4</version>
</dependency>
1
2
3
4
5

# 🍐 Gradle

implementation group: 'top.panyuwen', name: 'gigoapi-sdk', version: '0.0.4'
1

提示 🔔️

JDK 8 +

# ⚙️ 配置客户端

# 1. 前往羊腿API 接口开放平台 (opens new window) 获取开发者密钥对

# 2. 初始化客户端QiApiClient对象

  • 方法 1 :主动实例化客户端

    String secretId = "你的 secretId";
    String secretKey = "你的 secretKey";
    GigotApiClient client = new GigotApiClient(secretId, secretKey);
    
    1
    2
    3
  • 方法 2 :通过配置文件注入对象

    • yml

      # 羊腿api开放平台
      gigot-api:
        client:
          secret-id: 你的secret-id
          secret-key: 你的secret-key
      
      1
      2
      3
      4
      5
    • properties

      gigot-api.client.secret-id=你的 secret-id
      gigot-api.client.secret-key=你的 secret-key
      
      1
      2

# 3. 使用API服务

    @Autowired
    private GigotApiClient gigotApiClient;
1
2

# 4. 发起请求示例

示例:随机毒鸡汤

  • 示例一 :通过配置文件 推荐👍
try {
    PoisonousChickenSoupResponse poisonousChickenSoup = gigotApiClient.getPoisonousChickenSoup();
    System.out.println("poisonousChickenSoup = " + poisonousChickenSoup);
} catch (GigotApiException e) {
  log.error(e.getMessage());
}
1
2
3
4
5
6
  • 示例二 :主动注入
try {
    GigotApiClient gigotApiClient = new GigotApiClient("你的 accessKey", "你的 secretKey");
    PoisonousChickenSoupResponse poisonousChickenSoup = gigotApiClient.getPoisonousChickenSoup();
    System.out.println("poisonousChickenSoup = " + poisonousChickenSoup);
} catch (GigotApiException e) {
    log.error(e.getMessage());
}
1
2
3
4
5
6
7

响应:sdk中已封装返回对象,即可例如:输出PoisonousChickenSoupResponse

PoisonousChickenSoupResponse(text=你的问题在于,读书不多,而想的太多。)
1

# 🐞 提供bug反馈或建议

提交问题反馈请说明正在使用的JDK版本、GIGOTAPI-SDK版本和相关依赖库版本。

  • GIGOTAPI-SDK Github Issue (opens new window)
  • GIGOTAPI-DOC Github Issue (opens new window)
帮助我们改善此页面! (opens new window)
上次更新: 2024/03/29, 18:47:19
安 装
返回响应码

← 安 装 返回响应码→

Theme by Vdoing | Copyright © 2024-2024 PYW | 渝ICP备2023001069号-1
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式