Skip to content

Bruno Collection

A pre-built Bruno collection covering every endpoint of the ADAM API, organised by tag group (OGC Common, OGC Features, OGC Tiles, Map Viewer). Drop-in for developers who prefer a versioned local API client over Swagger UI.

Why Bruno

Bruno is an open-source, git-friendly API client. Collections are stored as plain-text .bru files in a directory (no proprietary export format), so they version cleanly and travel with the repo. Useful when you want to:

  • Keep a personal scratchpad of requests with named environments
  • Share a curated set of "useful queries" with teammates
  • Run requests offline / from a CLI in CI

Get the collection

  1. Download the bundled archive: wfp-adam-bruno.zip (~14 KB)
  2. Extract it somewhere on disk — you'll get a WFP ADAM/ directory
  3. Install Bruno → usebruno.com/downloads
  4. In Bruno: Collection → Open Collection → pick the extracted WFP ADAM/ directory

  5. The bundled environment Environment 1 ships with baseUrl: /api. Edit it (or create a new one) to point at the live server:

    baseUrl: https://api.adam.geospatial.wfp.org/api

What's inside

Folder Endpoints Reference
OGC_Common GET / (Landing), GET /conformance API Overview
OGC_Features_API /collections, /collections/{id}, /queryables, /items, /items/{itemId} API — Features
OGC_Tiles_API /tileMatrixSets, /collections/{id}/tiles/..., TileJSON, StyleJSON API — Tiles
Map_Viewer /collections/{id}/tiles/{tms}/map.html Built-in HTML map

Each request comes with Accept: application/geo+json already set in the headers and example 200/422 response bodies captured from real calls — Bruno's "Send" button gives you live data instantly.

Conventions

  • Path placeholders default to :collectionId = adam.adam_eq_events and :tileMatrixSetId = WebMercatorQuad. Change them in the Path tab to target other collections or matrix sets.
  • Query parameters prefixed with ~ in the .bru files are disabled by default (Bruno convention). Toggle them on in the Query tab to use, e.g. enable filter=mag >= 6.0 on the Items request.
  • Auth is set to inherit everywhere — the API is public, so the parent collection's "no auth" applies.

Pairs well with

Live references