跳到正文
⁨NDDev Dev⁩,首页
社区
语言: 简体中文
显示
主题
动效

API 集成

NDDev 通过 API 将您的系统与外部服务对接,包括邮件与短信、即时通讯、地图、数据分析、Google 或 Apple 登录、文件存储和语言模型。例如,我们把阿拉木图市图书馆服务的应用接入了外部图书馆登记系统;该应用的用户数为 50 000,而不是计划中的 2 000。

适合谁?

面向数据存放在多个服务中并靠人工汇总的公司,以及需要把外部服务接入自有应用的产品团队。

  • 带文档的 API 服务
  • 队列、重试和调用日志
  • Webhook 签名校验
  • 源代码与流的说明

我们接入什么,以及如何保持连接

我们使用 Python 和 FastAPI 把集成写成独立服务;如果您已有后端,就写在后端里。需要立即响应的场景,我们用同步调用。数据量大、速度慢的交换走 Redis 或 RabbitMQ 队列。外部服务的 Webhook 会校验签名,并且只处理一次。

  • 邮件与短信:SendGrid、Mailgun、Amazon SES、Resend、Twilio
  • 即时通讯:Telegram、WhatsApp Business、Slack
  • 通过 Google、Apple、GitHub 和 Microsoft 登录,以及 SAML 与双因素验证
  • 数据分析:GA4、Mixpanel、Amplitude、PostHog
  • 地图:Google Maps、Mapbox、2GIS
  • 兼容 S3 的文件存储
  • 工作服务:Jira、Confluence、Notion、Linear
  • 语言模型,以及基于 LangGraph 的人工智能流水线

在阿拉木图图书馆系统中,我们遵守了一条规则,并认为它对任何集成都是正确的:同步时把未知值记为留空,由工作人员修正。即使外部系统不可用,读者的主路径也仍然可用。

如果服务没有 API,我们就另寻途径:定时导出、文件交换或中间服务。我们会在开工前说明所选方案及其限制。

集成的四个阶段

密钥和机密值存放在服务器的环境变量中,与代码分开。

  1. 数据流

    我们画出系统之间有哪些数据在流动、朝哪个方向、多久一次,以及每一侧由谁负责。

  2. API 核查

    我们阅读文档,用测试访问权限试调用,并记录该服务的限额和薄弱点。

  3. 开发数据交换

    我们编写服务时加入队列,重试间隔逐渐加长;外部服务发生故障时停止调用,并且记录每一次请求。

  4. 交付

    我们在生产环境启动数据交换,配置 Telegram 或邮件通知,并移交代码与数据流说明。

关于 API 集成的问题

我们怎样得知数据交换已经停止运行?

每一次调用都记入日志,失败的调用会自动重试;重试后仍未成功的,会通过邮件或 Telegram 发出通知。

服务限制请求次数。该怎么办?

我们把限额纳入项目:请求经由队列按允许的速率发送,很少变化的数据则做缓存。

您会把集成做进我们的后端吗?

如果您的后端允许改造,我们就按您团队的规范把集成嵌入后端。如果单独部署更合适,我们就在旁边放一个独立服务,由它通过 API 与您的系统通信。

可以把语言模型接到我们的系统上吗?

可以。我们把模型和基于 LangGraph 的人工智能流水线接入您的数据与服务。如果任务超出集成范围,则由我们的人工智能方向负责。

API 集成要多少钱?

起步价标在页面的费用区块中。服务更多、数据更多,以及双向交换,都会让工作量更大。我们会把准确价格和工期写入技术任务书,而编制这份技术任务书已包含在项目费用中。

$890 起

免费保修
8 天

所列为起步价格,仅供参考,不构成公开要约。最终价格在技术规格书中确定。

Integrations

请告知需要对接的服务

请发送 API 文档的链接,或说明哪些数据要送到哪里。回复中我们会给出数据交换示意图和价格。

我们将在 24 小时内回复

助手

正在加载助手…