出售自编API学习手册之前，怎样说明它适合谁？

说明适合谁，关键不是写“适合所有人”，而是把使用前提、已有基础和不包含范围讲具体。让买家对照自己的情况做判断，比笼统承诺更有用，也能减少买后才发现不对路的情况。

先写清这份手册假设读者已经会什么

自编API学习手册通常不是从零讲编程的入门书。你需要在介绍里写明：读者是否要懂一门编程语言的基础语法、是否用过命令行、是否理解HTTP请求和响应的基本概念。这些前提决定了手册能不能被读懂。

写法上可以直接列成短句，例如“需要能看懂简单代码示例”“需要知道GET和POST是什么”。不要写“零基础也能学”，除非你确实从最基础讲起。前提写得越具体，买家越容易对号入座。

用具体场景描述适用人群，而不是贴标签

与其写“适合初学者”“适合进阶者”，不如描述读者正在做的事。例如：正在准备接口相关面试、需要理解通用协议示例、想跟着练习步骤自己动手写一遍请求。场景越贴近实际，判断越准确。

假设你写了一份手册，内容是用虚构参数演示请求构造和响应解析。那么适合的人群可以是“已经会写简单脚本、想系统梳理请求流程的人”，而不是“完全没接触过编程的人”。这种描述不夸大，也不承诺学习效果。

明确写出不包含的范围

买家最怕的是以为买到了什么、结果没有。手册里如果只有通用协议示例和虚构参数，就要说明不含真实凭据、不含某个具体平台的私有接口、不含生产环境配置。把这些边界写清楚，是介绍的一部分。

还可以说明手册不提供一对一答疑、不包含代码仓库、不保证能直接用于工作项目。这些说明不是自贬，而是让买家知道交付清单里有什么、没有什么，减少预期落差。

给出一个让买家自测的选择判断

在介绍末尾放两三个判断问题，让买家自己回答。例如：我是否看得懂示例里的代码结构？我是否需要的是某个平台的专用文档？我是否愿意按练习步骤自己动手？如果答案偏向否定，就说明这份手册可能不是首选。

这种自测比“买了不后悔”之类的说法更实在。你还可以提示买家先看介绍中的目录和示例片段，再决定是否购买。判断权交给买家，介绍的可信度反而更高。

常见问题

手册介绍里要不要写“适合零基础”？

只有当手册确实从最基础讲起时才写。如果内容假设读者懂基本编程概念，就应如实说明前提，否则买家买后读不懂，容易产生纠纷。写清前提比吸引更多人购买更重要。

不包含范围写太多会不会吓跑买家？

写清边界反而能筛掉不合适的人，留下真正需要的买家。关键是把“包含什么”写得同样具体，让买家看到手册的实际内容，而不是只看到排除项。

可以用“学完能做什么”来描述适用人群吗？

可以描述手册覆盖的练习目标，但不要承诺学会后的收入、职位或能力结果。用“帮助梳理请求流程”这类中性表述，比“学完就能胜任接口开发”更稳妥。