openapi: 3.0.0
info:
  title: Mieux Voter
  description: A poll application based on Majority Judgment.
  version: 1.0.1-oas3
  termsOfService: 'https://github.com/MieuxVoter'
  contact:
    name: Mieux Voter app developpers team
    email: app@mieuxvoter.fr
servers:
  - url: 'https://api.mieuxvoter.fr/v1'
    description: Main (production) server
  - url: 'https://sandboxapi.mieuxvoter.fr/v1'
    description: Internal staging server for testing
paths:
  /polls:
    $ref: paths/polls.yaml
  '/polls/{poll-id}':
    $ref: 'paths/polls@{poll-id}.yaml'
  '/polls/{poll-id}/ballots':
    $ref: 'paths/polls@{poll-id}@ballots.yaml'
  '/polls/{poll-id}/ballots/{ballot-id}':
    $ref: 'paths/polls@{poll-id}@ballots@{ballot-id}.yaml'
  '/polls/{poll-id}/judges':
    $ref: 'paths/polls@{poll-id}@judges.yaml'
  '/polls/{poll-id}/judges/{judge-id}/':
    $ref: 'paths/polls@{poll-id}@judges@{judge-id}@.yaml'
  '/polls/{poll-id}/results':
    $ref: 'paths/polls@{poll-id}@results.yaml'
components:
  securitySchemes:
    judgeAuth:
      type: http
      scheme: bearer
    pollAuth:
      type: http
      scheme: bearer
    resultAuth:
      type: http
      scheme: bearer