SuperAPI AI 工具集

evernote-prod-checklist

部署与运维

查看项目

更新于 10-15 23:25

技能介绍

用途:这是一份 Evernote 集成的生产就绪检查清单,用于准备将 Evernote 集成部署到生产环境,或对既有生产部署进行审计。

主要内容按主题分节:

API 密钥与认证:需 Evernote 审核批准的生产 API 密钥;生产配置中 EVERNOTE_SANDBOX=false;consumer key 与 secret 存入密钥管理器而非环境文件;OAuth 回调使用 HTTPS;跟踪 edam_expires 令牌过期并测试刷新/重新授权流程。

安全:访问令牌静态加密(AES-256-GCM);OAuth 流程启用 CSRF 防护;凭证不入版本库;日志脱敏令牌与 PII;对用户内容做输入校验(ENML 清理);处理速率限制以防密钥被封。

速率限制与性能:对 RATE_LIMIT_REACHED 使用指数退避;调用间最小延迟 100-200ms;对 listNotebooks() 与 listTags() 做 5-10 分钟响应缓存;列表场景用 findNotesMetadata() 代替 findNotes();批量操作串行并加延迟。

监控告警:健康检查端点验证 API 连通性;跟踪调用量、延迟、错误率、速率限制;对限流、认证失败、高错误率告警;结构化日志带 correlation ID;配额用量在 75%、90% 阈值告警。

数据完整性:每次 createNote/updateNote 前校验 ENML;标题清洗(≤255 字符、无换行);标签名校验(≤100 字符、无逗号);校验资源哈希 MD5;跟踪并持久化同步状态 USN。

部署:多阶段构建生产镜像;设置 NODE_ENV=production;优雅关闭处理进行中的调用;文档化并测试回滚方案;部署后运行验证脚本。文中给出验证脚本示例:使用 curl 检查 $APP_URL/health 中 evernoteApi 为 connected、创建并删除测试笔记;命令原样保留。

常见错误与处理:生产中 INVALID_AUTH 多因用沙箱令牌访问生产端点,需核对 EVERNOTE_SANDBOX=false 与生产密钥一致;验证脚本失败则查日志并回滚;上线时限流可加启动延迟、逐步预热缓存;PERMISSION_DENIED 需联系 Evernote 开发者支持。

限制:资料未提供具体收费、价格或平台支持范围;版本升级见 evernote-upgrade-migration。