今天这篇文章主要是总结了几点使用API忘光的过程中容易出错的地方。

第一·API的类型到底是公开还是私有，它的界限在哪里？

可以这样理解，私有的API，除非主动授权给某个App，否则没有人能够看到。即使是把某个API分组上架到云市场上，这个分组中私有类型的API也不会暴露出来，只会把这个分组中公开类型的API放到云市场中。

第二·API定义到底是什么？草稿是什么？现在线上运行的是哪一个定义？
经常出现用户改了API的定义，但是线上运行的还是旧的。出现这种情况可能是定义没有发布，这个可能有点歧义。
具体解释看AIP问题文档

点我领取阿里云2000元代金券，（阿里云优惠券的作用：购买阿里云产品，最后支付结算的时候，阿里云优惠券可抵扣一部分费用。

一个API刚刚创建的时候，运行环境这一列的状态是上图这样的，因为还没有操作发布，所以它这个时候就是一个草稿，他的定义也就没有在任何环境里生效。我们需要把它发布上线，才能生效。这里我们把它发布到线上环境中。

这个时候可以看到，线上这个环境后面多了“运行中”三个字，有这个之后才表示已经发布到环境中了。然后点击这个“运行中”。

弹出来的这个定义就是目前在这个环境中运行的定义。如果后来您在API定义里面又编辑过API，那么就需要重新再进行发布，修改的内容才会生效。

点我领取阿里云2000元代金券，（阿里云优惠券的作用：购买阿里云产品，最后支付结算的时候，阿里云优惠券可抵扣一部分费用。

第三·在开放API的菜单中点击API的名称，进入API详情的调试API页面。

这个页面是对API草稿的调试，并不是某一个环境中运行定义的调试，它调试的就是最后更改的这一版API草稿定义。而且因为调试的是草稿，而且直接是在开放API的用户这里直接进行调试，所以它并没有App相关的东西，也就是说没有认证，没有签名方面的调试。

以上就是API中经常出现歧义的几个问题，希望大家能够注意。
更多信息参阅AIP问题文档

点我领取阿里云2000元代金券，（阿里云优惠券的作用：购买阿里云产品，最后支付结算的时候，阿里云优惠券可抵扣一部分费用。