Veřejné API + n8n

Co to umí

Jeden endpoint zveřejní vaším jménem textový příspěvek — na jedno ze dvou míst:

• Do vašeho osobního feedu — club_id prostě vynechte.
• Do klubu, který spravujete — pošlete jeho club_id. Musíte být vlastníkem nebo správcem klubu, stejné pravidlo jako při publikování za klub v aplikaci.

Jak získat API klíč

1. Otevřete aplikaci Amator a přejděte do Nastavení › API klíče.
2. Klepněte na Vytvořit a pojmenujte klíč tak, abyste ho později poznali, např. „n8n“.
3. Klíč hned zkopírujte — zobrazí se jen jednou. Pokud ho ztratíte, zrušte ho a vytvořte nový.

Zacházejte s klíčem jako s heslem: kdo ho má, může publikovat vaším jménem. Každý klíč můžete kdykoli zrušit na stejné obrazovce — požadavky s ním pak budou odmítnuty.

Endpoint

POST https://api.amator.app/api/v1/public/posts

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

• content string — text příspěvku, 1–2000 znaků. Povinné.
• club_id uuid | null — klub, za který publikujete. Volitelné — bez něj jde příspěvek do vašeho osobního feedu.

Příspěvek do 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říspěvek za klub

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":"Match day! Kick-off at 18:00","club_id":"00000000-0000-0000-0000-000000000000"}'

Úspěšný příspěvek vrátí 201 a odkaz na něj:

HTTP/1.1 201 Created

{
  "success": true,
  "data": {
    "id": "…",
    "destination": "club",
    "club_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2026-10-05T18:00:00.000Z",
    "url": "https://web.amator.app/posts/…"
  },
  "requestId": "…"
}

Jeden příspěvek za hodinu — pro každé místo zvlášť

Každé místo má vlastní hodinový limit: váš profil je jedno místo, každý klub další. Limity se nikdy nesčítají — příspěvek na jednom místě nečerpá limit jiného a volné místo jinde nepomůže tam, kde je limit vyčerpaný.

• OK Váš profil a klub A během jedné hodiny
• OK Kluby A, B a C během jedné hodiny
• 429 Druhý příspěvek do klubu A během hodiny — 429, i když profil a ostatní kluby jsou volné

Když je limit vyčerpaný, dostanete 429 s hlavičkou Retry-After (v sekundách) a podrobnostmi v těle:

HTTP/1.1 429 Too Many Requests
Retry-After: 2400

{
  "success": false,
  "error": {
    "code": "PUBLIC_API_RATE_LIMITED",
    "message": "This club already had its post this hour",
    "details": {
      "destination": "club",
      "club_id": "00000000-0000-0000-0000-000000000000",
      "retry_after_seconds": 2400,
      "next_allowed_at": "2026-10-05T19:00:00.000Z"
    }
  },
  "requestId": "…"
}

Než na toto místo znovu publikujete, počkejte aspoň Retry-After sekund nebo do next_allowed_at. Neopakujte požadavky ve smyčce.

Další odpovědi

• 400 FEED_POST_EMPTY
  Text příspěvku je prázdný nebo příliš dlouhý.
• 401 PUBLIC_API_KEY_INVALID
  Klíč chybí, je neznámý nebo zrušený.
• 403 FEED_NOT_A_CAPTAIN
  Nejste vlastníkem ani správcem tohoto klubu.
• 404 FEED_TEAM_NOT_FOUND
  Klub s tímto club_id neexistuje.
• 429 PUBLIC_API_RATE_LIMITED
  Na toto místo už v této hodině příspěvek byl.
• 429 FEED_DAILY_LIMIT_REACHED
  Byl vyčerpán denní limit feedu — 40 příspěvků za den.

Hotový workflow pro n8n

Pět uzlů: ruční start, uzel Edit Fields s poli content a club_id, uzel If, který kontroluje, zda je club_id prázdné, a dva uzly HTTP Request — jeden publikuje do profilu, druhý do klubu.

Začíná ručním spouštěčem, abyste ho mohli vyzkoušet hned po importu. Až bude fungovat, nahraďte Start tím, co ho má skutečně spouštět — Schedule, RSS, formulář — a namapujte jeho výstup na obě pole.

{
  "name": "Amator — publish a post",
  "nodes": [
    {
      "id": "7b0f3a52-1c6e-4d1b-9a43-5e2f8c1d0a01",
      "name": "Start",
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        0,
        0
      ],
      "parameters": {}
    },
    {
      "id": "7b0f3a52-1c6e-4d1b-9a43-5e2f8c1d0a02",
      "name": "Post content",
      "type": "n8n-nodes-base.set",
      "typeVersion": 3.4,
      "position": [
        220,
        0
      ],
      "parameters": {
        "mode": "manual",
        "assignments": {
          "assignments": [
            {
              "id": "7b0f3a52-1c6e-4d1b-9a43-5e2f8c1d0b01",
              "name": "content",
              "value": "Hello from n8n! Training moved to 19:00 tonight.",
              "type": "string"
            },
            {
              "id": "7b0f3a52-1c6e-4d1b-9a43-5e2f8c1d0b02",
              "name": "club_id",
              "value": "",
              "type": "string"
            }
          ]
        },
        "options": {}
      }
    },
    {
      "id": "7b0f3a52-1c6e-4d1b-9a43-5e2f8c1d0a03",
      "name": "Club ID empty?",
      "type": "n8n-nodes-base.if",
      "typeVersion": 2.2,
      "position": [
        440,
        0
      ],
      "parameters": {
        "conditions": {
          "options": {
            "caseSensitive": true,
            "leftValue": "",
            "typeValidation": "loose",
            "version": 2
          },
          "conditions": [
            {
              "id": "7b0f3a52-1c6e-4d1b-9a43-5e2f8c1d0c01",
              "leftValue": "={{ $json.club_id }}",
              "rightValue": "",
              "operator": {
                "type": "string",
                "operation": "empty",
                "singleValue": true
              }
            }
          ],
          "combinator": "and"
        },
        "looseTypeValidation": true,
        "options": {}
      }
    },
    {
      "id": "7b0f3a52-1c6e-4d1b-9a43-5e2f8c1d0a04",
      "name": "Post to my profile",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        680,
        -120
      ],
      "parameters": {
        "method": "POST",
        "url": "https://api.amator.app/api/v1/public/posts",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "X-API-KEY",
              "value": "YOUR_API_KEY_HERE"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={{ JSON.stringify({ content: $json.content }) }}",
        "options": {}
      }
    },
    {
      "id": "7b0f3a52-1c6e-4d1b-9a43-5e2f8c1d0a05",
      "name": "Post to club",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        680,
        120
      ],
      "parameters": {
        "method": "POST",
        "url": "https://api.amator.app/api/v1/public/posts",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "X-API-KEY",
              "value": "YOUR_API_KEY_HERE"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={{ JSON.stringify({ content: $json.content, club_id: $json.club_id }) }}",
        "options": {}
      }
    }
  ],
  "connections": {
    "Start": {
      "main": [
        [
          {
            "node": "Post content",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Post content": {
      "main": [
        [
          {
            "node": "Club ID empty?",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Club ID empty?": {
      "main": [
        [
          {
            "node": "Post to my profile",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "Post to club",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "settings": {},
  "pinData": {}
}