支付宝玉伯:我心目中的优秀API

YouMind:AI驱动技术PPT制作,从思维导图到精美幻灯片的效率革命 在技术传播与工程实践中,高效、清晰的可视化表达是连接复杂逻辑与受众理解的关键桥梁。传统上,技术文档与演示文稿的制作往往面临设计门槛高、耗时长的挑战,尤其当涉及系统架构、微服务调用链或数据流向等专业图表时。其核心原理在于将结构化思维(如思维导图)与AI智能美化引擎相结合,通过自然语言处理与设计模板匹配,自动化完成排版、配色与基础图表生成。这一技术价值在于显著降低技术表达的可视化成本,使开发者能聚焦于内容逻辑而非形式设计。其典型应用场景包括技术方案评审、项目复盘、晋升答辩及知识分享等需要快速产出专业级演示材料的 阅读详情

近日,酷壳网陈皓与支付宝前端负责人玉伯在微博上发起了关于API设计的话题。陈皓表示,有两点是前端工程都需要认真考虑的:1)一些API最好支持批量数据处理,而不是让人一次一次地掉用,2)需要考虑多个API间的关联性,可以降低使用方的工作量。对此支付宝前端负责人玉伯分享了他的看法:

延续大前天的话题,陈皓在微博中提到:

【如何设计JS API?】我觉得有两点各个前端工程需要认真考虑:1)我们的一些 API 最好支持批量数据处理,而不是让人一次一次地调用。2)我们需要考虑多个 API 间的关联性,如果别人有可能在调用 API2 之前需要 API1 的结果,那么我们应该把 API1 和 API2 包一下。这会降低使用方的工作量。

支持批量处理

陈皓提到的这两点非常具体。支持批量处理,是 API 在设计时需要考虑多个输入。比如 shell 中的 cp 命令:

$ cp *.js target_dir

对于 loader 来说也一样:

// 加载一个文件
seajs.use('a', callback)

// 加载多个文件
seajs.use(['a', 'b'], callback)

API 是否支持批量处理,得具体看是什么功能,比如 Node.js 中的读取文件接口:

fs.readFile('/etc/passwd', function (err, data) {
  // do something
});

这个 readFile 就没必要支持批量读取。

什么样的 API,以及什么时候需要支持批量处理呢?我觉得有以下几个规律:

  1. 直接面向普通使用者。比如 shell 中的好多命令,以及 seajs.use、jQuery(selector) 等等。这些 API 一般来说不用再封装,是高级 API。

  2. 批量处理本身有含义、是常见需求。比如 readFile 支持批量价值就不大,一次读取多个文件的需求不常见,出现了也很容易基于 readFile 自己去实现。

  3. 批量处理时,顺序无关,不存在依赖性。比如 cp 多个文件时,先处理哪个文件是没关系的。seajs.use 加载多个文件时,先加载同一层级的哪个文件也不应该影响最终结果。

能满足以上需求的 API,经常就需要支持批量处理。

考虑 API 的关联性

这个说的其实是依赖,很大程度上属于 user-land 范畴,API 本身经常很难做什么。比如在 shell 上,可以通过管道来解决依赖:

$ cat sea-debug.js | wc -l

上面通过管道先后执行两个命令,可得到 sea-debug.js 文件的代码行数。

依赖问题最终都是顺序问题,shell 通过管道将依赖转换成单向顺序来解决,很轻巧方便。

但在浏览器端,异步满天飞,问题往往就没那么简单了。

比如

seajs.use(['a', 'b', 'c'], callback)

如果模块 b 依赖模块 a,模块 c 是独立的。那么我们面临的问题是:

  1. seajs 如何知道依赖信息?如何知道模块 b 是依赖模块 a 的?谁来告知?何时告知?
  2. 如何实现 a、b、c 三个模块同时并行加载,但执行时是按照依赖顺序来执行的?

涉及异步、涉及依赖,都绕不开以上问题。在 YUI3、Dojo、RequireJS、SeaJS、OzJS 等等类库 / 框架中都需要解决以上问题。

对于依赖信息的获取,典型的处理方式有两种:

  1. 提前申明依赖信息。比如 YUI 里,对于自带模块,会有一个很大的 json 数据来声明各个模块之间的依赖。非自带模块,则需要在使用前先注册一下,注册时申明好依赖。这样,处理起来就简单了。

  2. 自我携带依赖信息。各个模块的依赖,在模块自己的代码中申明,比如

    define('b', ['a'], factory)
    

    上面的第二个数组参数,表示模块 b 的依赖是模块 a.

有了依赖信息后,就可以转换成顺序问题。依赖先加载,加载并执行后,再加载后续模块。这是最简单的处理方式。

还有一种方式是,因为依赖影响的是执行顺序,因此加载依旧可以并行,通通并行下载好后,在真正执行时,才根据依赖信息按顺序执行。这是 SeaJS 等 loader 的处理方式。

比如对于陈皓的那道面试题,如果用 SeaJS 来解决,可以:

var API_URL = 'http://coolshell.cn/t.php?callback=define&n='
var urls = []

for(var i = 1; i < 31; i++) {
  urls.push(API_URL + i)
}

seajs.use(urls, function() {
  for (var i = 1; i < 31; i++) {
    console.log(i, arguments[i - 1])
  }
})

并发请求和顺序输出都解决了。注意这里的依赖仅仅是最后的顺序输出,与普通的依赖是不同的。普通的模块之间的依赖,可以通过模块之间声明依赖关系来解决。

各种 loader 仅是解决文件加载、文件依赖。如何处理依赖是更宽泛的话题,这里就不多说了。

我心目的优秀 API

以上说的,纯粹是从陈皓的微博引发的一些点上的思考,不具有普适性。对大部分前端 API 设计来说,参考价值也很有限。

下面扯扯更宽层面上,我心目中优秀 API 的标准。

简单

我想了很久,依旧想把“简单”摆在第一位。好的 API 必须是简单的。简单不仅仅是看起来简单,简单还意味着背后的实现逻辑是正常人类思路能理解的。比如

document.getElementById('string')

这个 API 是个前端都能看懂,并且能大概猜出背后是怎么实现的。虽然很可能猜错,但没关系,关键是你不会觉得神秘难懂。类似的,有很多实物 API:

汽车车窗的控制把手。往上提就是关窗,往下摁就是开窗。很符合直觉,大概也能猜出是怎么实现的(当然实际没那么简单,但能让用户感觉很简单)。

简单也意味着一致性。比如 JavaScript 里,forEach、map、filter 等所有数组遍历操作,callback 接收的参数都是 item、index、array. 这种一致性可以让你触类旁通,非常舒适。

完备

完备是指,某个类库或框架,对所解决的问题领域和业务需求,要有彻底的深入理解。提供的 API 是一整套的,能处理该问题领域的各种可能性,各种实际需求。

要达到完备性,首先要解决的是定位问题。任何类库框架都不可能解决所有问题,必须要非常清楚要解决的问题范畴。依旧拿我最爱的 jQuery 来举例。

jQuery 的定位非常清晰: DOM 操作类库,包括 DOM 操作、事件、动画和 Ajax。其他的比如 Cookie 操作、Loader 等功能,即便用户需求很旺盛,jQuery 也会节制欲望,不去涉足。

在这个定位下,jQuery 的设计也非常清晰: 找到 DOM 元素,并操作它。 这样,jQuery 的整套 API 变得很优美:

$(selector).attr(...)
$(selector).css(...)
$(selector).animate(...)
...

优美之处在于,你能想到的常用 DOM 操作等功能,jQuery 都提供了。不怎么常用的,使用 jQuery 的现有 API,也能快速实现。

这就是 API 的完备性,让你不会因为某些功能的实现而抓狂。一切都在那里静静躺着,等着你去发现,等着你去欣赏。

同样,SeaJS 也是抱着这个目的去做。SeaJS 的定位是 Web 端的模块加载器,核心是解决模块定义、依赖管理、模块加载。此外一切问题都不属于 SeaJS 范畴。 SeaJS 的理想是把自己做“死”,“死”意味着完备性,意味着站在 loader 的角度,SeaJS 的功能能增无可增,减无可减。

除了简单、完备这两个关键词,我想不到优秀的 API 还需要去做什么。简单能给用户带去欢喜,完备则可以让开发者去挑战新的领域。

Java整合支付宝支付接口 以前在支付宝做研发,后面有些朋友的公司需要对接支付宝接口,联系我提供支付宝支付接口,希望在转账这块对大家有帮助 立即下载

相关推荐

企业数字化转型AI大模型赋能智能体平台及AI场景应用规划方案(生态合作版).pptx

企业数字化转型AI大模型赋能智能体平台及AI场景应用规划方案(生态合作版).pptx

自动驾驶系统设计空间探索的多智能体LLM框架

自动驾驶系统设计面临配置组合爆炸、环境依赖性和评估复杂度等核心挑战。传统方法难以高效处理这些多维优化问题,而基于大语言模型(LLM)的多智能体框架提供了创新解决方案。该框架通过多模态理解结合视觉和文本分析,实现全面系统评估;分布式决策机制让专业Agent各司其职;动态记忆避免重复探索低效区域。在工程实践中,该方案能显著提升自动驾驶系统的设计效率,特别适用于需要平衡硬件性能、软件效率和成本约束的复杂场景。实验表明,相比传统方法,这种LLM驱动的多智能体框架可使设计空间探索效率提升40%以上,同时降低硬件成本1

weixin_30291791的博客 671

UE5.5使用ControlRig实现MetaHumanNPC看向玩家

本文介绍了在虚幻引擎中实现NPC自然看向玩家的技术方案。通过MetaHuman的ControlRig系统,采用面部动画曲线+全身动画Montage的表演方式,结合ControlRig驱动CTRL_lookat控制器实现视线追踪。

平常心 1306

图灵访谈之三十二:陈皓(@左耳朵耗子)专访-----一个拥有独特个性、优秀人格的魅力的技术人

图灵访谈之三十二:陈皓(@左耳朵耗子)专访 芝兰生于深谷,不以无人而不芳 。君子修身养德,不以穷困而改志。 “码农人物志”第二期码农代表:陈皓(@左耳朵耗子),酷壳coolshell.cn博主。 14年软件开发相关工作经验,8年以上项目和团队管理经验,6年的软件行业咨询经验。擅长底层技术架构,团队建设,软件工程,软件研发咨询,以及全球软件团队协作管理。对高性能,高可用性,分布式,高并发,以

Flying with the nature, wanton and for 1524

20 CVPR Learning 3D Semantic Scene Graphs From 3D Indoor Reconstructions 学习笔记

3RScan是大规模真实世界的室内场景,特点是对478个自然改变的室内环境在不同的时间帧进行了1482 RGB-D scans,每一个scene都包括了一些位置被改变的物体。它和ScanNet数据集的区别主要在于ScanNet中的每一个采样环境都不相同,但是3RScan中存在采样环境相同但物体的位置不同的场景。Scene Graph Annotations 则是在3RScan的基础上给物体加入了场景图需要的关系、物体特征和类别标注,同时对3RScan进行了扩展,以此形成了场景图数据。

weixin_43508459的博客 1838

G2O (General Graph Optimization)入门及简单使用

g2o全称是General Graph Optimization,也就是图优化,我们在做SLAM后端或者更加常见的任何优化问题(曲线拟合)都可以使用G2O进行处理。

晓晨的博客 1万+

左耳朵耗子-陈皓经历(转载)

左耳朵耗子-陈皓 一、个人简历 陈皓,coolshell.cn博客博主。 14年以上软件开发相关工作经验,8年以上项目和团队管理经验。 擅长底层技术架构,软件工程。 对高性能,高可用,分布式,高并发,大规模数据处理系统有一定研究。 技术擅长C/C++/J

ClimberCoding 1万+

Understanding Lockup Cells

工具会分析扫描链和EDT逻辑之间的控制时序元素的时钟的时序关系,当必须要同步时钟并保持数据完整性时插入边沿触发寄存器(lockup cells)。可以使用report_edt_lockup_cells命令来展示工具已经插入的lockup cells的详细报告。

weixin_44954910的博客 1083

支付宝玉伯:从前端到体验,如何把格局做大?

阿里妹导读:国内的前端行业,是一个群星璀璨,同时又有些纷纷扰扰的圈子。很多初出茅庐的年轻人怀着改变世界的梦想,谁也不服谁。不过,有一些为前端领域做出贡献的拓荒者几乎受到所...

阿里技术 901

单片机控制双向可控硅的5种实用触发电路设计(附完整电路图)

本文深入解析了单片机控制双向可控硅的5种实用触发电路设计,涵盖从基础隔离到复杂负载驱动的实战方案。重点探讨了光电耦合器选型、过零检测同步、RC吸收电路精密计算以及应对感性负载和高噪声环境的加固策略,并提供了完整的电路图与调试避坑指南,旨在帮助开发者实现安全可靠的交流负载控制。

joy55的博客 2227

解决usbisp不识别无法烧录Atmega328P,Arduino不识别问题

如果使用Arduino IDE里面的烧录,可能会遇到一个问题,就是不识别国产这种廉价的USBISP 点击烧录引导程序,会遭遇到找不到USB设备的问题,选哪个都会提示找不到,比如选择USBasp could not find USB device with vid=0x16c0 pid=0x5dc vendor='www.fischl.de' product='USBasp' 因此,我们需要使用到progisp这一个软件的1.72版本 选择好芯片的型号后,调用编译好的HEX文...

arenascat的博客 7441

20位活跃在Github上的国内技术大牛

本文列举了20位在Github上非常活跃的国内大牛,看看其中是不是很多熟悉的面孔? 1. lifesinger(玉伯) Github主页:        https://github.com/lifesinger微博:@        玉伯也叫射雕 玉伯(王保平),淘宝前端类库 KISSY、前端模块化开发框架SeaJS、前端基础类库Arale的创始人。2003-2006

YaoXTao的专栏 20万+

构建基于知识图谱的金融风险关联网络

在金融领域,风险的识别和管理至关重要。传统的风险分析方法往往只能处理单一维度的数据,难以全面捕捉金融市场中复杂的风险关联关系。构建基于知识图谱的金融风险关联网络的目的在于整合多源异构的金融数据,通过知识图谱的方式清晰地展示金融实体之间的复杂关系,从而更准确地识别潜在的金融风险,为金融机构的风险管理决策提供有力支持。本项目的范围涵盖了从金融数据的收集、预处理,到知识图谱的构建,再到金融风险关联网络的搭建和分析。

SuperAGI2025 1421

【开源专访】Sea.js创始人玉伯的前端开发之路

摘要:玉伯,淘宝前端类库 KISSY、前端模块化开发框架SeaJS、前端基础类库Arale的创始人。本期【开源专访】我们邀请玉伯来为我们分享一些关于前端框架、前端开发的那些事,以及前端大牛是如何炼成的。 在Web应用程序的用户体验越来越被重视的今天,前端开发的地位也上升到了前所未有的高度,而随之而来的也有更多的挑战。 为了将前端开发者繁重的工作变得简单,框架应运而生。国内也不乏一些非常优秀...

weixin_34074740的博客 286

道路缺陷检测实战指南:基于YOLOv11的深度学习系统从搭建到落地

道路缺陷检测项目的每一步,都是“理论→实践→反思→优化”的成长循环。当你看到自己开发的系统能精准识别出道路上的每一处裂缝、每一个坑洼时,那种“技术解决真实问题”的成就感,会让你明白深度学习不止是论文里的公式,更是改变行业的工具。如果过程中遇到模型不收敛、界面功能异常等问题,不妨把问题拆解成“数据是否标注准确?”“模型参数是否合理?”“界面逻辑是否有漏洞?”等小问题逐一排查。记住,每解决一个问题,你就离“能独立落地AI项目的工程师”更近一步。

LXY_LOVE36的博客 173

温度PID控制PLC程序

温度PID稳定控制程序,适用于欧姆龙PLC,对其他PLC也具有很大参考价值

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

阿里云和蚂蚁金服招人啦(校招/社招)

校招毕业要求时间 2020 年,本科研究生都可以,社招P6起意向阿里云的同学请将简历发送至ranmo.cy@alibaba-inc.com[1]意向蚂蚁金服

全栈者 的博客 4021

廖雪峰Python教程[完整版]

廖雪峰的python教程整理的,已经排好版了,而且还是完整的,适合小白

TMS_WebGMaps_1.9.8.0_Full_Source

TMS_WebGMaps_1.9.8.0_Full_Source 全源码 delphi cbuilder

论如何成为技术大牛,GitHub中国区前20名详解

本文根据Github公开API,抓取了地址显示China的用户,根据粉丝关注做了一个排名,分析前一百名的用户属性,剖析这些活跃在技术社区的牛人到底是何许人也!Github中国区前一百名城市分布,令人比较意外的是IT重镇深圳和广州居然和北上杭差距那么大!(其中China表示没有注明具体城市用户)Github中国区前一百名语言分布图,前端开发者依然霸占着大多数,移动开发者加起来也已经达到半壁江山,让人

IT派 8062

2018年·玉伯《从前端技术到体验科技(附演讲视频)》

玉伯在首届蚂蚁体验科技 SEE Conf 大会上分享的总结,已经取得玉伯本人同意,发布cnode和node全栈公众号。以下是正文很抱歉在首届蚂蚁体验科技 SEE Conf 大会上,给大家讲得有点磕绊不太清楚。今天写下来行诸文字,希望一些思考能与大家进一步交流。(设计师朋友可以跳过前端技术部分,直接看后面章节)什么是前端技术第一次接触前端开发是 2002 年大学期间,转眼 15 年多。这些年一直在思

Node全栈 2882

前端支付对接,支付宝支付、微信支付

前端对接支付接口,支付宝支付,微信支付

weixin_45669156的博客 4581

不断进阶:从“学渣”到P10,一位阿里工程师的逆袭故事

红雪是蚂蚁金服的研究员,带领大几百号人的技术团队,最近还入选了“全球35位35岁以下科技创新青年”。 团队里都是学霸海归,每次有新人入职,他都会笑着拱拱手:学霸你好,我是个学渣,我没上过大学。 他高中毕业,没上大学四处打零工,路边修过自行车,也做过理发店小弟。想学自考混文凭,结果连自考的考试都挂掉了。 这是一个公众号@蚂蚁金服讲的一个阿里逆袭故事。学历不...

weixin_34019144的博客 1906

优秀API的几大特征

优秀的API究竟应该怎么设计,它包含什么特征,可能有过API相关开发经验并且认真思考过的朋友都有这个疑问。 · 1、隐藏实现细节 创建API原因就是为了隐藏所有实现细节,防止对客户造成影响。具体包括对于变量、方法与类的隐藏。对于变量的返回,我们不应该返回非const的指针或者引用的私有数据成员。这会破坏封装。 2、最小完备性 完备的API是指期望有的功能都包含了。最小的完备则是在实现所有功

星火之燎原的专栏 1370

从JavaScript 数组去重看兼容性问题,及性能优化(摘自玉伯博客)

缘由 JavaScript 数组去重经常出现在前端招聘的笔试题里,比如: 有数组 var arr = ['a', 'b', 'c', '1', 0, 'c', 1, '', 1, 0],请用 JavaScript 实现去重函数 unqiue,使得 unique(arr) 返回 ['a', 'b', 'c', '1', 0, 1, ''] 作为笔试题,考点有二: 正确。别小看这个考点...

u012125579的专栏 2271

观点|蚂蚁金服玉伯:我们是如何从前端技术进化到体验科技的?

小蚂蚁说: 王保平,花名玉伯。熟悉前端和SeaJS的人一定对这个名字不陌生。作为前端领域的一枚大大大牛,他现在担任蚂蚁金服体验技术部负责人。本文,他分享了他从前端一路进阶升级到体验科技的个人思考,并详细介绍了体验科技的历史及未来发展,以及本次体验科技开放的愿景。 前端的本质是什么?随着移动和物联网的发展,前端技术又会有哪些变化?希望通过本文内容大家能对这些问题以及体验科技有更进一步的了解,文末...

sweetfire的博客 2242
上一篇: 程序员心髓:移动应用API设计10大技巧
下一篇: API设计的十大最差和五大最佳实践
代码兔
博客等级 码龄16年 21粉丝 23原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值