# Postman / Bruno / Insomnia setup

Two ways to drive the v1 API from a desktop client.

## Option A — Drop in the pre-built collection (fastest)

1. Download `docs/postman-collection.json` from this repo.
2. In Postman: **File → Import → Upload** → pick the file.
3. Open the collection's **Variables** tab and set `api_key` to your
   `rc360_...` value (mint one at https://regcheck360.com/developer).
4. Hit any request. Auth is wired up via collection-level Bearer token.

Folders included: Compliance checks · Account · Webhooks · Discovery · v1.1 envelope.

## Option B — Import from the live OpenAPI spec

The canonical contract is served at `https://regcheck360.com/api/openapi.json`
(or `.yaml`). Postman auto-generates a collection from it.

1. In Postman: **File → Import → Link** → paste
   `https://regcheck360.com/api/openapi.json`.
2. Postman creates a collection mirroring every operation in the spec.
3. Same auth setup (collection variable `api_key`).

Use this when the spec gets ahead of the committed collection file.

## Bruno / Insomnia / other clients

Both natively import OpenAPI 3.1. Point them at the same URL.

## Smoke check

```
GET https://regcheck360.com/api/v1/whoami
Authorization: Bearer rc360_...
```

A 200 confirms the key works. Then `GET /api/v1/usage` shows your plan and
current-month consumption.