Competition API

📋 Table of Contents

• Overview

• Competition Management

• Competition Operations

• Competition Analytics

• Error Responses

Overview

The Competition API provides competition management for the STAR ecosystem. It handles competition creation, participation, scoring, and leaderboards.

Competition Management

Get All Competitions

GET /api/competition
Authorization: Bearer YOUR_TOKEN

Get Competition by ID

GET /api/competition/{competitionId}
Authorization: Bearer YOUR_TOKEN

Create Competition

POST /api/competition
Authorization: Bearer YOUR_TOKEN

Update Competition

PUT /api/competition/{competitionId}
Authorization: Bearer YOUR_TOKEN

Delete Competition

DELETE /api/competition/{competitionId}
Authorization: Bearer YOUR_TOKEN

Competition Operations

Join Competition

POST /api/competition/{competitionId}/join
Authorization: Bearer YOUR_TOKEN

Submit Score

POST /api/competition/{competitionId}/score
Authorization: Bearer YOUR_TOKEN

Get Leaderboard

GET /api/competition/{competitionId}/leaderboard
Authorization: Bearer YOUR_TOKEN

Get Participants

GET /api/competition/{competitionId}/participants
Authorization: Bearer YOUR_TOKEN

Competition Analytics

Get Competition Stats

GET /api/competition/stats
Authorization: Bearer YOUR_TOKEN

Get Competition Performance

GET /api/competition/performance
Authorization: Bearer YOUR_TOKEN

Error Responses

Competition Not Found

{
  "result": null,
  "isError": true,
  "message": "Competition not found"
}

Already Joined

{
  "result": null,
  "isError": true,
  "message": "Already joined competition"
}

---

Navigation

← Previous: Quests API | Next: Chat API →