documentationSwagger.yaml

openapi: 3.0.0
info:
  title: TRIPP
  description: |-
    Tripp adalah sebuah layanan yang digunakan untuk melakukan pemesanan tiket pesawat secara online. Dengan Tripp pengguna dapat memilih penerbangan berdasarkan jadwal dan maskapai, serta melakukan pembayaran secara online. 
  contact: 
    email: 202410102062@mail.unej.ac.id
  version: 1.0.0
servers:
  - url: http://localhost:8000
    description: Test local computer
  - url: https://composed-beds-develop.up.railway.app
    description: Staging
  - url: https://composed-beds-production.up.railway.app
    description: Production
tags:
  - name: Users
    description: Mengolah data user dan proses autentikasi
  - name: Flights
    description: Informasi mengenai jadwal penerbangan
  - name: Transactions
    description: Melayani booking tiket pesawat
  - name: Payments
    description: Menangani proses pembayaran
  - name: Tickets
    description: Menyediakan informasi tiket
  - name: Notifications
    description: Mendapatkan Informasi penerbangan
paths:
  /auth/register:
    post:
      tags:
        - Users
      summary: Mendaftarkan user baru
      description: |-
        Registrasi user diperlukan agar user dapat melakukan log in. Inputan pada tiap field harus sesuai ketentuan, diantaranya adalah:
        
        - Password minimal mengandung 6 karakter dengan menyertakan minimal 1 huruf kecil [a-z], minimal 1 huruf besar [A-Z] , dan minimal 1 karakter angka [0-9]
        - Email yang telah teregister tidak dapat digunakan kembali
        - Phone_number memiliki tipe data string
      operationId: post-register-user
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  example: sabrina
                email:
                  type: string
                  example: sabrina@mail.com
                phone_number:
                  type: string
                  example: 085232128434
                password:
                  type: string
                  example: fA077f
                confirmPassword:
                  type: string
                  example: fA077f
      responses:
        "201":
          description: User Registered
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: OTP has been sent, expired in 10 minutes, please check your email!
                  data:
                    example: null
        "400":
          description: Error Bad Request
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Name is required!
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Email is already used!
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Phone Number is not valid
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Email is not valid
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Password minimum 6 characters, must contain uppercase, lowercase, and number!
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: password and confirm password doesn't match!!!
                      data: 
                        example: null
              examples:
                duplicated-email:
                  summary: Jika email sudah digunakan
                  value:
                    status: false
                    message: Email is already used!
                    data: null
                required-data-is-not-provided:
                  summary: Jika data yang dibutuhkan tidak tersedia
                  value:
                    status: false
                    message: Name is required!
                    data: null
                phone-number-is-not-valid:
                  summary: Jika phone_number tidak valid
                  value:
                    status: false
                    message: Phone Number is not valid
                    data: null
                email-is-not-valid:
                  summary: Jika email tidak valid
                  value:
                    status: false
                    message: Email is not valid
                    data: null
                password-is-not-valid:
                  summary: Jika password tidak valid
                  value:
                    status: false
                    message: Password minimum 6 characters, must contain uppercase, lowercase, and number!
                    data: null
                password-confirmPassword-doesn't-match:
                  summary: Jika password dan conformPassword tidak cocok
                  value:
                    status: false
                    message: password and confirm password doesn't match
                    data: null
                    
  /auth/login:
    post:
      tags:
        - Users
      summary: Mendapatkan token autentikasi
      description: Token autentikasi diperlukan untuk mengakses beberapa endpoint yang dilindungi seperti transactions dan payment.
      operationId: post-login-user
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                  example: sabrina@mail.com
                password:
                  type: string
                  example: fA077f
      responses:
        "200":
          description: Login success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Login success!
                  data: 
                    type: object
                    properties:
                      token:
                        type: string
                        example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Mywicm9sZSI6InVzZXIiLCJpYXQiOjE2ODcxNjg3MDR9.H4k4sMd2XH8AiWMRxdgelXMBb0DlC5nQiTEWAxyUzIU
        "401":
          description: Email belum terverifikasi
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Account is not activated, please check your email, and verify the otp!
                  data: 
                    example: null
        "400":
          description: Error Bad Request
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Field email is required!
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Email is not valid!
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Email is not registered!, please register first!
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Password is incorrect
                      data: 
                        example: null
              examples:
                required-data-is-not-provided:
                  summary: Jika data yang dibutuhkan tidak tersedia
                  value:
                    status: false
                    message: Field email is required!
                    data: null
                email-is-not-valid:
                  summary: Jika email tidak valid
                  value:
                    status: false
                    message: Email is not falid!
                    data: null
                password-is-incorrect:
                  summary: Jika password tidak valid
                  value:
                    status: false
                    message: Password is incorrect
                    data: null
                email-is-not-registered:
                  summary: Jika email tidak terdaftar
                  value:
                    status: false
                    message: Email is not registered!, please register first!
                    data: null
  /auth/verify-otp:
    post:
      tags:
        - Users
      summary: Mendapatkan kode verify-otp
      description: token menandakan user sudah login
      operationId: post-verify-otp-user
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                  example: fitriandriyani07012002@gmail.com
                otp:
                  type: string
                  example: prxuEx
      responses:
        "200":
          description: User Verified
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Success Verified The OTP!
                  data:
                    example: null
        
        "400":
          description: Error Bad Request
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Email is required!
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: OTP is required!
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Email is not registered!
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: You're Not Request OTP Yet!
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: OTP is expired!
                      data:
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: OTP is Not Valid!
                      data:
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Activation account failed!
                      data:
                        example: null
              examples:
                required-data-is-not-provided:
                  summary: Jika Email tidak ada
                  value:
                    status: false
                    message: Email is required!
                    data: null
                otp-is-required:
                  summary: Jika OTP diperlukan
                  value:
                    status: false
                    message: OTP is required!
                    data: null
                email-is-not-registered:
                  summary: Jika email tidak terdaftar
                  value:
                    status: false
                    message: Email is not registered!
                    data: null
                otp-is-request:
                  summary: Jika meminta kode OTP
                  value:
                    status: false
                    message: You're Not Request OTP Yet!
                    data: null
                user-otp-expiration-time:
                  summary: Jika OTP sudah kadaluwarsa
                  value:
                    status: false
                    message: OTP is expired!
                    data: null
                otp-failed-verified:
                  summary: Jika OTP tidak valid
                  value:
                    status: false
                    message: OTP is Not Valid!
                    data: null
                if the account fails to be verified:
                  summary: jika akun gagal diverifikasi
                  value:
                    status: false
                    message: Activation account failed!
                    data: null
  /auth/resend-otp:
    post:
      tags:
        - Users
      summary: Kirim Ulang OTP
      description: validasi jika pengguna sudah meminta kirim ulang otp untuk membatasi permintaan
      operationId: post-resend otp-user
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                  example: fitriandriyani07012002@gmail.com
      responses:
        "201":
          description: Login success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: OTP has been sent, expired in 10 minutes, please check your email!
                  data: 
                    type: string
                    example: null
        "400":
          description: Error Bad Request
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Failed Send the OTP!
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: You have already requested resend otp, check your email please
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Email is not registered!
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Email is not valid
                      data: 
                        example: null
              examples:
                failed-send-otp:
                  summary: Jika pengguna mencoba memverifikasi otp tetapi tidak mengirim permintaan
                  value:
                    status: false
                    message: Failed Send the OTP!
                    data: null
                resend-otp:
                  summary: Meminta kirim ulang OTP
                  value:
                    status: false
                    message: You have already requested resend otp, check your email please
                    data: null
                email-not-registed:
                  summary: Jika email tidak terdaftar
                  value:
                    status: false
                    message: Email is not registered!
                    data: null
                email-not-valid:
                  summary: Jika email tidak divalidasi
                  value:
                    status: false
                    message: Email is not valid!
                    data: null
  /auth/forgot-password:
    post:
      tags:
        - Users
      summary: Mengirim tautan reset password ke email pengguna
      description:  Data permintaan reset password
      operationId: post-forgot passsword-user
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                  example: fitriandriyani07012002@gmail.com
      responses:
        "200":
          description: mengirim tautan reset password ke email pengguna
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Success send link reset password to your email!
                  data: 
                    type: string
                    example: null
        "400":
          description: Error Bad Request
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: email not found!
                      data: 
                        example: null
              examples:
                email-not-found:
                  summary: Jika pengguna mencoba memverifikasi email
                  value:
                    status: false
                    message: email not found!
                    data: null
  /users/{id}:
    get:
      tags:
        - Users
      summary: Mendapatkan detail pengguna
      description: Detail user
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: integer
            example: 1
          description: id of user
      responses:
        "200":
          description: Success Mendapatkan data user
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                    example: success
                  data: 
                    type: object
                    properties:
                      id:
                        type: integer
                        example: 
                      name:
                        type: string
                        example: fitri andriyani
                      email:
                        type: string
                        example: fitriandriyani07012002@gmail.com
                      password:
                        type: string
                        example: $2b$10$NcB2dn7Dn1fXURWbTQd.0eFGB8Uu6Ca5W5/qmolvxuxVJgaNPg4Ra
                      phone_number:
                        type: string
                        example: 085232128432
                      otp:
                        type: string
                        example: sipUzs
                      otp_experation_time:
                        type: string
                        example: 2023-06-20T11:53:20.615Z
                      role:
                        type: string
                        example: user
                      user_type:
                        type: string
                        example: basic
                      is_verified:
                        type: boolean
                        example: true
                      created_at:
                        type: string
                        example: 2023-06-20T11:44:39.696Z
                      updated_at:
                        type: string
                        example: 2023-06-20T11:52:20.615Z
      security:
        - jwt_token: []
    put:
      tags:
        - Users
      summary: Mengupdate data pengguna
      description: Mengupdate data pengguna
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: integer
            example: 1
          description: id of user
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  example: Fitri Andriyani
      responses:
        "200":
          description: Success Update Data
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                    example: success
                  data: 
                    type: integer
                    example: 1
      security:
        - jwt_token: []
  /flights:
    post:
      tags:
        - Flights
      summary: Digunakan untuk mencari jadwal penerbangan 
      description: Digunakan untuk mencari jadwal penerbangan 
      operationId: post-flight-flights
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                origin_airport:
                  type: string
                  example: MLG
                destination_airport:
                  type: string
                  example: HLP
                flight_date: 
                  type: string
                  example: 2023-06-01
                passenger_cnt: 
                  type: number
                  example: 2
      responses:
        "200":
          description: Login success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Ok
                  err: 
                    type: string
                    example: null
                  data: 
                    type: object
                    properties:
                      id:
                        type: string
                        example: 216
                      flight_number:
                        type: string
                        example: ID-7580
                      departure_airport:
                        type: integer
                        example: Abdul Rachman Saleh
                      departure_code:
                        type: string
                        example: MLG
                      departure_city:
                        type: string
                        example: Malang
                      departure_country:
                        type: string
                        example: Indonesia
                      arrivall_airport:
                        type: string
                        example: Halim Perdanakusuma International Airport
                      arrivall_code:
                        type: string
                        example: HLP
                      arrivall_city:
                        type: string
                        example: Jakarta
                      arrivall_country:
                        type: string
                        example: Indonesia
                      airplane_model:
                        type: string
                        example: Airbus A320
                      airplane_code:
                        type: string
                        example: AIRBUS-A320-32
                      airline:
                        type: string
                        example: Batik Air
                      airline_code:
                        type: string
                        example: ID
                      class:
                        type: string
                        example: ECONOMY
                      price:
                        type: integer
                        example: 1007200
                      departure_terminal_name:
                        type: string
                        example: null
                      arrival_terminal_name:
                        type: string
                        example: null
                      flight_date:
                        type: string
                        example: 2023-06-01
                      departure_time:
                        type: string
                        example: 09:15
                      arrival_time:
                        type: string
                        example: 10:40
                      departure_timestamp:
                        type: integer
                        example: 1685585700
                      arrival_timestamp:
                        type: integer
                        example: 1685590800
                      flight_duration:
                        type: integer
                        example: 85
                      free_baggage:
                        type: integer
                        example: 20
                      cabin_baggage:
                        type: integer
                        example: 7
                      capacity:
                        type: integer
                        example: 192
                      purchased_ticket:
                        type: string
                        example: null
                      available_ticket:
                        type: integer
                        example: 192
        "400":
          description: Error Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Bad Request
                  data: 
                    example: null
  /flights/{id}:
    get:
      tags:
        - Flights
      summary: Menampilkan detail data penerbangan
      description: Menampilkan detail data dari suatu penerbangan
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: integer
          example: 1
        description: id of flight
      responses:
        "200":
          description: Success Mendapatkan data Penerbangan
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                    example: success
                  data: 
                    type: object
                    properties:
                      id:
                        type: integer
                        example: 5
                      flight_number:
                        type: string
                        example: ID-6540
                      class:
                        type: string
                        example: ECONOMY
                      price:
                        type: integer
                        example: 2443100
                      departure_terminal_name:
                        type: string
                        example: Terminal 2D
                      arrival_terminal_name:
                        type: string
                        example: Terminal Domestic
                      flight_date:
                        type: string
                        example: 2023-06-01
                      departure_time:
                        type: string
                        example: 02:00
                      arrival_time:
                        type: string
                        example: 06:10
                      flight_duration:
                        type: integer
                        example: 250
                      free_baggage:
                        type: integer
                        example: 20
                      cabin_baggage:
                        type: integer
                        example: 7
                      capacity:
                        type: integer
                        example: 192
                  departure: 
                    type: object
                    properties:      
                      name:
                        type: string
                        example: Soekarno Hatta International Airport
                      iata_code:
                        type: string
                        example: CGK
                      city:
                        type: string
                        example: Jakarta
                      country: 
                        type: string
                        example: Indonesia
                  arrival: 
                    type: object
                    properties:      
                      name:
                        type: string
                        example: El Tari
                      iata_code:
                        type: string
                        example: KOE
                      city:
                        type: string
                        example: Kupang
                      country: 
                        type: string
                        example: Indonesia
                  airline: 
                    type: object
                    properties:      
                      name:
                        type: string
                        example: Batik Air
                      short_name:
                        type: string
                        example: Batik
                      iata_code:
                        type: string
                        example: ID
                      icon_url:
                        type: string
                        example: https://ik.imagekit.io/tvlk/image/imageResource/2019/12/13/1576208649600-12471f9b7ffa159361f7bbbfb63065ee.png?tr=q-75
                  airplane: 
                    type: object
                    properties:      
                      model:
                        type: string
                        example: Airbus A320
                      code:
                        type: string
                        example: AIRBUS-A320-32
                      airline_code:
                        type: string
                        example: ID
                      seat_type: 
                        type: string
                        example: ABOVE_AVERAGE_LEGROOM
        "404":
          description: Error Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: The flight you are looking for is not available
                  data: 
                    example: null
            
  /flights/favorite-city:
    get:
      tags:
        - Flights
      summary: Menampilkan data penerbangan favorit
      description: Mendapatkan data penerbangan dari kota yang paling suka dikunjungi
      responses:
        "200":
          description: Success Mendapatkan data Penerbangan
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                    example: success
                  data: 
                    type: array
                    items:
                      type: object
                      properties:
                        total_transaction:
                          type: integer
                          example: 5
                        flight:
                          type: object
                          properties:
                            id:
                              type: integer
                              example: 2
                            arrival:
                              type: object
                              properties:
                                id:
                                  type: integer
                                  example: 46
                                city:
                                  type: string
                                  example: Manado
                                country:
                                  type: string
                                  example: Indonesia
        "404":
          description: Data is empty
          content:
            application/json:
              schema:
                type: object
                properties: 
                  status:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Transaction data is still empty
                  data:
                    example: null
  /flights/data:
   get:
      tags:
        - Flights
      summary: Mendapatkan sejumlah data informasi penerbangan
      description:  Mengembalikan sejumlah data penerbangan sesuai dengan query yang diberikan
      parameters:
        - in: query
          name: start
          schema:
            type: integer
          description: The number of items to starting to collect the result set
        - in: query
          name: length
          schema:
            type: integer
          description: The numbers of items to return
      responses:
        "200":
          description: Sukses mendapatkan informasi penerbangan
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    status:
                      type: boolean
                    message:
                      type: string
                      example: success
                    data:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            type: integer
                            example: 10
                          flight_number:
                            type: string
                            example: QG-300
                          departure_airport:
                            type: string
                            example: Soekarno Hatta International Airport
                          departure_code:
                            type: string
                            example: CGK
                          departure_city:
                            type: string
                            example: Jakart
                          departure_country:
                            type: string
                            example: 10
                          arrival_airport:
                            type: string
                            example: Sam Ratulangi
                          arrival_code:
                            type: string
                            example: MDC
                          arrival_city:
                            type: string
                            example: Manado
                          arrival_country:
                            type: string
                            example: Indonesia
                          airplane_model:
                            type: string
                            example: Airbus A320
                          airplane_code:
                            type: string
                            example: AIRBUS-A320-32
                          airline:
                            type: string
                            example: Citilink
                          airline_code:
                            type: string
                            example: QG
                          class:
                            type: string
                            example: ECONOMY
                          price:
                            type: number
                            format: double
                            example: 2740035
                          departure_terminal_name:
                            type: string
                            example: Terminal 3
                          arrival_terminal_name:
                            type: string
                            example: Terminal Dosmestic
                          flight_date:
                            type: string
                            format: date
                            example: 2023-06-01
                          departure_time:
                            type: string
                            example: 02:30
                          arrival_time:
                            type: string
                            example: 06:55
                          departure_timestamp:
                            type: integer
                            example:  1685561400
                          arrival_timestamp:
                            type: integer
                            example: 1685577300
                          flight_duration:
                            type: integer
                            example: 265
                          free_baggage:
                            type: integer
                            example: 20
                          cabin_baggage:
                            type: integer
                            example: 7
                          capacity:
                            type: integer
                            example: 192
                    
        "404":
          description: Error Data Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Flights data is still empty
                  data: 
                    example: null
  /transactions:
    post:
      tags:
        - Transactions
      summary: Membuat pemesanan
      description:  Pemesanan tiket penerbangan
      operationId: post-transactions-transactions
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                user_id:
                  type: integer
                  example: 1
                flight_id: 
                  type: integer
                  example: 3
                passengers: 
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                        example: Jeno
                      date_of_birth:
                        type: string
                        format: date
                        example: 07 Januari 2002
                      nationality:
                        type: string
                        example: Indonesia
                      ktp: 
                        type: integer
                        example: 202410102062
                      passport:
                        type: string
                        example: null
                      issuing_country:
                        type: string
                        example: null
                      expiration_date:
                        type: string
                        example: null
                      passenger_type:
                        type: string
                        example: bayi
                    
      responses:
        "200":
          description: Created
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Succes
                  data:
                    type: object
                    properties:
                      transactions:
                        type: object
                        properties:
                          id:
                            type: integer
                            example: 1
                          user_id: 
                            type: integer
                            example: 1
                          flight_id:
                            type: integer
                            example: 3
                          updated_at:
                            type: string
                            format: date-time
                            example: 2023-06-20T11:28:29.167Z
                          created_at:
                            type: string
                            format: date-time
                            example: 2023-06-20T11:28:29.167Z
                          passengers: 
                            type: array
                            items:
                              type: object
                              properties:
                                name:
                                  type: string
                                  example: Jeno
                                date_of_birth:
                                  type: string
                                  format: date
                                  example: 07 Januari 2002
                                nationality:
                                  type: string
                                  example: Indonesia
                                ktp: 
                                  type: integer
                                  example: 202410102062
                                passport:
                                  type: string
                                  example: null
                                issuing_country:
                                  type: string
                                  example: null
                                expiration_date:
                                  type: string
                                  example: null
                                passenger_type:
                                  type: string
                                  example: bayi
                          total_price:
                            type: integer
                            example: 2000000
        "400":
          description: Error Bad Request
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: The flight you are looking for is not available.
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: user id, flight id, and passengers data are required
                      data:
                        example: false
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: passengers data type must be an array of object
                      data:
                        example: false
              examples:
                transaction-not-found:
                  summary: Jika data penerbangan tidak ditemukan
                  value:
                    status: false
                    message: The flight you are looking for is not available.
                    data: null
                id-empty:
                  summary: Data tidak lengkap
                  value:
                    status: false
                    message: user id, flight id, and passengers data are required
                    data: null
                passengers-array:
                  summary: Jika tipe data pada body passengers tidak sesuai
                  value:
                    status: false
                    message: Passengers data type must be an array of object
                    data: null
      security:
        - jwt_token: []
    get:
      tags:
        - Transactions
      summary: Mendapatkan satu data transaksi
      description: Mendapatkan satu data transaksi berdasarkan id transaksi
      parameters:
      - in: query
        name: transaction_id
        required: true
        schema:
          type: string
          example: iEDE51rDDu3l
        description: id of transaction
      operationId: get-transaction-by-id
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Succes
                  data: 
                    type: object
                    properties:
                      user_id:
                        type: integer
                        example: 1
                      transaction_id:
                        type: integer
                        example: 2
                      transaction_date:
                        type: string
                        format: date-time
                        example: 2023-06-20T11:37:50.551Z
                      flight_number:
                        type: string
                        example: JT-792
                      class:
                        type: string
                        example: ECONOMY
                      price:
                        type: integer
                        example: 1506300
                      departure_terminal_name:
                        type: string
                        example: Terminal 2E
                      arrival_terminal_name:
                        type: string
                        example: Terminal Domestic
                      flight_date:
                        type: string
                        format: date
                        example: 2023-06-01
                      departure_time:
                        type: string
                        example: 02:00
                      arrival_time:
                        type: string
                        example: 05:20
                      flight_duration:
                        type: integer
                        example: 200
                      free_baggage:
                        type: integer
                        example: 20
                      cabin_baggage:
                        type: integer
                        example: 7
                      total_bill:
                        type: number
                        format: double
                        example: 1506300
                      payment_status:
                        type: boolean
                        example: false
                      departure_airport:
                        type: string
                        example: Soekarno Hatta International Airport
                      departure_code:
                        type: string
                        example: CGK
                      departure_city:
                        type: string
                        example: Jakarta
                      departure_country:
                        type: string
                        example: Indonesia
                      arrivall_airport:
                        type: string
                        example: Hasanuddin
                      arrivall_code:
                        type: string
                        example: UPG
                      arrivall_city:
                        type: string
                        example: Makassar
                      arrivall_country:
                        type: string
                        example: Indonesia
                      airplane_model:
                        type: string
                        example: Boeing 737
                      airplane_code:
                        type: string
                        example: BOEING-737-29
                      airline:
                        type: string
                        example: Lion Air
                      airline_code:
                        type: string
                        example: JT
        "400":
          description: Error Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: transaction_id is required
                  data:
                    example: null
        "404":
          description: Error Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: transaction not found
                  data:
                    example: null
  /transactions/{user_id}:
    get:
      tags:
        - Transactions
      summary: Mendapatkan semua data transaksi yang dilakukan seorang pengguna
      description: Mendapatkan semua data transaksi yang dilakukan seorang pengguna
      parameters:
      - in: path
        name: user_id
        required: true
        schema:
          type: integer
          example: 1
        description: id of user
      operationId: get-user_id-transactions
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Succes
                  data: 
                    type: object
                    properties:
                      user_id:
                        type: integer
                        example: 1
                      transaction_id:
                        type: integer
                        example: 2
                      transaction_date:
                        type: string
                        format: date-time
                        example: 2023-06-20T11:37:50.551Z
                      flight_number:
                        type: string
                        example: JT-792
                      class:
                        type: string
                        example: ECONOMY
                      price:
                        type: integer
                        example: 1506300
                      departure_terminal_name:
                        type: string
                        example: Terminal 2E
                      arrival_terminal_name:
                        type: string
                        example: Terminal Domestic
                      flight_date:
                        type: string
                        format: date
                        example: 2023-06-01
                      departure_time:
                        type: string
                        example: 02:00
                      arrival_time:
                        type: string
                        example: 05:20
                      flight_duration:
                        type: integer
                        example: 200
                      free_baggage:
                        type: integer
                        example: 20
                      cabin_baggage:
                        type: integer
                        example: 7
                      total_bill:
                        type: number
                        format: double
                        example: 1506300
                      payment_status:
                        type: boolean
                        example: false
                      departure_airport:
                        type: string
                        example: Soekarno Hatta International Airport
                      departure_code:
                        type: string
                        example: CGK
                      departure_city:
                        type: string
                        example: Jakarta
                      departure_country:
                        type: string
                        example: Indonesia
                      arrivall_airport:
                        type: string
                        example: Hasanuddin
                      arrivall_code:
                        type: string
                        example: UPG
                      arrivall_city:
                        type: string
                        example: Makassar
                      arrivall_country:
                        type: string
                        example: Indonesia
                      airplane_model:
                        type: string
                        example: Boeing 737
                      airplane_code:
                        type: string
                        example: BOEING-737-29
                      airline:
                        type: string
                        example: Lion Air
                      airline_code:
                        type: string
                        example: JT
        "400":
          description: Error Bad Request
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: User with id,  is not found
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: The flight you are looking for is not available
                      data:
                        example: false
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: issuing country field is required
                      data:
                        example: false
              examples:
                userid-not-found:
                  summary: Jika pengguna dengan ID tidak ada
                  value:
                    status: false
                    message: User with id,  is not found
                    data: null
                flights-empty:
                  summary: Jika penerbangan kosong
                  value:
                    status: false
                    message: The flight you are looking for is not available
                    data: null
                country-required:
                  summary: Jika negara penerbit belum di isi
                  value:
                    status: false
                    message: issuing country field is required
                    data: null
      security:
        - jwt_token: []
  /payments:
   post:
      tags:
        - Payments
      summary: Menangani pembayaran
      description: Endpoint ini menangani penyelesaian pembayaran
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                transaction_id:
                  type: string
                  example: iEDE51rDDu3l
      responses:
        "200":
          description: Success Update Data
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                    example: success
                  data: 
                    type: integer
                    example: 1
        "400":
          description: Error Bad Request
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: payment data with transaction id iEDE51rDDu3l is already complete
                      data: 
                        example: null
              examples:
                payment-not-found:
                  summary: Jika pembayaran dengan id tidak ada
                  value:
                    status: false
                    message: payment data with transaction id,is not found
                    data: null
        "404":
          description: Error Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: payment data with transaction id iEDE51rDDu3l is not found
                  data: 
                    example: null
      security:
        - jwt_token: []
  /tickets/{transaction_id}:
   get:
      tags:
        - Tickets
      summary: Mendapatkan data tiket
      description: Tiket akan digenerate setelah user menyelesaikan payment
      parameters:
        - in: path
          name: transaction_id
          required: true
          schema:
            type: string
            example: iEDE51rDDu3l
          description: id of transaction
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        transaction_id:
                          type: integer
                          example: 1
                        passenger_id:
                          type: integer
                          example: 1
                        name:
                          type: string
                          example: Jeno
                        is_active:
                          type: boolean
                          example: true
                        ticket_code:
                          type: string
                          example: cYyQmYA1U6Zx
                        qr_image:
                          type: string
                          example: https://ik.imagekit.io/at4li2svjc/PzV4gC17iYZl_HemoeHWaL
                    
        "404":
          description: Error Not Found
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: transaction data with transaction_id cYyQmYA1U6Zx is not found
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Tickets not found, please complete the payment!
                      data: 
                        example: null
              examples:
                transaction-not-found:
                  summary: Jika data transaksi tidak ditemukan
                  value:
                    status: false
                    message: transaction data with transaction_id cYyQmYA1U6Zx is not found
                    data: null
                ticket-not-found:
                  summary: Jika tiket tidak ditemukan
                  value:
                    status: false
                    message: Tickets not found, please complete the payment!
                    data: null
      security:
        - jwt_token: []
  /notifications:
    get:
      tags:
        - Notifications
      summary: Mendapatkan semua notifikasi berdasarkan user id
      description: Mendapatkan semua data notifikasi berdasarkan user id
      parameters:
      - in: query
        name: user_id
        required: true
        schema:
          type: integer
          example: 1
        description: id of user
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          example: 8
                        user_id:
                          type: integer
                          example: 1
                        title:
                          type: string
                          example: email successfully verified"
                        description:
                          type: string
                          example: testing
                        body:
                          type: string
                          example: contoh body
                        is_read:
                          type: boolean
                          example: false
                        created_at:
                          type: string
                          format: date-time
                          example: 2023-06-23T13:45:06.740Z
                        updated_at:
                          type: string
                          format: date-time
                          example: 2023-06-23T13:45:06.740Z
                    
        "404":
          description: Error Not Found
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: User with id 1 is not found
                      data: 
                        example: null
                  - type: object
                    properties:
                      status:
                        type: boolean
                        example: false
                      message:
                        type: string
                        example: Notification is still empty
                      data: 
                        example: null
              examples:
                user-not-found:
                  summary: Jika pengguna tidak ditemukan
                  value:
                    status: false
                    message: User with id is not found
                    data: null
                notifs-not-found:
                  summary: Jika notifikasi tidak ditemukan
                  value:
                    status: false
                    message: Notification is still empty
                    data: null
      security:
        - jwt_token: []
    post:
      tags:
        - Notifications
      summary: Mengirim notifikasi kepada user tertentu
      description:  Hanya admin yang dapat mengirim notifikasi
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                user_id:
                  type: integer
                  example: 2
                title:
                  type: string
                  example: email successfully verified
                description:
                  type: string
                  example: contoh testing aja
                body:
                  type: string
                  example: ini bodynya ya
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                    example: success
                  data:
                    type: string
                    example: null
                    
        "400":
          description: Error Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: All field are required.
                  data: 
                    example: null
        "404":
          description: Error Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: User with id 4 is not found
                  data: 
                    example: null
      security:
        - jwt_token: []
  /notifications/{id}:
   get:
      tags:
        - Notifications
      summary: Mendapatkan notifikasi berdasarkan id
      description: GET notification by id
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: integer
          example: 1
        description: id of notification
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          example: 8
                        user_id:
                          type: integer
                          example: 1
                        title:
                          type: string
                          example: email successfully verified"
                        description:
                          type: string
                          example: testing
                        body:
                          type: string
                          example: contoh body
                        is_read:
                          type: boolean
                          example: false
                        created_at:
                          type: string
                          format: date-time
                          example: 2023-06-21T13:36:30.500Z
                        updated_at:
                          type: string
                          format: date-time
                          example: 2023-06-23T13:11:02.275Z
                    
        "404":
          description: Error Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Notification with id 4 is not found
                  data: 
                    example: null
      security:
        - jwt_token: []
   put:
      tags:
        - Notifications
      summary: Mengubah status is_read notifikasi
      description: untuk mengubah status notifikasi dari belum dibaca menjadi sudah dibaca
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: integer
          example: 1
        description: id of notification    
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                    example: success
                  data:
                    type: string
                    example: null
      security:
        - jwt_token: []
components:
  securitySchemes:
    jwt_token:
      type: apiKey
      in: header
      name: Authorization