月萌API中有接口和接入点的概念,简单说来:

接口:完成某功能的一个或一组API(一组接入点)

接入点:接口下能完成某个子功能的子API, 一个接口可包含多个接入点

接口与接入点的联系与区别

下面通过地表水水质监测数据接口和IP地址归属地查询接口谈谈接口与接入点的联系和区别。


接口从提供的内容上来讲,大致可以分为数据接口与工具接口,数据接口主要以提供数据为目的,如地表水水质监测系统数据,已经包含了大量的动态更新的数据;工具接口主要以提供某个功能为目的,如IP地址归属地查询接口,通过传入的IP进行归属地查询。

数据接口中接口一般为数据的汇总,如地表水水质监测数据接口中接口为全国所有国控监测点的数据,而接入点为各各省市地域或流域的监测点的数据。

工具接口中接口一般为提供某功能,如IP地址归属地查询接口中接口为查询某IP归属地,接入点是相关的功能细化,如批量查询IP归属地,即此时接口与接入点是差不多的,都在完成某单一功能。

简而言之,引入接入点的目的,是为了提供与接入点相关的其它维度的数据或功能,避免每个功能都做成单独的接口。同时,因为月萌API是一个综合性的数据接口,某个功能可能有多个供应商的接口可供选择,将这个功能相关的接口做成接入点,更容易辨识,保证数据和功能上的统一。


通常说来,接入点是可以通过接口进行访问的(使用与接口相同的Key ID和Key Code),只有在接入点定义支持的情况下(即支持以接入点的方式订阅的情况下),接口才能通过单独的Key ID和Key Code进行访问。接入点使用接口进行访问时,接入点与接口共享订阅的资源。


需要注意,某些订阅方案中,是不支持某些细化的接入点的调用的,因为这些接入点可能提供一些高级或更消耗资源的功能。