这可能是我用过最“强大”的API：Marvel API

小灰灰 2022-02-24 08:18 197阅读 0赞

我们在编程教室中写过不少使用 **API 开放接口**的案例，比如：

*  查询书影音的**豆瓣**（[爬虫 网站开发实例：电影票比价网][Link 1]）
 *  查询股票的**tushare**（[想用 Python 做数据分析？先玩玩这个再说][Python]）
 *  翻译单词的**词霸**（[【每周一坑解答】自动翻译][Link 2]）
 *  用来做人工智能的**腾讯AI**（[调教属于你的“贾维斯”][Link 3]）

但以上这些都不是我今天要说的。今天要说的这个接口，之所以称为“强大”，因为**它返回的内容里蕴含了未知的巨大能量，大到可以轻松毁灭宇宙 N 次……**

没错，这就是 **Marvel 向开发者开放的 API**。

![v2-e59d6dc34efc7a9ce2ea38ba06d67467_b.jpg][]

官网地址：[https://developer.marvel.com/][https_developer.marvel.com]

数据涵盖的内容主要是 Marvel 相关的漫画作品信息，包含：

*  1491 个**角色**
 *  43759 本**漫画**
 *  6200 个**创作者**
 *  10713 个**系列**
 *  96740 个**故事**
 *  75 个**事件**

以及这几样数据之间的相互关联关系。比如你可以通过一个角色查到其所出场的事件，或者一个创作者所参与过的角色。

我做了一个简单的小演示，可通过名字查询相关的角色：

![v2-8a0dcc86879fd3b4168ce5d91428e0db_b.jpg][]

以及通过角色 ID 查询其出现的漫画：

![v2-3bb8af849563596e2116ddacf06cb0b0_b.jpg][]

**Marvel API 不是完全公开访问，需要先申请**，不过没有任何门槛（只要看得懂英文）。使用接口时，常规操作是按照官方提供的方式，**将申请获得的公钥、密钥加上时间戳进行 MD5 加密，作为权限的验证放在参数里，通过 GET 方式进行请求**（可以用 requests）。

![v2-d794c8921f71f3797a3870d7a03be708_b.jpg][]

而我这里用了一个第三方封装好的 Python 库 **marvel**，省了不少工作，所以核心代码很简单：

import marvel
    from IPython.display import Image, HTML, display
    PUBLIC_KEY = '你的公钥'
    PRIVATE_KEY = '你的私钥'
    m = marvel.Marvel(PUBLIC_KEY, PRIVATE_KEY)
    characters = m.characters
    name = input('请输入要查询的英雄（英文，可只输入开头）：')
    print('搜索中...')
    all_characters = characters.all(nameStartsWith=name)

第三方库地址：[https://pypi.org/project/marvel/][https_pypi.org_project_marvel]

Marvel 的这个 API，我觉得是个非常好的练手工具。作为一个学习者，你可以从使用中学到：

1.  公钥、私钥、MD5加密的使用（接口权限验证）
2.  API的调用，参数传递，JSON返回数据的处理
3.  多维度数据的整理分析
4.  还有，英文文档的阅读

让我有点遗憾的是，数据中并没有太多英雄角色相关的数据，不然就更有意思了。

对于这个接口的应用，我有几个思路供参考：

1.  做一个爱好者网站或者小程序，对数据提供检索和整理展示
2.  数据分析，看看哪些角色最受欢迎，哪个作者最勤奋，角色之间的相互关系等
3.  小游戏，比如集卡之类。（当然，非商业的）

早前我也推荐过豆瓣的 API，不过豆瓣现已把开发者页面下线，无法查看具体接口说明，之后会不会对外关闭也很难说了。Marvel API 相比豆瓣 API 来说要复杂一些，主要是权限认证的部分。另外，在使用时还有一些要求，如果你之后将作品对外展示，请务必注意：

1.  **请求上限** 1000次/天（但在我的个人页面上看到是 3000），并且需要设定请求来源网址（referrer）。建议通过自建缓存，以减少请求量
2.  需要在所有用到接口数据的页面上标注 **"Data provided by Marvel. 2014 Marvel"**
3.  需提供到 Marvel 官网的反链（**[http://marvel.com][http_marvel.com]**）
4.  返回接口里的图片 URL 不是直接可访问的，需添加上所需图片尺寸和文件类型，拼出完整路径

经常有同学说学了编程之后不知道去开发点什么。其实可以做的东西比比皆是，需要有发现需求的眼睛。暂时没有这方面敏感度也不要紧，**多看看我们的文章，跟着我们做**。如果你碰巧又是漫威粉，那就更应该尝试一下了。之后我们也会在此数据基础上开发一些案例，敬请期待。（立个Flag：争取跟《复联4》同步上线）

文中所使用的代码已上传，获取代码请在公众号（**Crossin的编程教室**）里回复关键字**漫威**

════

*其他文章及回答：*

学编程：[如何自学Python][Python 1] | [新手引导][Link 4] | [一图学Python][Python 2]

开发案例：[智能防挡弹幕][Link 5] | [红包提醒][Link 6] | [流浪地球][Link 7]

欢迎搜索及关注：**Crossin的编程教室**

![154816tsh373rusgwbxs7w.png][]

[Link 1]: https://link.zhihu.com/?target=http://mp.weixin.qq.com/s?__biz=MjM5MDEyMDk4Mw==&mid=2650166890&idx=1&sn=3045fd40c3d0cf0c699534b3c94d4b4f&chksm=be4b5b12893cd2043b8c3f99692ca78a33180228631bb15b1f905028c78a2055aefb3c4aad33&scene=21#wechat_redirect
[Python]: https://link.zhihu.com/?target=http://mp.weixin.qq.com/s?__biz=MjM5MDEyMDk4Mw==&mid=2650166012&idx=1&sn=ab577b80c7b3a261ce3b701a816bb639&chksm=be4b5f84893cd692b89811f510a038737248d54a3dbca0f8b7520084f245ce2204ffbb309b51&scene=21#wechat_redirect
[Link 2]: https://link.zhihu.com/?target=http://mp.weixin.qq.com/s?__biz=MjM5MDEyMDk4Mw==&mid=2650168109&idx=1&sn=7dedf4b5de37764d35134ba372346552&chksm=be4b5655893cdf431a76193c345ac13223ce2bbbbc34548bb2b72f3fcd511156dc81f13356fe&scene=21#wechat_redirect
[Link 3]: https://link.zhihu.com/?target=http://mp.weixin.qq.com/s?__biz=MjM5MDEyMDk4Mw==&mid=2650167239&idx=1&sn=787bdae2fc8f6843187dd62f4fcf31a4&chksm=be4b5abf893cd3a968d5ad5a6d50164d783918426e34deb8a0f2af40e064b1dc068306727516&scene=21#wechat_redirect
[v2-e59d6dc34efc7a9ce2ea38ba06d67467_b.jpg]: http://crossin-forum.b0.upaiyun.com/upload-by-code/20190328/v2-e59d6dc34efc7a9ce2ea38ba06d67467_b.jpg
[https_developer.marvel.com]: https://link.zhihu.com/?target=https://developer.marvel.com/
[v2-8a0dcc86879fd3b4168ce5d91428e0db_b.jpg]: http://crossin-forum.b0.upaiyun.com/upload-by-code/20190328/v2-8a0dcc86879fd3b4168ce5d91428e0db_b.jpg
[v2-3bb8af849563596e2116ddacf06cb0b0_b.jpg]: http://crossin-forum.b0.upaiyun.com/upload-by-code/20190328/v2-3bb8af849563596e2116ddacf06cb0b0_b.jpg
[v2-d794c8921f71f3797a3870d7a03be708_b.jpg]: http://crossin-forum.b0.upaiyun.com/upload-by-code/20190328/v2-d794c8921f71f3797a3870d7a03be708_b.jpg
[https_pypi.org_project_marvel]: https://link.zhihu.com/?target=https://pypi.org/project/marvel/
[http_marvel.com]: https://link.zhihu.com/?target=http://marvel.com
[Python 1]: https://www.zhihu.com/question/20702054/answer/19022301
[Link 4]: https://zhuanlan.zhihu.com/p/25824007
[Python 2]: https://zhuanlan.zhihu.com/p/54335457
[Link 5]: https://zhuanlan.zhihu.com/p/54436238
[Link 6]: https://zhuanlan.zhihu.com/p/55886065
[Link 7]: https://zhuanlan.zhihu.com/p/56598906
[154816tsh373rusgwbxs7w.png]: http://crossin-forum.b0.upaiyun.com/forum/201806/28/154816tsh373rusgwbxs7w.png