支付 API 集成
把结账或开票流程接入支付服务商的 API,正确处理成功、失败和退款的 Webhook 通知。
大多数迪拜企业需要从零构建一个全新系统的频率,远不如需要让两个现有系统互相通信的频率高。这正是企业迪拜聘请 API 集成开发工程师要完成的工作:拿来银行、电商平台、物流服务商或政府服务已发布的接口,把它接入您的网站、应用或后台系统,让数据自动流动,而不必手动搬运。
这项工作比通用软件开发范围更窄,但难度并不低。迪拜聘请 API 集成开发工程师所投入的时间,大多花在阅读别人的文档、处理别人的错误代码,以及在对方毫无预警地改动某些内容时,依然保持集成正常运转。一位已经在几家不同服务商上真正交付过多次这类工作的候选人,远比只在课程里读过 REST API 的人更有价值。
这个角色连接什么
真实、已发布的 API,而不是内部实验。
把结账或开票流程接入支付服务商的 API,正确处理成功、失败和退款的 Webhook 通知。
通过电商平台的卖家 API,双向推送商品数据、库存和订单,这样商品目录就不必更新两遍。
让客户记录、发票或线索,在网站和您团队实际使用的 CRM 或会计软件之间保持同步。
通过快递商的 API 获取运费、生成面单和追踪更新,而不用员工再去单独查看一个门户网站。
让用户可以用已有身份登录,包括项目需要时对接 UAE PASS。
监听第三方 API 推送的事件,例如状态变化,并可靠地做出响应,而不是不停轮询。
重要能力
集成投入真实环境后才会显现的习惯。
| 技能或工具 | 合格表现是什么样 | 为什么重要 |
|---|---|---|
| 阅读 API 规范 | 能顺畅地依据 OpenAPI 文档或同类参考资料工作,而不是靠反复试错 | 能省下大量猜测的时间,也能避免调用已废弃的端点 |
| 身份验证方式 | 熟悉 API 密钥、OAuth2 和签名请求,知道如何安全存储密钥 | 不同服务商采用不同方案,有时甚至同时用不止一种 |
| 错误与重试处理 | 为超时构建带退避策略的重试机制,并能区分临时故障和永久性拒绝 | 第三方 API 会间歇性出故障,静默放弃的集成会丢失数据 |
| 速率限制与配额 | 阅读并遵守服务商公布的限制,而不是被封了才发现 | 账号被封会让集成完全停摆,有时长达数天 |
| 日志与监控 | 记录每一次进出的调用,这样出故障的集成可以依据记录诊断,而不是靠猜 | 没有日志的沉默集成,是最难排查的一类问题 |
OpenAPI Initiative 将其规范描述为一种与语言无关的方式,用来描述 REST API,让人和工具无需阅读底层代码就能理解它,能够直接依据这份描述工作,而不是看服务商的宣传页面的开发工程师,往往集成得更快、意外也更少。
合作方式
专属开发工程师适合有持续集成计划的企业,随着新工具投入使用不断新增或维护连接。定向项目适合一次界定清晰、有明确起止点的集成,例如一个支付网关或一条电商平台数据流。招聘支持适合希望直接把 API 集成开发工程师招入自己团队的企业,我们会协助撰写职位描述并执行技术评估。顾问咨询适合已经推进到一半却卡住的集成项目,一双有经验的眼睛可以在投入更多预算之前,找出真正出问题的地方。无论采取哪种方式,迪拜聘请 API 集成开发工程师的目标都是一样的:系统之间自动互相更新,无需员工手动搬运数据。
评估候选人
能把真实集成经验和纸上谈兵区分开的问题。
哪家服务商,过程中出了什么问题,又是怎么发现的。含糊的回答通常意味着实操经验有限。
问问当第三方超时、返回格式错误的响应或对账号限流时,他们的代码会怎么做,而不只是问顺利情况下的流程。
API 密钥和令牌绝不应该以明文形式出现在代码仓库中。候选人在这一点上应该有清晰、笃定的答案。
他们如何应对服务商停用旧版 API,以及他们是否会持续关注自己维护的集成上的弃用通知。
要有足够细节能事后诊断一次失败的调用,同时又不在日志本身中暴露敏感数据。
认证
这个角色更看重具体对接过哪些 API,而不是任何通用资质证书。
一些支付服务商、云平台和 CRM 厂商,为按其 API 开发的开发工程师设有自己的认证。如果项目围绕其中之一展开,可以问候选人是否持有该认证,并通过服务商自己的资质查询渠道核实,而不是只凭简历上的说法。
对大多数集成工作来说,没有哪一张证书是真正相关的。一个可运行的实例、对如何处理故障的清晰说明,以及熟悉阅读 OpenAPI 风格规范的能力,比一枚徽章更能说明问题。
阿联酋考量
迪拜项目中经常遇到的两个方面。
当一次集成在系统之间搬运客户或员工数据时,2021 年第 45 号联邦法令,即阿联酋联邦个人数据保护法,适用于这项处理,无论数据最初来自哪个系统,因此值得和负责统筹这项工作的人确认,同意和数据最小化在整个集成过程中是如何处理的。
如果项目需要通过 UAE PASS 这一国家数字身份登录,UAE PASS 发布了一份 OAuth2 网页集成指南,涵盖授权码流程、访问令牌和登出,称职的 API 集成开发工程师应该能直接照此实现。
本页隶属于我们的API 与集成分类,属于更大的迪拜招聘开发者板块的一部分,也是大多数想要迪拜聘请 API 集成开发工程师的企业应该从这里开始的地方。如果工作实际上是设计 API 本身,而不是接入别人的 API,我们的API 架构师页面更贴合需求;如果需求是不总以 API 为基础的更广泛集成,例如文件传输或消息队列,请参阅集成开发工程师。涉及众多企业级系统的项目,可能需要企业集成开发工程师,如果涉及具体平台,支付或 CRM 相关的集成有时更适合Salesforce 集成开发工程师或SAP 集成开发工程师页面。如果项目其实是完整的网站建设,而不是一次集成,我们的网站开发服务是更简单的起点。
直接解答
后端开发工程师大部分时间在编写某个系统内部的逻辑。API 集成开发工程师大部分时间花在边界处,把这个系统接入别人的 API,因此这份工作更依赖于准确读懂对方的文档,并妥善处理对方的故障。
可以,这在这个角色里很常见。同一个月内,一个项目可能同时涉及支付网关、物流服务商和会计软件,每一个都有自己的身份验证方式和各自的怪癖。
完全取决于第三方:一个文档完善、带沙盒环境的 API,几天内就能跑通,而一个文档糟糕,或者需要供应商人工审批的 API,无论开发工程师水平多高,时间线都会被拉长。我们会先妥善评估范围,再给出报价。
如果项目需要通过 UAE PASS 验证用户身份,或与某个公共部门的 API 交换数据,API 集成开发工程师会依据发布方自己的文档来开发,我们会在承诺时间线之前,先与您确认访问权限和沙盒环境的可用性。
大多数 API 服务商会对端点进行版本管理,并在停用旧版本前发出通知。这个角色的部分职责,就是留意贵司依赖的 API 上的这类通知,这样变更就不会在毫无预警的情况下影响您的系统。
资料来源
书面固定价格
已收到,我们正在为您撰写报价。
工作时间内您将在 45 分钟内收到。请查收确认邮件。