Google API Design Guidance (AIPs)
API Improvement Proposals are the numbered design documents Google uses for its APIs, covering resource-oriented design, standard methods, naming, pagination, field masks, long-running operations and errors. Each AIP explains the rule and the reasoning behind it, which makes the collection a strong reference for designing consistent APIs at scale. It leans towards gRPC and Protocol Buffers, so REST-only teams will need to translate some parts.
Guide
Web Development
Ongoing reference
Advanced
Free
API Improvement Proposals are the numbered design documents Google uses for its APIs, covering resource-oriented design, standard methods, naming, pagination, field masks, long-running operations and errors. Each AIP explains the rule and the reasoning behind it, which makes the collection a strong reference for designing consistent APIs at scale. It leans towards gRPC and Protocol Buffers, so REST-only teams will need to translate some parts.
Ready to start?
Opens on Google in a new tab.
Stuck on something specific?
Writing only gets you so far. If you want an answer to your situation rather than the general case, book a session and we will work through it together. Sessions are free for approved Sefism members, and a few slots open each week.
Follow along
New writing, resources and project ideas land here first.