Briggy API (v1)

Co je dostupné

V v1 jen čtení zveřejněných brigád — žádný zápis, žádný přístup k datům studentů nebo firem. Víc zdrojů (např. firmy, kategorie) plánujeme přidat později.

Autentizace

Klíč si vytvoříš na /developer (nutný účet na Briggy). Pošli ho v hlavičce:

Authorization: Bearer briggy_live_...

Rate limit

30 požadavků za minutu, zdarma. Po překročení dostaneš 429 s hlavičkou Retry-After.

GET /api/v1/listings

Seznam zveřejněných brigád, nejnovější první. Volitelné query parametry: page (výchozí 1), limit (výchozí 20, max 50).

curl -H "Authorization: Bearer briggy_live_..." \
  "https://briggy.dev/api/v1/listings?page=1&limit=20"

{
  "data": [
    {
      "id": "…",
      "title": "Brigádník/ce do kavárny",
      "description": "…",
      "category": "gastro",
      "city": "Brno",
      "region": "JHM",
      "pay_type": "hourly",
      "pay_amount": 180,
      "min_age": 15,
      "start_date": null,
      "end_date": null,
      "published_at": "2026-08-01T10:00:00.000Z",
      "company": { "name": "Kavárna Portrét", "logo_url": "…" }
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 42 }
}

GET /api/v1/listings/:id

Jedna zveřejněná brigáda. Vrátí 404, pokud neexistuje nebo není zveřejněná.

curl -H "Authorization: Bearer briggy_live_..." \
  "https://briggy.dev/api/v1/listings/<id>"

Chyby

• 401 — chybí nebo neplatný klíč
• 404 — brigáda neexistuje / není zveřejněná
• 429 — překročený rate limit