Hello API Key

Goal: Confirm your API key works and you know what a Discovery 401 looks like.
Prep time: ~1 minute

What you’ll use

GET /flynet/v1/restaurants with X-API-Key: <key>

Code

const res = await fetch(
  "https://api.staging.blackbird.xyz/flynet/v1/restaurants?page=0&page_size=1",
  { headers: { "X-API-Key": process.env.API_KEY! } },
);

if (res.status === 401) {
  console.log(await res.json());
} else {
  console.log(res.status, await res.json());
}

curl -i "https://api.staging.blackbird.xyz/flynet/v1/restaurants?page=0&page_size=1" \
  -H "X-API-Key: $API_KEY"

200 returns { "restaurants": [...], "pagination": {...} }. A missing or invalid key returns 401 with a JSON envelope, different from the OAuth empty-body 401:

{
  "status": 401,
  "message": "API key is required. Include your key in the X-API-Key header.",
  "error_code": "MISSING_API_KEY"
}

Discovery 401s are JSON. OAuth 401s are empty-body. The two envelopes are not interchangeable; see Pagination + errors.

Next: Fetch a restaurant list: paginate the Discovery surface.

Hello OAuth Fetch a restaurant list

Overview

Components

Appetizers

Mains

Specials

Hello API Key

Hello API Key

What you’ll use

Code

​Hello API Key

​What you’ll use

​Code

Hello API Key

What you’ll use

Code