support use custom trace path

Author: JqRrt

CHANGELOG.md

@@ -5,6 +5,9 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.3] - 2026-02-24
+### Added
+- **Trace**: Support use custom trace path
 
 ## [0.1.2] - 2026-02-04
 ### Changed

cozeloop-core/pom.xml

@@ -8,7 +8,7 @@
     <parent>
         <groupId>com.coze</groupId>
         <artifactId>cozeloop-java</artifactId>
-        <version>0.1.2</version>
+        <version>0.1.3</version>
         <relativePath>../pom.xml</relativePath>
     </parent>
 

cozeloop-core/src/main/java/com/coze/loop/auth/JWTOAuthAuth.java

@@ -125,7 +125,7 @@ public String getToken() {
 
   @Override
   public String getType() {
-    return AUTH_TYPE;
+    return AUTH_TYPE + " ";
   }
 
   /** Check if token should be refreshed. */
@@ -162,7 +162,7 @@ private void refreshToken() {
       body.put("grant_type", GRANT_TYPE_JWT);
 
       Map<String, String> headers = new HashMap<>();
-      headers.put("Authorization", "Bearer " + jwt);
+      headers.put("Authorization", this.getType() + jwt);
 
       String responseJson = httpClient.post(baseUrl + TOKEN_PATH, body, headers);
       TokenResponse resp = JsonUtils.fromJson(responseJson, TokenResponse.class);

cozeloop-core/src/main/java/com/coze/loop/auth/TokenAuth.java

@@ -30,6 +30,6 @@ public String getToken() {
 
   @Override
   public String getType() {
-    return AUTH_TYPE;
+    return AUTH_TYPE + " ";
   }
 }

cozeloop-core/src/main/java/com/coze/loop/client/CozeLoopClientBuilder.java

@@ -34,6 +34,11 @@ private void loadByEnv() {
     if (serviceName != null) {
       this.config.setServiceName(serviceName);
     }
+    // Load trace path
+    String tracePath = System.getenv("COZELOOP_TRACE_PATH");
+    if (tracePath != null) {
+      this.config.setTracePath(tracePath);
+    }
     // Load auth token
     String token = System.getenv("COZELOOP_API_TOKEN");
     if (token != null) {
@@ -61,6 +66,12 @@ private void loadByProperties() {
       this.config.setServiceName(serviceName);
     }
 
+    // Load trace path
+    String tracePath = ConfigUtils.get("cozeloop.trace-path");
+    if (tracePath != null) {
+      this.config.setTracePath(tracePath);
+    }
+
     // Load auth token
     String token = ConfigUtils.get("cozeloop.auth.token");
     if (token != null) {
@@ -108,6 +119,17 @@ public CozeLoopClientBuilder baseUrl(String baseUrl) {
     return this;
   }
 
+  /**
+   * Set trace path (optional, default: "/v1/loop/opentelemetry/v1/traces").
+   *
+   * @param tracePath the trace path
+   * @return this builder
+   */
+  public CozeLoopClientBuilder tracePath(String tracePath) {
+    config.setTracePath(tracePath);
+    return this;
+  }
+
   /**
    * Set configuration (optional).
    *

cozeloop-core/src/main/java/com/coze/loop/config/CozeLoopConfig.java

@@ -6,9 +6,12 @@
 
 /** Main configuration for CozeLoop Client. */
 public class CozeLoopConfig {
+  private static final String DEFAULT_TRACE_PATH = "/v1/loop/opentelemetry/v1/traces";
+
   private String workspaceId = System.getenv("COZELOOP_WORKSPACE_ID");
   private String serviceName = "cozeloop-java-app";
   private String baseUrl = "https://api.coze.cn";
+  private String tracePath = DEFAULT_TRACE_PATH;
 
   private HttpConfig httpConfig;
   private CozeLoopTracerProvider.TraceConfig traceConfig;
@@ -45,6 +48,14 @@ public void setBaseUrl(String baseUrl) {
     this.baseUrl = baseUrl;
   }
 
+  public String getTracePath() {
+    return tracePath;
+  }
+
+  public void setTracePath(String tracePath) {
+    this.tracePath = tracePath;
+  }
+
   public HttpConfig getHttpConfig() {
     return httpConfig;
   }
@@ -71,7 +82,7 @@ public void setPromptCacheConfig(PromptCache.PromptCacheConfig promptCacheConfig
 
   /** Get span endpoint URL. */
   public String getSpanEndpoint() {
-    return baseUrl + "/v1/loop/opentelemetry/v1/traces";
+    return baseUrl + tracePath;
   }
 
   /** Get prompt endpoint URL for fetching prompts (mget). */
@@ -111,6 +122,11 @@ public Builder baseUrl(String baseUrl) {
       return this;
     }
 
+    public Builder tracePath(String tracePath) {
+      config.tracePath = tracePath;
+      return this;
+    }
+
     public Builder httpConfig(HttpConfig httpConfig) {
       config.httpConfig = httpConfig;
       return this;

cozeloop-core/src/main/java/com/coze/loop/http/AuthInterceptor.java

@@ -37,7 +37,7 @@ public Response intercept(Chain chain) throws IOException {
     Request.Builder builder =
         original
             .newBuilder()
-            .header("Authorization", authType + " " + token)
+            .header("Authorization", authType + token)
             .header("User-Agent", UserAgentUtils.getUserAgent())
             .header("X-Coze-Client-User-Agent", UserAgentUtils.getClientUserAgent());
 

cozeloop-core/src/main/java/com/coze/loop/internal/Constants.java

@@ -1,7 +1,7 @@
 package com.coze.loop.internal;
 
 public class Constants {
-  public static final String Version = "0.1.2";
+  public static final String Version = "0.1.3";
   public static final String TraceContextHeaderParent = "X-Cozeloop-Traceparent";
   public static final String TraceContextHeaderBaggage = "X-Cozeloop-Tracestate";
 }

cozeloop-core/src/main/java/com/coze/loop/trace/CozeLoopTracerProvider.java

@@ -104,7 +104,7 @@ private CozeLoopTracerProvider(
         () -> {
           Map<String, String> headers = new HashMap<>();
           headers.put("cozeloop-workspace-id", workspaceId);
-          headers.put("Authorization", "Bearer " + auth.getToken());
+          headers.put("Authorization", auth.getType() + auth.getToken());
           headers.put("User-Agent", UserAgentUtils.getUserAgent());
           headers.put("X-Coze-Client-User-Agent", UserAgentUtils.getClientUserAgent());
 

cozeloop-core/src/test/java/com/coze/loop/auth/TokenAuthTest.java

@@ -15,7 +15,7 @@ void testConstructorWithValidToken() {
     TokenAuth auth = new TokenAuth("test-token");
 
     assertThat(auth.getToken()).isEqualTo("test-token");
-    assertThat(auth.getType()).isEqualTo("Bearer");
+    assertThat(auth.getType()).isEqualTo("Bearer ");
   }
 
   @Test
@@ -63,6 +63,6 @@ void testGetToken() {
   @Test
   void testGetType() {
     TokenAuth auth = new TokenAuth("token");
-    assertThat(auth.getType()).isEqualTo("Bearer");
+    assertThat(auth.getType()).isEqualTo("Bearer ");
   }
 }