Endpoint

Pošlete tělo v JSON a klíč v hlavičce X-API-KEY (ne Authorization: Bearer).

Názvy polí jsou v camelCase, v požadavcích i odpovědích: clubId, createdAt. Název s podtržítkem, například club_id, je odmítnut s kódem 400 PUBLIC_API_SNAKE_CASE_FIELD a odpověď uvede pole, které máte poslat místo něj.

contentstring

text příspěvku, 1–2000 znaků. Povinné.

clubIduuid | null

klub, za který publikujete. Volitelné – bez něj jde příspěvek do vašeho osobního feedu.

curl -X POST https://api.amator.app/api/v1/public/posts \
  -H "X-API-KEY: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"content":"Training moved to 19:00 tonight"}'

Při úspěchu dostanete 201 a odkaz na příspěvek:

HTTP/1.1 201 Created

{
  "success": true,
  "data": {
    "id": "…",
    "destination": "club",
    "clubId": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-10-05T18:00:00.000Z",
    "url": "https://amator.app/posts/…",
    "media": []
  },
  "requestId": "…"
}

FotkyKopírovat odkaz na sekci

Chcete-li publikovat fotky, pošlete stejná pole jako multipart/form-data místo JSON a přidejte až 4 soubory v poli photos – zobrazí se v pořadí, v jakém je pošlete. Jen text, jen fotky, nebo obojí: content můžete vynechat, pokud posíláte alespoň jednu fotku.

photossoubor, až 4

JPEG, PNG nebo WebP, každá do 5 MB. Žádné video.

curl -X POST https://api.amator.app/api/v1/public/posts \
  -H "X-API-KEY: YOUR_API_KEY_HERE" \
  -H "Idempotency-Key: 9b2f6d4e-1c3a-4f5b-8e7d-2a1c0b9f8e7d" \
  -F content="Match day! Kick-off at 18:00" \
  -F clubId=00000000-0000-0000-0000-000000000000 \
  -F photos=@a.jpg \
  -F photos=@b.jpg

Limity: 40 fotek denně na jeden API klíč; celý požadavek nejvýše 4 fotky a text. Všechno, nebo nic – když cokoli selže, neuloží se žádná fotka a nic se nepublikuje. Pošlete hlavičku Idempotency-Key (UUID) a opakovaný pokus po vypršení času vrátí první příspěvek, místo aby ho publikoval podruhé.

Další odpovědiKopírovat odkaz na sekci

• 400FEED_POST_EMPTY

  Text příspěvku je prázdný nebo příliš dlouhý.

• 400PUBLIC_API_SNAKE_CASE_FIELD

  Název pole s podtržítkem, například club_id – details.fields uvádí název v camelCase, který máte poslat (clubId).

• 401PUBLIC_API_KEY_INVALID

  Klíč chybí, je neznámý nebo zrušený.

• 403FEED_NOT_A_CAPTAIN

  Nejste vlastníkem ani správcem tohoto klubu.

• 404FEED_TEAM_NOT_FOUND

  Klub s tímto clubId neexistuje.

• 429PUBLIC_API_RATE_LIMITED

  Na toto místo jste v této hodině už publikovali.

• 429FEED_DAILY_LIMIT_REACHED

  Vyčerpali jste denní limit feedu – 40 příspěvků za den.

• 400PUBLIC_API_TOO_MANY_PHOTOS

  Víc než 4 fotky v jednom příspěvku.

• 400IMAGE_INVALID_FILE_TYPE

  Fotka není JPEG, PNG ani WebP – například video.

• 400IMAGE_FILE_TOO_LARGE

  Fotka má víc než 5 MB.

• 400PUBLIC_API_MULTIPART_INVALID

  Formulář nejde přečíst – soubor mimo photos nebo pole poslané dvakrát.

• 413PUBLIC_API_BODY_TOO_LARGE

  Požadavek je větší než 4 fotky a text.

• 429PUBLIC_API_PHOTO_DAILY_LIMIT

  Tento API klíč už publikoval svých 40 fotek za posledních 24 hodin.