当前,关于API治理的讨论多聚焦于设计治理,即确保API设计的统一。此为治理的基础,因为设计的不协调会带来严重问题。
尽管应重视企业API设计治理策略,但我们主张扩大视野,关注“平台API治理”。这包括对每个API的发现、可靠性、一致性、交付及可观测性的投入,以及其周边运营的管理。
大部分致力于API治理的客户,或初涉治理,寻求指导;或已投身设计治理,却面临在各团队间及API间实现治理一致性的难题。
若未识别出团队、API及跨运营工作的状况,则难以在大规模环境下实施设计治理。同样,若无法在大规模环境下进行观测与质量评估,便不能推广治理至更多团队。
深入践行“以API为中心”理念的组织,通常从更广义的平台视角看待治理,确保API的可发现性、可靠性、设计一致性,以及通过明确的生命周期交付,同时确保过程中的一切均可被观察。
API定义
我们观察到企业组织在API治理方面遇到困难的一个原因是,不仅API本身缺乏发现性,围绕每个API的工件、文档以及其他所有工作也缺乏发现性。你无法治理你找不到的东西,而API及其背后的操作越可见,API治理就越有可能深入人心。
平台API治理的基础是确保发现是您的操作中的默认设置:
工作区:确保每个API都有一个私有、合作伙伴或公共工作区来访问每个API周围的操作。
OpenAPI:确保始终有一个人类和机器可读的API工件可用作每个API的真实来源。
Repository:为每个API建立一个Get储存库,将