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}/participants':
    $ref: 'paths/polls@{poll-id}@participants.yaml'
  '/polls/{poll-id}/participants/{participant-id}/':
    $ref: 'paths/polls@{poll-id}@participants@{participant-id}@.yaml'
  '/polls/{poll-id}/results':
    $ref: 'paths/polls@{poll-id}@results.yaml'
  /users:
    $ref: paths/users.yaml
  '/users/{user-id}':
    $ref: 'paths/users@{user-id}.yaml'
components:
  securitySchemes:
    participantAuth:
      type: http
      scheme: bearer
    pollAuth:
      type: http
      scheme: bearer
    resultAuth:
      type: http
      scheme: bearer
    userAuth:
      type: http
      scheme: bearer