云原生平台API封装说明结构化提示词

角色定义

技术架构可视化设计师 —— 你的任务是以专业图示化语言，将云原生平台中API封装的完整流程转化为一张直观、层次分明、便于技术沟通的示意图。目标用户为开发人员、架构师或运维人员，他们需要快速理解API从原始接口到封装输出之间的数据流转、组件交互与安全控制关键节点。

适用场景

• 云原生平台技术方案文档中的API封装流程配图
• 微服务架构下API网关与后端服务的交互说明图
• 技术培训、内部知识库中关于API封装过程的逻辑示意
• 技术演讲幻灯片中作为架构概览页的核心视觉

核心提示词

直接可用的提示词方案（建议作为图像生成主输入）：

• 主体内容：云原生平台API封装完整流程示意图，从左到右展示：原始API接口 → API网关（含认证、限流、协议转换） → 封装层（数据格式化、错误处理、日志注入） → 输出标准化API。流程间用箭头连接，箭头上标注“请求”、“响应”、“过滤”等关键动作。
• 视觉元素：包含Kubernets容器图标、微服务模块（六边形或矩形）、API网关符号（闸门/路由标志）、JSON/Protobuf数据包图标。使用云原生色调：深蓝、青灰、亮蓝绿、白色高亮。
• 技术细节：在封装层旁边标注“鉴权”、“限流”、“熔断”、“日志”、“监控”等标签；在输出端显示统一API端点（如/api/v2/*）和响应格式示例。
• 格式要求：扁平化矢量风格，线条清晰，标注文字使用无衬线字体（如Roboto），整体布局平衡，留白合理。

风格方向

• 专业版技术图示：采用扁平化+轻微阴影的2.5D效果，避免过度丰富，强调信息层级。
• 色彩：主色#1A365D（深空蓝），辅色#00B5D8（青蓝）和#48BB78（浅绿用于成功状态），错误用#E53E3E（红）点缀。
• 字体：标题用粗体16-20px，注释用常规12-14px，全部英文或中文均可接受，但建议保持一致性。
• 画面氛围：整洁、现代、科技感，背景为浅灰或纯白网格线（可隐藏网格），突出组件本身。

构图建议

• 主布局：从左到右三段式流程结构。左侧为输入区（原始API），中间为处理区（网关+封装层），右侧为输出区（标准化API）。
• 层级：网关在上封装层在下，或者并列排列，用虚线框标注“API封装层”作为整体边界。
• 箭头：实线箭头表示请求流，虚线箭头表示响应流（或者双向箭头）。关键节点处可穿插小圆点或图标。
• 标注位置：箭头上方书写动作说明，组件内部或侧边用小型文字标签。
• 安全要素：可在网关入口处增加锁图标（TLS/HTTPS），封装层内增加日志图标、熔断图标，增强专业感。

细节强化

• 数据流转细节：在封装层内部展示“入参校验→协议转换→增强头部→错误标准化→日志输出”微步骤，用子箭头串联。
• 组件名称：使用行业标准术语，如“API Gateway (Kong / APISIX)”、“Service Mesh Sidecar”、“RESTful Output”。
• 状态指示：在输出端展示“200 OK”、“400 Bad Request”、“500 Internal Server Error”作为响应示例，并用色彩区分。
• 扩展要素：如果画面有余，可在底部添加时间轴或吞吐量曲线小图，体现封装后的性能提升。
• 一致性与不模糊：每个模块有唯一标签，避免重叠，确保非技术人员也能看懂主要流转。

使用建议

• 图像尺寸：推荐1920×1080（16:9）用于PPT或文档整页；如果用于插图，可按比例缩小至800×600。
• 导出格式：生成SVG或高清PNG（300dpi），方便后期编辑。
• 修改提示：如果希望强调“安全”，可在核心提示词中加入“在网关处增加WAF、OAuth2.0图标”；如果希望强调“可观测性”，可在封装层添加Prometheus/Grafana仪表盘图标。
• 多语言适应：建议保留英文术语以保持国际通用性，但中文标注更易被国内团队理解。可根据实际受众调整。
• 配套文字：搭配简短说明文字（如“封装后API具备统一认证、限流、监控能力”），帮助读者快速抓住要点。