yc-runtime-sdk（Java）

天幕动态 API + 自定义 API Java 11+ 客户端。

完整说明（鉴权、示例、排错）：../使用文档.md

安装

详细步骤见 使用文档 §3.2。

1. 安装到本机 Maven 仓库（必须先做）

cd rely-ons/yc-runtime-sdk-java
mvn install -DskipTests

2. 业务 pom.xml 添加依赖

<dependency>
  <groupId>team.dream.yc</groupId>
  <artifactId>yc-runtime-sdk</artifactId>
  <version>1.0.0</version>
</dependency>

3. 业务项目编译

mvn compile

公开发布：mvn clean deploy -Prelease。未发布前须先 mvn install。

环境变量

与 Node 包一致：

export YC_BASE_URL=http://localhost:8081/yc
export YC_PROJECT_ID=你的项目ID
export YC_ACCESS_KEY=ycdk_xxxxxxxx
# 本地试调
export YC_INVOKE_SKIP_AUTH=1

示例

import team.dream.yc.runtime.YcRuntimeClient;

import java.util.Map;

public class Demo {
    public static void main(String[] args) throws Exception {
        YcRuntimeClient yc = YcRuntimeClient.fromEnv();

        Map<String, Object> list = yc.dynamicList("products", Map.of(
                "currentPage", 1,
                "pageSize", 10
        ));

        Object detail = yc.dynamicGet("products", 1);

        Object custom = yc.customInvoke("order_summary", Map.of("userId", 1));
    }
}

显式配置：

YcRuntimeClient yc = YcRuntimeClient.create(
        "http://localhost:8081/yc",
        "projectId",
        "ycdk_..."
);

方法

方法	说明
dynamicList(modelKey, body)	POST 分页列表
dynamicGet(modelKey, id)	GET 单条
dynamicCreate / dynamicUpdate / dynamicDelete	增删改
dynamicFetch(modelKey, suffix, method, body, userJwt)	通用调用
customInvoke(apiKey, body)	POST 自定义 API

动态 API 若为 PROJECT_JWT，可在 YcRuntimeConfig.userJwt(...) 或 dynamicFetch 的 userJwt 参数传入业务 JWT。