# 聊聊 APILetter 的新计划

- Link: https://www.ixiqin.com/2023/09/18/talk-about-apiletters-new-plan/
- Published: 2023-09-18T15:28:00+08:00
- Author: 白宦成

文章目录

 [Toggle](https://www.ixiqin.com/2023/09/18/talk-about-apiletters-new-plan/#)

 * [过去](https://www.ixiqin.com/2023/09/18/talk-about-apiletters-new-plan/#%e8%bf%87%e5%8e%bb)
 * [未来](https://www.ixiqin.com/2023/09/18/talk-about-apiletters-new-plan/#%e6%9c%aa%e6%9d%a5)
 * [Season 2：指标](https://www.ixiqin.com/2023/09/18/talk-about-apiletters-new-plan/#season_2%ef%bc%9a%e6%8c%87%e6%a0%87)
 * [总结](https://www.ixiqin.com/2023/09/18/talk-about-apiletters-new-plan/#%e6%80%bb%e7%bb%93)

APILetter 从创刊号，到 S1E6，经历了一年的时间。

虽然在定更新节奏时，我就考虑到自己拖更的可能性，但确实没想到我拖更这么严重，在 2022
年，一口气更新了 3 篇，然后就是长达半年的拖更。不过，总算是把第六篇写完，算是给 
Season 1 做个了结。

## 过去

APILetter 的出现，是源自我在研究 RESTFul 架构时发现的问题：国内有太多解释什么是 
RESTFul 规范的文章，但你点进去看，篇篇都是复制粘贴。

而 API 是开发者生态中非常重要的一环，它不应该被草率的对待，开发者们值得用上更好的
API。既然没有人写关于 API 的严肃内容，那就从我开始吧。刚好我在研究相关的内容，那就
写一些 API 到底应该是什么样的。

也正是抱着这个想法，我开始了一篇篇的创作，从 [为什么是 RESTful API](https://www.apiletter.com/s1e1-wei-shi-yao-kai-fang-ping-tai-da-duo-xuan-ze-liao-restful-feng-ge/)，
到如何[设计一个符合 RESTFul 风格规范的批量操作 OpenAPI](https://www.apiletter.com/s1e5-ru-he-she-ji-yi-ge-fu-he-restful-feng-ge-de-pi-liang-cao-zuo-de-openapi-jie-kou/)；
有务实的内容，也有务虚的内容。但不变的是希望让大家明白如何设计一个更好的面向开发
者的 API。

但，Season 1 的内容也是杂乱无章的，聊过 RESTFul、聊过 API 文档、聊过 API 指标、聊
过 API 报错，这样杂乱且没有主线的内容，作为博客来说，还算可以接受，但作为 Newsletter，
可能就显得过于随意。因此，在 Season 2 开始，内容也会开始面向主题，我也会更早的设计
不同的 Season 要讨论的话题，以便于让你可以有更好的阅读体验。

## 未来

在写第一篇邮件通讯时，我就注册了域名 APILetter.com，因为我知道这件事我应该会做很久，
所以搞一个独立的站点是必然的事情，也是符合我习惯的事情 —— 每搞一个事情，就要给它
一个独立的品牌。

而在刚开始写第一封邮件时，我是没有勇气使用独立的站点的，我总担心自己写完第一封就
写不下去了。那搞一个独立的站点不过是浪费时间。所以我选择从竹白开始我的写作之旅。
一年过去了，获得了还算不错的效果（至少比我想象中的要好一些）。

![](https://www.apiletter.com/content/images/2023/09/image.png)

迁移到 Ghost 之前的数据

不论过程是否艰辛，总归我是完成了自己对自己的承诺，至少写完了一个 Season 的内容。

而 APILetter 完成了第一阶段的产出后，下一个阶段，我希望用更加品牌化的方式来运行这个
项目，便启用了 APILetter.com 的域名），并搭建了 Ghost 来托管这个项目。

换到 Ghost，除了域名独立、程序独立、数据独立，相应的，自然也有一些好处 —— 比如可以
RSS 订阅了。如果你希望通过 RSS 的方式来订阅 APIletter， 也可以直接访问 [https://www.apiletter.com/rss/](https://www.apiletter.com/rss/)
来订阅。

## Season 2：指标

在 Season 1 中，我花费了不少的篇幅来讲 OpenAPI 的设计问题。在 Season 2 ，我想专注
于 OpenAPI、开发者体验中的指标问题，从企业和个人制定目标开始，到具体到某一个具体
的 OpenAPI 指标评定。

目前预计会包含的内容：API 自身的指标定义、API 相关业务的指标定义、开发者体验中的
一些指标定义。

除了这些指标，你还关注哪些指标？欢迎回复邮件告诉我。

## 总结

总之，APILetter 在新的一季里，我会尽量以更好的内容组织方式、更高的频率（但暂时承诺
还是每月一封哈），来给大家分享我自己关于 API、关于开发者体验，以及一切与开发者有关
的内容，希望可以帮到你。

如果你身边有对于开发者关系感兴趣或从事相关内容的朋友，欢迎你将 APILetter 介绍给他，
帮助我获得更多的读者，以及，持续的写下去🥰。