SuperAPI AI 工具集

navan-sdk-patterns

编程与开发

查看项目

更新于 10-15 23:27

技能介绍

用途:为租户实际集成契约设计应用自有的 Navan 适配器,适用于封装 Booking API、Expense API、SFTP 或直接文件交付。流程在采取任何线上操作前先产出可审计的决策或产物。

主要能力:清点已启用的操作或文件契约并记录其修订版本;定义与传输无关的输入、结果、分页和错误类型;在单一边界实现认证、超时、大小限制和脱敏遥测;将原始标识符保留为不透明字符串,金额需带明确币种;为成功、空数据、分页、拒绝、限流和漂移添加夹具测试;写操作仅以独立方法暴露,并带幂等性和审批要求。

使用方式:前提是能访问所选租户当前的 Navan Help Center 和已签约集成文档,有具名业务负责人和数据负责人,以及去除密钥和旅客数据的非生产证据集。不要假定存在公共 SDK、基础 URL、分页模型或错误信封;在边界保留厂商负载,再映射为有版本的应用类型。凭据通过密钥提供方回调或文件传输凭据引用传入,不写入字面密钥,并将凭据、租户身份和主机允许列表绑定。使用 Read、Glob、Grep 检查文档、模式、配置、代码、夹具和证据;Write 和 Edit 仅用于已批准的仓库产物。

适用场景:旅行与费用流程中需要对接 Navan 契约的应用侧适配工作。

限制:仅调用本身不授权网络访问、凭据、旅客或费用数据、预订、支付、政策或身份变更、文件传输、部署或删除;读取文档和夹具是本地操作,而实时调用、密钥、添加包、生成客户端、文件传输和状态变更需要明确批准。未知字段应保留或隔离,不静默丢弃;不要仅凭状态猜测可重试性,应遵循当前租户契约;在建立连接前拒绝租户/主机不匹配。先离线测试,再用一次单独批准的非生产读取比较捕获模式与现实,记录预期与观察结果,包括失败关闭行为。其他具体配置、价格、平台支持与限制资料暂未提供。