← 返回下载中心

🚀 快速上手指南

Infilake OpenAPI Java SDK - 30秒快速开始

📦 文件清单

infilake-openapi-sdk-1.5.2.jar  ← SDK主文件 (78KB) ⭐ 推荐
jackson-databind-2.16.1.jar     ← JSON处理依赖
README.md                       ← 完整文档
QUICKSTART.md                   ← 本指南

⚡ 30秒快速开始

1复制JAR包到你的项目

cp infilake-openapi-sdk-1.5.2.jar /你的项目/libs/

2创建测试文件 QuickStart.java

import com.infilake.openapi.bidding.BiddingApiClient;
import com.infilake.openapi.bidding.model.*;
import com.infilake.openapi.bidding.model.base.*;
import com.infilake.openapi.bidding.exception.*;

public class QuickStart {
    public static void main(String[] args) {
        // 初始化采购平台API客户端
        BiddingApiClient client = new BiddingApiClient(
            "https://api.example.com",
            "your-access-key",
            "your-secret-key"
        );

        try {
            // 查询订单 - 返回类型化对象
            ApiResult<PageResult<Order>> orders = client.getOrderPage(1, 10, "approved", null, null, null, null);
            System.out.println("订单数量: " + orders.getData().getTotal());

            // 查询项目列表
            ApiResult<PageResult<Project>> projects = client.getProjectPage(1, 10, null, null, null);
            System.out.println("项目数量: " + projects.getData().getTotal());

        } catch (BiddingApiException e) {
            System.err.println("API错误 [" + e.getCode() + "]: " + e.getMessage());
        }
    }
}

3编译运行

Windows:

javac -cp "libs/infilake-openapi-sdk-1.5.2.jar;libs/*" QuickStart.java
java -cp "libs/infilake-openapi-sdk-1.5.2.jar;libs/*;." QuickStart

macOS/Linux:

javac -cp "libs/infilake-openapi-sdk-1.5.2.jar:libs/*" QuickStart.java
java -cp "libs/infilake-openapi-sdk-1.5.2.jar:libs/*:." QuickStart

💡 常用代码片段

查询订单

// 分页查询订单列表
String orders = client.getOrderPage(1, 10, "approved", null, null, null, null);

// 查询订单详情
String order = client.getOrderDetail("ORDER123");

// 查询订单履约信息
String fulfillment = client.getOrderFulfillment("FUL123");

// 查询物流信息
String express = client.getOrderExpress("FUL123");

查询项目

// 分页查询项目
String projects = client.getProjectPage(1, 10, null, null, "项目名称");

// 查询项目详情
String project = client.getProjectDetail(123);

创建采购申请

String applicationJson = "{" +
    "\"purchaseReason\": \"实验室耗材采购\"," +
    "\"expectedDeliveryTime\": \"2026-02-01\"," +
    "\"applicant\": \"zhangsan\"," +
    "\"organizationId\": 123," +
    "\"clientApplicationNo\": \"EXT-001\"," +
    "\"applicationLists\": [{" +
    "  \"projectId\": 1," +
    "  \"itemCode\": \"ITEM001\"," +
    "  \"approvedQuantity\": 100," +
    "  \"warehouseId\": 5" +
    "}]" +
"}";

String result = client.importPurchaseApplication(applicationJson);

物料管理

// 创建物料
String productJson = "{\"organizationId\": 123, \"productName\": \"试管\", ...}";
String createResult = client.createProduct(productJson);

// 更新物料
String updateResult = client.updateProduct("PROD-001", productJson);

// 删除物料
String deleteResult = client.deleteProduct("PROD-001");

结算单和发票

// 查询结算单
String settlements = client.getSettlementPage(1, 10, null, null, null);

// 下载发票
String invoiceUrl = client.downloadInvoice("SETTLE123");

// 查询发票信息
String invoiceInfo = client.queryInvoice("SETTLE123");

🎯 核心API列表

分类 方法数 主要功能
订单API 9 分页查询、详情、履约、物流、退货、客户端申请单号查询
项目API 2 分页查询、详情
采购申请API 4 导入、更新（支持对象参数）
物料API 6 创建、更新、删除（支持对象参数）
类别API 6 分页查询、创建、更新、删除
结算单API 3 分页查询、下载发票、查询发票
仓库API 1 仓库列表查询
用户档案API 1 获取用户档案

⚠️ 常见问题

Q: 认证失败怎么办?

A: 检查以下几点：

  1. Access Key 和 Secret Key 是否正确
  2. 请求路径是否与签名路径一致
  3. HTTP方法是否大写（GET不是get）
  4. 系统时间是否准确

Q: 如何调试?

A: 查看响应中的认证头：

ApiResponse response = client.get("/api/endpoint");
System.out.println("使用的时间戳: " + response.getAuthHeaders().get("X-Timestamp"));
System.out.println("使用的签名: " + response.getAuthHeaders().get("X-Authorization"));

Q: 超时设置

A:

client.setConnectTimeout(30000);  // 连接超时 30秒
client.setReadTimeout(30000);     // 读取超时 30秒

📖 完整文档

查看完整的 README 文档获取：

© 2025 Infilake OpenAPI · 版本 1.5.2 · 更新日期: 2026-01-27