openapi

FungLeo16 小时前
golang·node.js·go·openapi·契约测试·成为全栈
成为全栈·Go 后端篇·重写之前先锁基线:契约、Node 版本与行为清单重写同一套后端,第一步不是创建 Go 项目,而是搞清楚“同一套”究竟指什么。本文代码快照:Go 后端提交 ceac4e0;API 契约 1.12.0,SHA-256 为 7b252c7ca701b45fdfd2a1e9dc7650085ff36e4ee9644265ad3fb6c485a5e030;Node 对照为 node-backend-v1.0.4,提交 7effc0276ffdf2fbd8183ec2e60d544ed8998bec。
記億揺晃着的那天12 天前
maven·架构设计·sdk开发·openapi·amazon ads api
Amazon Ads API 自建 SDK 架构升级实战:从手工生成 JAR 到可追溯构建体系导读:很多团队在对接 Amazon Ads API 时,通常用 OpenAPI Generator 手工生成几个客户端 JAR 扔进私库完事。但在实际维护中,模型字段冲突、端点更新约束、版本无法追溯与构建环境依赖等问题会接踵而至。本文复盘一次真实的 SDK 架构重构:如何把官方 OpenAPI 规范、协议适配、可追溯 Maven 构建与上游更新检测整合为一套工程化体系。
hey you~1 个月前
向量数据库·openapi·接口开发·幂等设计·云客服机器人·知识库批量导入·批量导入api
云客服机器人知识库批量导入,接口开发实操方案云客服机器人知识库批量导入的接口开发,核心是设计一套支持批量提交、分片上传、异步处理、状态查询、失败重试、幂等校验和向量化索引更新的 API 体系。常见方案采用 RESTful API + 消息队列 + 异步 Worker 架构,客户端将知识条目按批次或分片提交,服务端校验后写入任务表,由 Worker 完成解析、切分、向量化和向量数据库写入,最后通过回调或轮询返回导入结果。本文给出 OpenAPI 规范、数据格式、数据库设计、异步任务、幂等与重试、向量化流程、多语言 SDK 示例、压测数据、成本模型和故
FungLeo2 个月前
node.js·openapi·成为全栈·接口文档自动化
成为全栈·Node 后端篇·接口文档自动化:让 OpenAPI 与代码不脱节新人入职第一天,照着 Swagger 调接口,结果调出一个 500。去问后端,后端说"这个字段上周就改了,文档没顾上"。这类事的根因不是谁偷懒,而是文档和代码本来就是两份东西——只要存在两份,它们迟早会漂移。
DsirNg2 个月前
ci/cd·mock·openapi·契约测试·接口契约·前后端协作·pact
别把联调当验收:用可执行契约管住接口变更前后端并行时,最常见的误解是:前端有 Mock、后端有接口文档,等接口写完再联调即可。问题在于,Mock 只能让前端继续开发,接口文档只能表达约定;二者都不能自动证明真实服务是否兑现了约定。于是,一个看似顺畅的并行流程,往往会在联调阶段集中暴露问题:
带刺的坐椅4 个月前
java·ai·llm·agent·solon·restapi·openapi
把 OpenAPI 接入 Agent Harness:零代码让 Agent 听懂你的 REST API在过去两年里,我和团队接手了好几个「上了年纪」的 Java 项目。这些系统有一个共同特征:业务逻辑完整,API 齐全,Swagger 文档也写得规规矩矩,但前端换了一波人,文档却没人维护了。新来的同事要查一个订单接口,得翻好几个 YAML 文件,再对着代码比对字段名。
MageGojo5 个月前
网络安全·openapi·ip定位·ip查询api·ip归属地接口
IP归属地查询API实战指南:快速获取IP地址定位、运营商与风险信息在互联网应用开发过程中,IP地址是识别用户来源的重要基础数据。无论是用户注册、访问统计、广告投放、风控系统还是网络安全分析,都离不开IP归属地查询能力。
曲幽7 个月前
python·fastapi·web·swagger·openapi·scalar·docs
FastAPI自动生成的API文档太丑?我花了一晚上把它改成了客户愿意付费的样子你是不是也遇到过这种情况——后端接口写得飞起,FastAPI自动蹦出个 /docs 地址,你兴冲冲地把链接发给老板或者客户看,结果对面来了一句:“就这?这红配绿的页面,看着像内部测试工具啊,能拿给甲方演示吗?”
曲幽7 个月前
python·typescript·vue·fastapi·web·swagger·openapi·codegen
告别手写 API 胶水代码:FastAPI 与 Vue 的“契约自动机” OpenAPI 实战是不是每次前端联调,都觉得自己像个没有感情的“胶水工”?对着 Swagger 文档,把一个个接口名敲进 axios 里,再把返回值结构小心翼翼地定义成 TypeScript 类型。稍微一个字段名对不上(比如后端把 userId 改成了 userID ),页面就崩得让你怀疑人生。🎯
❀͜͡傀儡师7 个月前
openapi·ollama·new-api
NAS部署New-API本地Ollama秒变公网OpenAI接口核心目标:将本地Ollama模型和各类云端API整合为一个统一的、支持公网访问的OpenAI格式接口。
ai_coder_ai7 个月前
autojs·openapi·自动化脚本·冰狐智能辅助·easyclick
如何在自己的后台服务中通过open api集成自动化脚本的后台服务?在自动化脚本开发场景中,有时候我需要进行二次开发将平台后端服务集成到自己的后台服务中。冰狐智能辅助Open API 提供设备管理、用户体系、脚本调度、卡密授权、微服务扩展等后端能力,标准 HTTP 接口、统一 JSON 返回、完整权限控制,可无侵入对接自有后端,复用冰狐核心能力而不重构现有系统。本文从零讲解集成流程、关键接口、安全实践,并提供可直接运行的 Demo 源码。
小于开放平台API7 个月前
openapi·抖店api·电商接口·小于科技·零门槛
【抖音小店】售后订单列表接口:一键拉取退货退款订单,售后处理快人一步做电商的都知道,售后处理是最耗时耗力的环节。用户申请退款/退货,商家需要及时处理:审核申请、等待退货、验收退款……任何一个环节延误,都可能导致客诉升级甚至平台罚款。而开发一套自动化的售后管理系统,第一步就是把店铺的售后订单列表拉下来。
hhzz8 个月前
阿里云·云计算·openapi
阿里云的OpenAPI来操作云资源⚡⚡⚡ 新年新文⚡⚡⚡OpenAPI使用Http风格的接口,只要能发送网络请求的编程语言,甚至使用我们电脑或者手机中的浏览器都可以使用OpenAPI。除此之外针对我们常用的一些编程语言例如C++、JAVA、Python、Go、PHP、Node.js、.NET等阿里云都提供了对应的SDK,通过阿里云SDK调用OpenAPI会更加的容易。
大千AI助手10 个月前
人工智能·python·机器学习·openai·代码生成·openapi·大千ai助手
基于OpenAPI生成的 SDK 的工业级和消费级概念区别本文由「大千AI助手」原创发布,专注用真话讲AI,回归技术本质。拒绝神话或妖魔化。搜索「大千AI助手」关注我,一起撕掉过度包装,学习真实的AI技术!
闲人编程1 年前
运维·自动化·json·swagger·schema·openapi·codecapsule
OpenAPI/Swagger规范与API文档自动化『宝藏代码胶囊开张啦!』—— 我的 CodeCapsule 来咯!✨写代码不再头疼!我的新站点 CodeCapsule 主打一个 “白菜价”+“量身定制”!无论是卡脖子的毕设/课设/文献复现,需要灵光一现的算法改进,还是想给项目加个“外挂”,这里都有便宜又好用的代码方案等你发现!低成本,高适配,助你轻松通关!速来围观 👉 CodeCapsule官网
jthou@hotmail.com1 年前
ai编程·openapi
OpenAPI 规范技术指南本文档介绍 OpenAPI 规范(OpenAPI Specification,OAS) 的核心价值、在本项目中的应用实践,以及如何通过 OpenAPI 契约驱动团队高效协作。
mumu1307梦1 年前
java·spring boot·netty·超时·timeout·openapi·springai
SpringAI 实战:解决 Netty 超时问题,优化 OpenAiApi 配置在使用 SpringAI 对接 OpenAI 等大模型接口时,很多开发者会遇到一个常见问题:接口调用过程中突然抛出 Netty 超时异常。这一问题往往与默认配置的超时时间不匹配实际业务场景有关,今天就带大家从问题分析到解决方案,完整搞定 SpringAI 的超时配置优化。
IT之家1 年前
swagger·openapi·离线文档
swagger文档生成html静态文档现在基于OpenApi开发的接口,可以生成swagger,开启swagger UI使用起来非常方便,由于需要对外开放接口,将swagger暴露还是不太方便,需要生成静态的html文档,可以让第三方对接的开发人员可以查看文档。
小王子10241 年前
django·swagger·openapi
Django集成Swagger全指南:两种实用方案详解在前后端分离开发中,API 文档的重要性不言而喻。Swagger(现更名为 OpenAPI)作为主流的 API 文档生成工具,能自动生成交互式文档,极大提升开发效率。本文将介绍两种在 Django 项目中集成 Swagger 的实用方案,帮助开发者快速搭建完善的 API 文档系统。
小王子10241 年前
django·swagger·openapi
Django集成Swagger全指南:两种实现方案详解在前后端分离开发中,API 文档的重要性不言而喻。Swagger(现更名为 OpenAPI)作为主流的 API 文档生成工具,能自动生成交互式文档,极大提升开发效率。本文将介绍两种在 Django 项目中集成 Swagger 的实用方案,帮助开发者快速搭建完善的 API 文档系统。