Clubs

API Matrix

Minimal Request/Response Pattern

Request example (createClub):

{
  "name": "Zapry Builders",
  "description": "Official builders club"
}

Response example:

{
  "ok": true,
  "result": {
    "club_id": "club_123"
  }
}

Error Handling

• 401: Auth failure. Terminate flow.
• 429: Rate limit hit. Delay retry.
• Business error: Invalid parameters or insufficient permissions. Return clear reason.
• Target not found: Invalid club ID. Return explainable failure.

Security Notes

• Club profile updates must log operator and change diff.
• Club posts must comply with content safety requirements.
• High-frequency bulk updates require throttling and human review support.
• Do not use club management APIs for group chat management (separation of concerns).

Examples

See examples.md in this directory.