API 与后端开发
我们交付的后端是怎样搭建的
我们从数据出发设计 API。先在 PostgreSQL 中建立模型并确定端点契约,再编写代码。版本写在地址里,例如 /api/v1/,列表以游标分页返回,错误以统一格式返回。当客户需要灵活查询或实时事件时,我们再加入 GraphQL 和 WebSocket。
- 数据模型与 PostgreSQL 迁移
- 具备版本、分页和统一错误格式的 REST API
- JWT、OAuth 2.0 认证,或通过邮件链接登录
- 服务器端的 RBAC 或 ABAC 权限
- 后台任务、队列与调度器
- 带签名校验的 Webhook
- 单元测试与集成测试
- Docker 镜像与部署 README
耗时操作放到后台:邮件、与 1C 交换数据、文件处理。任务和出站事件与数据一起保存在 PostgreSQL 中,因此事件恰在记录保存成功时出现。阿拉木图中心图书馆系统的后端便是如此搭建:FastAPI 服务,处理同步、图书、邮件和通知的 worker,以及一个定时任务调度器。
外部调用我们会做防护。我们校验 Webhook 签名,以幂等方式处理重复请求;合作方发生故障时,按逐渐加长的间隔重试,并通过 circuit breaker 暂时停止调用。每次调用都写入日志,密钥保存在环境变量中。
API 工作的三个阶段
契约
我们写清实体、端点、角色和错误。前端团队和移动团队立即按契约开工,与服务器开发并行推进。
实现与测试
我们编写服务、迁移和测试,将其部署到测试服务器,并向您的开发人员开放访问。
发布与移交
我们把 API 部署到带健康检查和日志的生产服务器,并移交代码仓库、文档和访问权限。
关于后端,大家会问什么
API 开发要多少钱?
API 的起步价写在价格部分。最终价格取决于实体和端点的数量、集成,以及对负载和安全的要求。API 契约明确之后,我们把最终价格和工期写入技术任务书。
为什么用 Python 和 FastAPI?
FastAPI 提供基于 Pydantic 的类型化模型,可通过 SQLAlchemy 2 异步访问数据库,端点描述也直接来自代码。对速度有特殊要求的服务,我们用 Go 或 Node.js 编写。
您能在我们现有的后端上继续开发吗?
可以。我们先阅读代码和数据库结构,运行测试,并说明哪些部分可用、风险在哪里。新端点与旧端点并列添加,再逐步把客户切换过去。
您如何测试 API?
单元测试检查业务逻辑,集成测试在真实的 PostgreSQL 上运行。面向外部使用方,我们用契约测试固定响应形式,做法与 Abonmarket 项目相同,变更在发布前就能看到。
API 承受得住负载吗?
上线前我们进行负载测试,把频繁请求缓存在 Redis 中,把繁重操作放到后台。服务在容器中运行,置于 Nginx 之后,并可随增长扩展。
交付时我们会得到什么?
代码仓库、API 文档、部署 README、服务器和数据库的访问权限,以及移交当时的备份。代码权利按约定移交。
$3,400 起
- 免费保修
- 30 天
所列为起步价格,仅供参考,不构成公开要约。最终价格在技术规格书中确定。
Web development
相关内容
请说明您的 API 应向谁提供哪些数据
请把数据结构、界面稿或集成说明发给我们。我们会提出 API 契约并报出价格。
我们将在 24 小时内回复