本文探讨了从 Rap 迁移至 ShowDoc 的接口文档编写设计，分析了两者在 JSON 导入功能及参数层级展示上的差异。鉴于 ShowDoc 默认模板仅支持一级参数且无 JSON 导入功能，文章排除了京东文档中高难度的合并单元格方案，转而定制了支持多级参数的互动运营 API 接口模板，最终验证其显示效果符合预期，解决了多级参数的展示需求。
在 Rap 工具的使用中发现某接口文档的字号显示异常小于其他文档。经排查分析，定位原因为数据结构定义中的 object 标记丢失，随后决定将数据类型描述由 array 修改为 array。修改操作完成后，文档字号显示恢复正常，符合预期效果，成功解决了字号不一致的问题。
👨💻 个人品牌
王世强｜技术实践者 · 独立博客作者
15+ 年 Web 与系统实践经验，持续关注网站基础设施、系统优化、AI 工具与自动化。
持续运营技术博客 10+ 年，累计发布 1000+ 篇原创技术文章。
长期建设个人项目，也欢迎合适的技术交流、咨询与合作。
.env (14) 404 (14) add (16) AI 翻译 (36) Array (19) A Tour of Go (78) CentOS (23) ChatGPT (31) ChatGPT Plus (18) chrome (19) Cloudflare (40) Codex (28) composer (42) composer.json (22) composer update (14) console (16) Container (25) curl (16) delete (31) Docker (33) Dockerfile (15) EdgeOne (35) environment variable (19) error (24) file (15) filter (20) Git (28) GitHub (23) Gitlab (15) GLM-5.2 (27) Go (85) go-tour-i18n (16) Google AdSense (30) Go 文档 (18) Go 语言 (24) GraphQL (24) GraphQL API (14) Gutenberg (36) http (21) https (23) Interface (19) json (24) Laravel (37) Laravel 6 (55) Laravel 9 (25) Lighthouse (17) Lighthouse 5 (14) Linux (22) Module (17) MySQL (78) MySQL 5.7 (22) Nginx (63) normalize.css (28) OKX (15) OneinStack (23) PHP (68) php-fpm (21) php.ini (24) PHP 7.1.12 (22) PHP 7.4 (26) phpmyadmin (15) PhpStorm (24) Polylang (59) postman (18) Query (17) queue (16) Rancher (24) Redis (53) RESTful (27) RESTful API (23) SEO (14) Shopify (19) SlyTranslate (22) SQL (24) String (14) TortoiseGit (14) Twenty Twenty-Five (20) Ubuntu (43) update (20) VPN (17) W3 Total Cache (41) Windows 10 (46) WireGuard (29) WordPress (136) WPCode (23) Wstunnel (16) Yii (40) Yii 2 (70) Yii 2.0 (51) ZgoCloud (14) 国际化 (17) 多语言翻译 (51) 开源项目 (16) 技术博客 (15) 故障排查 (20) 数据库迁移 (16) 本地化 (22) 浏览器 (14) 阿里云 (20) 页面缓存 (14)
