QoderWake数字员工能力嵌入需匹配认证方式并符合API规范：一、OAuth 2.0客户端凭证授权，获取Bearer Token；二、API Key直连，使用qwk_开头48位密钥；三、Webhook回调，需签名验证；四、JSON-RPC 2.0调用任务接口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将QoderWake数字员工能力嵌入现有业务系统，但无法通过标准API完成调用或身份校验失败，则可能是由于认证方式不匹配或请求体结构不符合QoderWake API规范。以下是解决此问题的步骤：
一、配置OAuth 2.0客户端凭证授权
该方法适用于企业已有统一身份认证中心（如阿里云RAM或自建Keycloak），需通过标准OAuth流程获取访问令牌。QoderWake API要求所有请求携带Bearer Token，且Token必须由QoderWake授权服务器签发。
1、登录Qoder管理控制台，在「QoderWake > 开发者设置 > OAuth应用」中创建新应用，记录client_id与client_secret。
2、向https://api.qoder.com/v1/auth/token发送POST请求，请求体为application/x-www-form-urlencoded格式，包含grant_type=client_credentials、client_id和client_secret字段。
3、解析返回的JSON响应，提取access_token值，并在后续所有API请求头中添加Authorization: Bearer <strong><font color="green">此处填入获取到的token值</font></strong>。
二、使用API Key直连模式
该方法适用于测试环境或轻量级集成场景，无需维护OAuth生命周期，但需严格保护密钥安全。QoderWake为每个租户分配唯一X-QoderWake-Api-Key，该密钥具备限定权限范围与自动轮换策略。
1、进入QoderWake控制台「系统设置 > API密钥管理」，点击「生成新密钥」，选择权限范围为task.execute与event.read。
2、复制生成的密钥字符串，该字符串以qwk_开头，长度为48位。
3、在调用任意QoderWake API时，于HTTP请求头中添加X-QoderWake-Api-Key: <strong><font color="green">qwk_xxx...</font></strong>，并确保Content-Type设为application/json。
QoderWake Linux版是阿里推出的生产级数字员工系统，支持Linux环境部署。它作为7×24小时在线的AI员工，具备长期记忆与专业技能（如编程、运维），可自主响应代码审查、告警处理等事件。其核心采用“员工与工位分离”架构，并设置了严格的权限红线，确保持续进化的同时实现安全可控。
三、集成Webhook事件回调机制
该方法用于接收QoderWake执行任务后的状态变更通知，实现双向联动。QoderWake支持将任务完成、失败、超时等事件以POST方式推送到您指定的HTTPS端点，需提前注册并验证端点有效性。
1、在QoderWake控制台「集成 > Webhook设置」中填写目标URL，例如https://your-system.com/qoderwake/callback。
2、启用签名验证开关，系统将生成一个X-QoderWake-Signature密钥，用于对请求体进行HMAC-SHA256签名比对。
3、在您的服务端接收请求时，使用该密钥重新计算签名，并与请求头中的X-QoderWake-Signature比对，二者完全一致才可视为合法回调。
四、调用任务执行接口（JSON-RPC 2.0格式）
该方法用于主动触发QoderWake执行具体数字员工任务，如代码变更简报、故障诊断等。QoderWake API采用标准化JSON-RPC 2.0协议封装，所有方法均通过POST /v1/rpc统一入口调用。
1、构造请求体，确保包含jsonrpc（固定为"2.0"）、method（如"task.create"）、params（对象类型，含expert_type、input、timeout_seconds）及id（唯一请求标识）字段。
2、params.input中必须传入符合QoderWake Schema的输入结构，例如数字程序员角色要求repo_url、commit_hash与focus_files三项必填。
3、发送请求后，解析响应中的result.task_id，该ID可用于后续轮询任务状态或绑定Webhook事件。
