openapi: 3.0.0
info:   
  title: woolbot's FunAPI
  description:  Collection of APIs for bots or just fun by @podvaljoey.
  version: 0.1.103
servers:
  - url: 'https://imperialwool-funapi.hf.space/'
    description: First path, public.
  - url: 'https://funapi.dnszilla.bar/'
    description: Second path, private. 
paths:
  /recognize/api/v1/voice:
    get:
        tags:
            - Recognize API
        parameters:
            - name: 'url'
              description: URL-link to voice message. Should be mp3, ogg or wav.
              in: 'query'
              schema:
                type: 'string'
              example: https://cdn-102.anonfiles.com/q8v0o5O5y8/3d62dac1-1671893935/j4893hg894g4.mp3
            - name: 'extendInfo'
              description: Provide additional information or not.
              in: 'query'
              schema:
                type: 'string'
                default: False
              example: False
            - name: 'signature'
              description: Special access key.
              in: 'query'
              schema:
                type: 'string'
        summary: "This method can help with converting voice into the text."
        responses:
          200:
            description: OK
            content:
              application/json:
                schema:
                  $ref: "#/components/schemas/RecognizeResult"
          400:
            description: Bad Request
            content:
              application/json:
                schema:
                  $ref: "#/components/schemas/ErrorObject"
    post:
        tags:
            - Recognize API
        parameters:
            - name: 'url'
              description: URL-link to voice message. Should be mp3, ogg or wav.
              in: 'query'
              schema:
                type: 'string'
              example: https://cdn-102.anonfiles.com/q8v0o5O5y8/3d62dac1-1671893935/j4893hg894g4.mp3
            - name: 'file'
              description: Upload file to recognize voice. **NOT SUPPORTED NOW**
              in: 'query'
              schema:
                type: 'string'
            - name: 'extendInfo'
              description: Provide additional information or not.
              in: 'query'
              schema:
                type: 'string'
                default: False
              example: False
            - name: 'signature'
              description: Special access key.
              in: 'query'
              schema:
                type: 'string'
        summary: "This method can help with converting voice into the text."
        responses:
          200:
            description: OK
            content:
              application/json:
                schema:
                  $ref: "#/components/schemas/RecognizeResult"
          400:
            description: Bad Request
            content:
              application/json:
                schema:
                  $ref: "#/components/schemas/ErrorObject"
  /yt/api/v1/search:
    get:
        tags:
            - "Youtube: Becoming Music Platform"
        parameters:
            - name: 'query'
              description: Query for YouTube to find videos.
              in: 'query'
              schema:
                type: 'string'
              example: never gonna give you up
            - name: 'signature'
              description: Special access key.
              in: 'query'
              schema:
                type: 'string'
        summary: "This method can help with searching videos on YouTube."
        responses:
          200:
            description: OK
            content:
              application/json:
                schema:
                  $ref: "#/components/schemas/YTSearchResult"
          400:
            description: Bad Request
            content:
              application/json:
                schema:
                  $ref: "#/components/schemas/ErrorObject"
    post:
        tags:
            - "Youtube: Becoming Music Platform"
        parameters:
            - name: 'query'
              description: Query for YouTube to find videos.
              in: 'query'
              schema:
                type: 'string'
              example: never gonna give you up
            - name: 'signature'
              description: Special access key.
              in: 'query'
              schema:
                type: 'string'
        summary: "This method can help with searching videos on YouTube."
        responses:
          200:
            description: OK
            content:
              application/json:
                schema:
                  $ref: "#/components/schemas/YTSearchResult"
          400:
            description: Bad Request
            content:
              application/json:
                schema:
                  $ref: "#/components/schemas/ErrorObject"
components:
  schemas:
    ErrorObject:
      type: object
      properties:
        status:
          type: string
          example: error
        details:
          type: object
          properties:
            error_code:
              type: int
              example: 103
            error_details:
              type: string
              example: No signature
    RecognizeResult:
      type: object
      properties:
        status:
          type: string
          example: ok
        result:
          type: string
          example: "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean condimentum neque quis enim bibendum, ut molestie magna gravida. Donec et felis eget lacus sodales convallis. Quisque vitae erat et leo lobortis iaculis. Maecenas a lectus vitae metus fringilla luctus. Morbi sed pellentesque elit. Phasellus bibendum et urna sed elementum. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus."
    YTSearchResult:
      type: object
      properties:
        status:
          type: string
          example: ok
        query:
          type: string
          example: never gonna give you up
        videoIds:
          type: object
          properties:
            "0":
              type: string
              example: dQw4w9WgXcQ
            "1":
              type: string
              example: GtL1huin9EE
            "2":
              type: string
              example: uXV-IaR_vNE