🧭 COLLECTIONS

API foundations

Start with the documented surface, not an assumed one.

An API discovery project begins with an agreed scope and a source that the team is authorized to inspect. This collection focuses on how to turn those materials into a catalog people can review. The important output is not an impressive endpoint count; it is a clear record of what each operation means and where the evidence comes from.

Use these guides to distinguish specification statements from sample responses, preserve provider versions, and make unknown fields visible. A collection timestamp should not masquerade as a review, and an observed request should not become a promise of complete access.

Begin with the specification-first guide below, then visit the sample catalog documentation. For the next step, follow the developer workflows collection to bring reviewed records into a coding task. This path suits a first small project as well as a team trying to make an existing catalog easier to maintain.

1 field note in this collection