Loongship Data

Appearance

请求选项与原生返回 ​

除了 signal 以外，每一个接口调用的第二个参数（options）还允许你覆盖一些底层配置。

覆盖超时时间和请求头 ​

比如，你的全局设置了 15 秒超时，但针对某个可能非常耗时的“大范围区域搜索”接口，你可以单独把它放宽到 30 秒：

typescript
const data = await client.area.list(
  {}, 
  { 
    timeout: 30000, 
    headers: { 'X-Custom-Flag': '1' } 
  }
);

获取原生响应 (Raw) ​

默认情况下，SDK 帮你屏蔽了上游复杂的包裹格式，直接把实际的业务数据（如数组列表）赋值给了返回值。 但如果你遇到极端情况，必须查阅它原本的 HTTP 包裹（如额外的元数据），你可以开启 raw: true：

typescript
const response = await client.ship.search({ kw: 'COSCO' }, { raw: true });

// 开启 raw: true 后，你的返回值不再仅仅是数据体
console.log(response.code);    // 0
console.log(response.message); // "success"
console.log(response.data);    // 这个才是你原本默认拿到的数据数组
console.log(response.raw);     // ⭐️ 这里装载了上游一字不差返回的原始 JSON