由 dawei 无障碍网站不是附加功能，而是基础责任。API开发员需从设计源头嵌入可访问性思维，确保数据层与交互层均符合WCAG 2.1 AA标准。
接口响应结构必须语义清晰。避免仅用数字状态码传递错误信息，如400应附带描述性message字段，并提供错误类型标识（如“invalid_email”）。所有文本内容默认使用UTF-8编码，日期、数字等字段需明确格式说明（ISO 8601、RFC 3339），便于屏幕阅读器准确解析。
数据字段命名需直白可读。避免缩写或内部代号，例如用full_name代替fn，用is_subscribed代替sub_flg。布尔字段应使用肯定式命名（is_disabled优于disabled），并统一返回true/false而非1/0或字符串。
分页与加载逻辑需支持辅助技术导航。接口须提供total_count、next_url、prev_url等元字段；当无更多数据时，next_url返回null而非空字符串。动态加载内容需在响应头中包含X-Content-Accessible: true，并在JSON中提供loaded_at时间戳，供前端触发aria-live区域更新。
身份验证与表单提交必须兼容替代输入方式。登录接口需支持通过access_token或session_id等多种认证方式，不强制依赖图形验证码；表单校验错误须在响应体中以数组形式返回每个字段的详细错误（含field、code、message），而非聚合提示。
文档即无障碍第一界面。OpenAPI 3.0规范中，每个端点应填写summary与description，参数需标注required及可访问性影响（如“此字段用于生成屏幕阅读器标签”）。示例值应覆盖真实场景，包含中文、emoji及长文本，验证多语言渲染兼容性。
测试不能只靠工具。除使用axe-core API扫描、Lighthouse CI集成外，需手动验证关键流：用NVDA+Chrome测试错误提示朗读完整性；关闭CSS后检查JSON响应是否仍具逻辑层次；模拟色盲模式查看错误状态码颜色对比度是否达标（≥4.5:1）。
AI渲染的图片,仅供参考
无障碍是持续演进过程。每次API变更后，同步更新可访问性声明（Accessibility Statement），记录支持的辅助技术版本范围与已知限制，并设立专用反馈渠道接收残障用户真实用例。