openapi: 3.0.4
info:
  title: Altitude Web API
  description: |-
    The API for the Altitude website
  version: 1.0.0
servers:
  - url: https://alttd.com/api/v3
components:
  schemas:
    PermissionClaim:
      $ref: './schemas/permissions/permissions.yml#/components/schemas/PermissionClaim'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
tags:
  - name: history
    description: Retrieves punishment history
  - name: team
    description: Retrieves information about the staff team
  - name: particles
    description: All actions related to particles
paths:
  /team/{team}:
    $ref: './schemas/team/team.yml#/getTeam'
  /history/{userType}/search/{type}:
    $ref: './schemas/bans/bans.yml#/getUserNames'
  /history/{userType}/name/{type}/{user}/{page}:
    $ref: './schemas/bans/bans.yml#/getHistoryForUsers'
  /history/{userType}/name/{type}/{page}:
    $ref: './schemas/bans/bans.yml#/getHistoryForAll'
  /history/{userType}/uuid/{type}/{uuid}/{page}:
    $ref: './schemas/bans/bans.yml#/getHistoryForUuid'
  /history/{userType}/search-results/uuid/{type}/{uuid}:
    $ref: './schemas/bans/bans.yml#/getTotalResultsForUuidSearch'
  /history/{userType}/search-results/user/{type}/{user}:
    $ref: './schemas/bans/bans.yml#/getTotalResultsForUserSearch'
  /history/single/{type}/{id}:
    $ref: './schemas/bans/bans.yml#/getHistoryById'
  /history/all/{uuid}:
    $ref: './schemas/bans/bans.yml#/getAllHistoryForUUID'
  /history/total:
    $ref: './schemas/bans/bans.yml#/getTotalPunishments'
  /appeal/update-mail:
    $ref: './schemas/forms/appeal/appeal.yml#/UpdateMail'
  /appeal/minecraft-appeal:
    $ref: './schemas/forms/appeal/appeal.yml#/MinecraftAppeal'
  /appeal/discord-appeal:
    $ref: './schemas/forms/appeal/appeal.yml#/DiscordAppeal'
  /login/requestNewUserLogin/{uuid}:
    $ref: './schemas/login/login.yml#/RequestNewUserLogin'
  /login/userLogin/{code}:
    $ref: './schemas/login/login.yml#/UserLogin'
  /files/save/{filename}:
    $ref: './schemas/particles/particles.yml#/SaveFile'
  /files/save/{uuid}/{filename}:
    $ref: './schemas/particles/particles.yml#/SaveFileForUser'
  /files/download/{filename}/{secret}:
    $ref: './schemas/particles/particles.yml#/DownloadFile'
  /files/download/{uuid}/{filename}:
    $ref: './schemas/particles/particles.yml#/DownloadFileForUser'