SuperAPI AI 工具集

framework

编程与开发

查看项目

更新于 10-15 20:28

技能介绍

用途:该仓库将领域逻辑(lib/marketplace/**)与 lib/core/ 中的小型 HTTP 框架分离,本技能用于修改传输层行为。

主要能力:contentstackHTTPClient.js 基于 endpoint 或 protocol://hostname:port 加 basePath 构建 axios 实例;默认 timeout 为 30000,retryOnError 为 true,retryCondition 对 429 重试(可覆盖);若配置中存在 apiKey / accessToken 则映射为请求头;使用 Qs 自定义 paramsSerializer,并以 encodeURIComponent 嵌套 JSON 查询;为实例挂载 ConcurrencyQueue;日志默认使用 messageHandler.js 的 httpLogHandler。concurrency-queue.js 限制并行在途请求数(maxRequests 来自客户端参数),改动会影响共享同一 HTTP 实例的所有 API 模块。messageHandler.js 集中管理 HTTP 日志与遥测钩子,需保证在浏览器与 Node 打包环境中安全。

使用方式:修改重试/退避策略、超时或序列化时,优先在 client() 上扩展现有选项,而非在 marketplace 模块中单独调用 axios;新增全局请求头行为涉及 contentstack.js,底层细节可能还需改 contentstackHTTPClient.js。

测试:行为变更应由 test/unit/ContentstackHTTPClient-test.js 与 concurrency-Queue-test.js 覆盖,尽量使用 mock 而非真实 HTTP。

限制:资料未提供安装命令、版本要求、收费信息及具体配置示例。