SuperAPI AI 工具集

juicebox-common-errors

编程与开发

查看项目

更新于 10-15 23:26

技能介绍

用途:该技能帮助排查和修复 Juicebox API 集成中的常见错误。Juicebox 提供 AI 驱动的人才搜索与分析,API 覆盖搜索查询、资料丰富化、数据集操作与配额管理。

主要能力:给出错误对照表,涵盖状态码 400(查询格式无效)、401(invalid_api_key)、403(quota_exceeded,表示配额耗尽而非权限问题)、404(资料未找到)、408(分析超时,超过 60 秒)、413(数据集过大,超过 50MB 或 10 万行)、422(CSV 表头不符合 schema,必填列为 name、title、company)、429(速率限制,超过每分钟 30 次请求)。还提供错误分类函数,将状态码归为 auth、rate_limit、validation、timeout 四类。

使用方式:API 密钥通过 Authorization: Bearer 头传递,按工作区限定。建议批量调用资料丰富化,并基于 Retry-After 响应头实现指数退避。批量操作可用数据集上传端点替代单条搜索。诊断连通性可用 curl -s -o /dev/null -w "%{http_code}" -H "Authorization: Bearer $JUICEBOX_API_KEY" https://api.juicebox.ai/v1/health。

适用场景:配额在批次中途耗尽的暂停与恢复、数据集上传被拒后的重新格式化、分析超时后缩小筛选范围(加入地点、职位、公司条件)、资料过期后重新搜索。

限制与前提:需要沙箱工作区、合成测试数据、已批准的诊断范围、密钥引用、来源/目标白名单、抑制控制与指定事件负责人。仅用合成输入复现失败;禁止导出真实记录、使用未批准的来源/目标或在命令与日志中写入明文凭据。诊断输出须排除请求载荷、联系人和凭据,并在批准窗口后删除暂存文件。具体价格与配额数值暂未提供。