Upload 28 files

app.py

@@ -0,0 +1,81 @@
+import os
+from flask import *
+from flask_limiter import Limiter
+from flask_limiter.util import get_remote_address
+
+from routes import *
+
+app = Flask(__name__)
+app.config['JSON_AS_ASCII'] = False
+limiter = Limiter(app, default_limits=["5/minute"], key_func=get_remote_address, storage_uri="memory://",)
+
+#limiter
+@limiter.request_filter
+def ip_whitelist():
+    try:
+        if request.method == 'POST': signature = request.form['signature']
+        else: signature = request.args['signature']
+        return helpers.checkSignature(signature)
+    except: return False
+#error pages
+@app.errorhandler(429)
+def ratelimit_handler(e): return render_template('ratelimit.html')
+@app.errorhandler(403)
+def forbidden_handler(e): return render_template('forbidden.html')
+@app.errorhandler(404)
+def ratelimit_handler(e): return render_template('notfound.html')
+
+# site routes
+@app.route('/')
+@limiter.exempt
+def index(): return render_template('index.html') 
+
+#empty routes
+@app.route('/yt/api/v1', methods=['GET', 'POST'])
+@app.route('/recognize/api/v1', methods=['GET', 'POST'])
+@app.route('/osu/api/v1', methods=['GET', 'POST'])
+def emptyPath(): return {} 
+
+@app.route('/yt/api/v1/<path:path>', methods=['GET', 'POST'])
+@app.route('/recognize/api/v1/<path:path>', methods=['GET', 'POST'])
+@app.route('/osu/api/v1/<path:path>', methods=['GET', 'POST'])
+def emptyApiWA(path):  return {"status": "error", "error_code": 100, "error_details": "No method like that found"}
+
+#for dns-query
+@app.route('/dns-query', methods=['GET', 'POST'])
+@limiter.exempt
+def rerouteto(): return make_response("Wrong port! Use 334 port for dns-query.", 400)
+    
+#icon
+@app.route('/favicon.ico')
+@limiter.exempt
+def favicon(): return send_from_directory(os.path.join(app.root_path, 'static'), 'favicon.ico', mimetype='image/vnd.microsoft.icon')
+
+###############
+#RECOGNIZE API
+@app.route('/recognize/api/v1/voice', methods=['GET', 'POST'])
+def recognizeVoice(): return witaiApi.recognizeVoice(request)
+
+###############
+#YT SOUND API
+@app.route('/yt/api/v1/search', methods=['GET', 'POST'])
+def search(): return ytApi.search(request)
+@app.route('/yt/api/v1/get-full', methods=['GET', 'POST'])
+def getFull(): return ytApi.getFull(request)
+@app.route('/yt/api/v1/get-preview', methods=['GET', 'POST'])
+def getPreview(): return ytApi.getPreview(request)
+
+###############
+#OSU API
+@app.route('/osu/api/v1/find-song', methods=['GET', 'POST'])
+def findSong(): return osuApi.findSong(request)
+@app.route('/osu/api/v1/get-beatmap', methods=['GET', 'POST'])
+def getBeatmap(): return osuApi.getBeatmap(request)
+@app.route('/osu/api/v1/get-preview', methods=['GET', 'POST'])
+def getBMPreview(): return osuApi.getPreview(request)
+@app.route('/osu/api/v1/get-full', methods=['GET', 'POST'])
+def getBMFull(): return osuApi.getFull(request)
+
+if __name__ == "__main__":
+    app.run(host="::", port=443, debug=True, ssl_context=('/root/cert.pem', '/root/key.pem'))
+

routes/__init__.py

@@ -0,0 +1,4 @@
+from .helpers import *
+from .witaiApi import *
+from .ytApi import *
+from .osuApi import *

routes/helpers.py

@@ -0,0 +1,86 @@
+import os
+import random
+import string
+import requests
+
+# Deleting audio
+def deleteAudio(path: str, waitInSeconds: int = 0):
+    os.system("rm /home/ubuntu/api/static/{}".format(path))
+
+# Signatures!!! Wow!!!
+def checkSignature(signature: str):
+    signatureList = [
+        "008610493EAF05823A1C409C551511BA22C9139B97E78C7AC32E36A5992D5FFB2F846B312EE24ED8FA0AEE83700498F341A1AA46E148F05725867D7C51459A1F",
+        "B2A61FBD11D39A611951D803045B7FCE8A76360099127BA9DD1F6B0B691CFF3320D11916AB5297B811149C3BC65D97777D1DE588249863A7C0E877AD13235C99"
+    ]
+    return signature in signatureList
+
+# Hook for yt-dlp
+def thisIsHook(d):
+    if d['total_bytes'] > 52428800:
+        print("\nFILE IS BIG, ABORT!!!\n")
+        raise Exception(f"Too long file (recieved {d['total_bytes']/1048576}MB, max is 50MB)")
+        
+# Recognizing things
+def req(access_token, meth, path, params, **kwargs):
+    full_url = "https://api.wit.ai" + path
+    headers = {
+        "authorization": "Bearer " + access_token,
+        "accept": "application/vnd.wit." + "20221114" + "+json", 
+    }
+    headers.update(kwargs.pop("headers", {}))
+    rsp = requests.request(meth, full_url, headers=headers, params=params, **kwargs)
+    if rsp.status_code > 200:
+        raise Exception(
+            str(rsp.status_code)
+            + " ("
+            + rsp.reason
+            + ")"
+        )
+    try: r = rsp.json()
+    except: r = rsp.text
+    if "error" in r:
+        raise Exception(json["error"])
+
+    return r
+def dictation(access_token, audio_file, headers=None, verbose=None):
+    params = {}
+    headers = headers or {}
+    if verbose:
+        params["verbose"] = True
+    resp = req(
+        access_token,
+        "POST",
+        "/dictation",
+        params,
+        data=audio_file,
+        headers=headers,
+    )
+    return resp
+def clean(text):
+    if text not in ['', None]:
+        return text.replace('?', '').replace('!', '').replace(';', '').replace('.', '').replace(',', '')
+def delivering(text):
+    result = []
+    temp = None
+    toPush = None
+    tempLength = 0
+    for dirtLine in text.split('\n'):
+        if '"text"' in dirtLine:
+            line = dirtLine[11:-1]
+            if temp == None: temp = line
+            else:
+                if temp in line: toPush = line
+                else:
+                    temp = line
+                    result.append(toPush)
+    return ' '.join(result)
+def devRaw(text):
+    result = []
+    for line in text.split('\n'): #line[11:-1]
+        if '"text"' in line:
+            result.append(line[11:-1])
+    return result
+    
+def randString(len: int = 16):
+    return ''.join(random.SystemRandom().choice(string.ascii_uppercase + string.ascii_lowercase + string.digits) for _ in range(len))

routes/osuApi/__init__.py

@@ -0,0 +1,4 @@
+from .findSong import *
+from .getBeatmap import *
+from .getPreview import *
+from .getFull import *

routes/osuApi/findSong.py

@@ -0,0 +1,35 @@
+import json
+from .. import helpers
+from requests import get
+from random import randint as rand
+def findSong(request):
+    try:
+        if request.method == 'POST': signature = request.form['signature']
+        else: signature = request.args['signature']
+    except: return {"status": "error", "details": { "error_code": 103, "error_details": "No signature" }}
+    if not helpers.checkSignature(signature): return {"status": "error", "details": { "error_code": 105, "error_details": "Invalid signature" }}
+    
+    try:
+        if request.method == 'POST': query = request.form['query']
+        else: query = request.args['query']
+        if query.strip() in ['', None]: raise Exception()
+    except: return {"status": "error", "details": { "error_code": 133, "error_details": "No query" }}
+    
+    tryment = get("https://api.chimu.moe/v1/search", params={"query": query})
+    if int(tryment.status_code) not in [404, 403]:
+        res = []
+        counter = 0
+        for chunk in tryment.json()['data']:
+            res.append({
+                "beatmapId": chunk['SetId'],
+                "artist": chunk['Artist'],
+                "title": chunk['Title'],
+                "creator": chunk['Creator'],
+                "source": chunk['Source'],
+                "tags": chunk['Tags']
+            })
+            counter += 1
+            if counter >= rand(3,7): break
+        return {"status": "pass", "details": {"code": int(tryment.status_code), "result": res}}
+    else: 
+        return {"status": "error", "details": {"code": int(tryment.status_code), "answer": tryment.text}}

routes/osuApi/getBeatmap.py

@@ -0,0 +1,3 @@
+from .. import helpers
+def getBeatmap(request):
+     return {"status": "error", "details": {"code": -1, "answer": "Under construction"}}

routes/osuApi/getFull.py

@@ -0,0 +1,59 @@
+import os
+import ffmpeg
+from .. import helpers
+from .findSong import *
+from requests import get
+from random import randint as rand
+def getFull(request):
+    try:
+        if request.method == 'POST': signature = request.form['signature']
+        else: signature = request.args['signature']
+    except: return {"status": "error", "details": { "error_code": 103, "error_details": "No signature" }}
+    if not helpers.checkSignature(signature): return {"status": "error", "details": { "error_code": 105, "error_details": "Invalid signature" }}
+    
+    try:
+        if request.method == 'POST': beatmapId = request.form['beatmapId']
+        else: beatmapId = request.args['beatmapId']
+        if beatmapId.strip() in ['', None]:
+            raise Exception()
+    except: beatmapId = None
+    
+    try:
+        if request.method == 'POST': query = request.form['query']
+        else: query = request.args['query']
+        if query.strip() in ['', None]:
+            raise Exception()
+    except: 
+        if beatmapId == None: return {"status": "error", "details": { "error_code": 133, "error_details": "No details for finding preview" }}
+        else: query = None
+    
+    if beatmapId != None:
+        if os.path.exists(f"/home/ubuntu/api/static/full/{beatmapId}.ogg"):
+            return {"status": "pass", "details": {"code": 200, "result": "https://funapi.dnszilla.bar/static/full/{}.ogg".format(beatmapId)}}
+        tryment = get("https://kitsu.moe/api/audio/{}".format(beatmapId), allow_redirects=True)
+        if int(tryment.status_code) not in [404, 403, 429]:
+            open(f"/home/ubuntu/api/static/temp/{beatmapId}.mp3", "wb").write(tryment.content)
+            audio_input = ffmpeg.input(f"/home/ubuntu/api/static/temp/{beatmapId}.mp3")
+            audio_output = ffmpeg.output(audio_input, "/home/ubuntu/api/static/full/{}.ogg".format(beatmapId), audio_bitrate="96K")
+            ffmpeg.run(audio_output)
+            helpers.deleteAudio("temp/{}.ogg".format(beatmapId))
+            return {"status": "pass", "details": {"code": int(tryment.status_code), "result": "https://funapi.dnszilla.bar/static/full/{}.ogg".format(beatmapId)}}
+        else: 
+            return {"status": "error", "details": {"code": int(tryment.status_code), "answer": tryment.text}}
+    if query != None:
+        fffff = findSong(request)
+        if fffff['status'] == "error": return fffff
+        beatmapId = fffff['details']['result'][rand(0,len(fffff['details']['result']))]['beatmapId']
+        if os.path.exists(f"/home/ubuntu/api/static/full/{beatmapId}.ogg"):
+            return {"status": "pass", "details": {"code": 200, "result": "https://funapi.dnszilla.bar/static/full/{}.ogg".format(beatmapId)}}
+        tryment = get("https://kitsu.moe/api/audio/{}".format(beatmapId), allow_redirects=True)
+        if int(tryment.status_code) not in [404, 403, 429]:
+            open(f"/home/ubuntu/api/static/temp/{beatmapId}.mp3", "wb").write(tryment.content)
+            audio_input = ffmpeg.input(f"/home/ubuntu/api/static/temp/{beatmapId}.mp3")
+            audio_output = ffmpeg.output(audio_input, "/home/ubuntu/api/static/full/{}.ogg".format(beatmapId), audio_bitrate="96K")
+            ffmpeg.run(audio_output)
+            helpers.deleteAudio("temp/{}.ogg".format(beatmapId))
+            return {"status": "pass", "details": {"code": int(tryment.status_code), "result": "https://funapi.dnszilla.bar/static/full/{}.ogg".format(beatmapId)}}
+        else: 
+            return {"status": "error", "details": {"code": int(tryment.status_code), "answer": tryment.text}}
+    return {}

routes/osuApi/getPreview.py

@@ -0,0 +1,38 @@
+from .. import helpers
+from .findSong import *
+from requests import get
+from random import randint as rand
+def getPreview(request):
+    try:
+        if request.method == 'POST': signature = request.form['signature']
+        else: signature = request.args['signature']
+    except: return {"status": "error", "details": { "error_code": 103, "error_details": "No signature" }}
+    if not helpers.checkSignature(signature): return {"status": "error", "details": { "error_code": 105, "error_details": "Invalid signature" }}
+    
+    try:
+        if request.method == 'POST': beatmapId = request.form['beatmapId']
+        else: beatmapId = request.args['beatmapId']
+        if beatmapId.strip() in ['', None]:
+            raise Exception()
+    except: beatmapId = None
+    
+    try:
+        if request.method == 'POST': query = request.form['query']
+        else: query = request.args['query']
+        if query.strip() in ['', None]:
+            raise Exception()
+    except: 
+        if beatmapId == None: return {"status": "error", "details": { "error_code": 133, "error_details": "No details for finding preview" }}
+        else: query = None
+    
+    if beatmapId != None:
+        tryment = get("https://b.ppy.sh/preview/{}.mp3".format(beatmapId))
+        if int(tryment.status_code) not in [404, 403]:
+            return {"status": "pass", "details": {"code": int(tryment.status_code), "result": "https://b.ppy.sh/preview/{}.mp3".format(beatmapId)}}
+        else: 
+            return {"status": "error", "details": {"code": int(tryment.status_code), "answer": tryment.text}}
+    if query != None:
+        fffff = findSong(request)
+        if fffff['status'] == "error": return fffff
+        return {"status": "pass", "details": {"code": fffff['details']['code'], "result": "https://b.ppy.sh/preview/{}.mp3".format(fffff['details']['result'][rand(0,len(fffff['details']['result']))]['beatmapId'])}}
+    return {}

routes/witaiApi/__init__.py

@@ -0,0 +1 @@
+from .recognizeVoice import *

routes/witaiApi/recognizeVoice.py

@@ -0,0 +1,44 @@
+import wget
+import random
+import string
+from .. import helpers
+
+def recognizeVoice(request):
+    try:
+        if request.method == 'POST': url = request.form['url']
+        else: url = request.args['url']
+        if url.strip() in ['', None]: raise Exception()
+    except: return {"status": "error", "details": { "error_code": 101, "error_details": "No link provided" }}
+    try:
+        if request.method == 'POST': signature = request.form['signature']
+        else: signature = request.args['signature']
+    except: return {"status": "error", "details": { "error_code": 103, "error_details": "No signature" }}
+    try:
+        if request.method == 'POST': extendInfo = request.form['extendInfo']
+        else: extendInfo = request.args['extendInfo']
+        if extendInfo in ['true','1',1,'yes','y']: extendInfo = True
+        else: extendInfo = False
+    except: extendInfo = False
+    
+    fileId = ''.join(random.SystemRandom().choice(string.ascii_uppercase + string.ascii_lowercase + string.digits) for _ in range(16))
+    fileExt = url[url.rfind('.'):url.rfind('.')+4]
+    if   fileExt == ".wav": fileHeader = {'Content-Type': 'audio/wav'}
+    elif fileExt == ".mp3": fileHeader = {'Content-Type': 'audio/mpeg3'}
+    elif fileExt == ".ogg": fileHeader = {'Content-Type': 'audio/ogg'}
+    else: return {"status": "error", "details": { "error_code": 111, "error_details": "Wrong file format (only ogg, wav, mp3)" }}
+    wget.download(url, f"/home/ubuntu/api/static/temp/{fileId}{fileExt}")
+    noEx = True
+    with open(f"/home/ubuntu/api/static/temp/{fileId}{fileExt}", 'rb') as f:
+        try: resp = helpers.dictation("ANR3UUMGUHZJFF366EY3YM3FS54QDJPF", f, {'Content-Type': 'audio/mpeg3'})
+        except Exception as e:
+            noEx = False
+            resp = e
+    helpers.deleteAudio(f"temp/{fileId}{fileExt}")
+    try:
+        if resp['text'] == "": return {"status": "ok", "result": "", "details": ""}
+    except: pass
+    if noEx:
+        
+        if extendInfo: return {"status": "ok", "result": helpers.delivering(resp), "details": str(helpers.devRaw(resp))}
+        else: return {"status": "ok", "result": helpers.delivering(resp)}
+    else: return {"status": "error", "details": { "error_code": 123, "error_details": resp }}

routes/ytApi/__init__.py

@@ -0,0 +1,3 @@
+from .getFull import *
+from .getPreview import *
+from .search import *

routes/ytApi/get.py

@@ -0,0 +1,50 @@
+import os
+import yt_dlp
+from .. import helpers
+
+def get(request, check = "huh"):
+    try:
+        if request.method == 'POST': signature = request.form['signature']
+        else: signature = request.args['signature']
+    except: return {"status": "error", "details": { "error_code": 103, "error_details": "No signature" }}
+    if not helpers.checkSignature(signature): return {"status": "error", "details": { "error_code": 105, "error_details": "Invalid signature" }}
+    
+    try:
+        if request.method == 'POST': url = request.form['url']
+        else: url = request.args['url']
+        if url.strip() in ['', None]:
+            raise Exception()
+    except: return {"status": "error", "details": { "error_code": 101, "error_details": "No link provided" }}
+    
+    try:
+        if request.method == 'POST': bitrate = str(request.form['bitrate']) 
+        else: bitrate = str(request.args['bitrate'])
+    except: bitrate = "64k"
+    try:
+        if request.method == 'POST': quality = request.form['quality']
+        else: quality = request.args['quality']
+        if quality.lower() not in ['best', 'worst']: raise Exception()
+    except: quality = 'worst'
+    
+    urlcode = None
+    try: urlcode = url.partition('?v=')[2]
+    except: urlcode = helpers.randString()
+    if urlcode in ['', None]: urlcode = helpers.randString()
+    
+    if os.path.exists("/home/ubuntu/api/static/{}/{}.ogg".format(check, urlcode)):
+        return {"status": "pass", 'done-or-not': True, 'ytdlp-code': 0, 'urlcode': urlcode, "path": "/home/ubuntu/api/static/{}/{}.ogg".format(check, urlcode), "quality": quality, "bitrate": bitrate}
+    
+    if os.path.exists("/home/ubuntu/api/static/temp/{}.ogg".format(urlcode)):
+        return {"status": "pass", 'done-or-not': False, 'ytdlp-code': 0, 'urlcode': urlcode, "path": "/home/ubuntu/api/static/temp/{}.ogg".format(urlcode), "quality": quality, "bitrate": bitrate}
+      
+    ydl_opts = {
+        'format': f'ogg/{quality}audio/{quality}',
+        'outtmpl': "/home/ubuntu/api/static/temp/{}.ogg".format(urlcode),
+        'progress_hooks': [helpers.thisIsHook],
+    }
+
+    try:
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+            error_code = ydl.download(url)
+    except Exception as e: return {"status": "error", "details": {"error_code": 102, "error_details": str(e)}}
+    return {"status": "pass", 'done-or-not': False, 'ytdlp-code': error_code, 'urlcode': urlcode, "path": "/home/ubuntu/api/static/temp/{}.ogg".format(urlcode), "quality": quality, "bitrate": bitrate}

routes/ytApi/getFull.py

@@ -0,0 +1,26 @@
+import ffmpeg
+from .get import *
+from .. import helpers
+
+def getFull(request):
+    answer = get(request, "full")
+    try:
+        if answer['error']: return answer
+    except KeyError: pass
+    except Exception as e: return {"status": "error", "details": { "error_code": 123, "error_details": e }}
+    urlcode = answer['urlcode']
+    bitrate = answer['bitrate']
+    quality = answer['quality']
+    error_code = answer['ytdlp-code']
+    
+    if answer['done-or-not']:
+        return {"status": "pass", "details": {"code": error_code, "name":"{}.ogg".format(urlcode), "result": "http://funapi.dnszilla.bar/static/full/{}.ogg".format(urlcode)}}
+    
+    try:
+        audio_input = ffmpeg.input(answer['path'])
+        audio_output = ffmpeg.output(audio_input.audio, "/home/ubuntu/api/static/full/{}.ogg".format(urlcode), audio_bitrate=bitrate)
+        ffmpeg.run(audio_output)
+        helpers.deleteAudio("temp/{}.ogg".format(urlcode))
+    except Exception as e: return {"status": "error", "details": {"error_code": 102, "error_details": str(e), "result": "http://funapi.dnszilla.bar/static/temp/{}.ogg".format(urlcode)}}
+    return {"status": "pass", "details": {"code": error_code, "name":"{}.ogg".format(urlcode), "result": "http://funapi.dnszilla.bar/static/full/{}.ogg".format(urlcode)}}
+  

routes/ytApi/getPreview.py

@@ -0,0 +1,33 @@
+import ffmpeg
+from .get import *
+from .. import helpers
+
+def getPreview(request):
+    answer = get(request, "previews")
+    try:
+        if answer['error']: return answer
+    except KeyError: pass
+    except Exception as e: return {"status": "error", "details": { "error_code": 123, "error_details": e }}
+    urlcode = answer['urlcode']
+    bitrate = answer['bitrate']
+    quality = answer['quality']
+    error_code = answer['ytdlp-code']
+    
+    try:
+        if request.method == 'POST': duration = request.form['duration']
+        else: duration = request.args['duration']
+        if duration > 60: duration = 60
+    except: duration = 30
+    
+    if answer['done-or-not']:
+        return {"status": "pass", "details": {"code": error_code, "name":"{}.ogg".format(urlcode), "result": "http://funapi.dnszilla.bar/static/previews/{}.ogg".format(urlcode)}}
+    
+    try:
+        audio_input = ffmpeg.input(answer['path'])
+        audio_cut = audio_input.audio.filter('atrim', duration=duration)
+        audio_output = ffmpeg.output(audio_cut, "/home/ubuntu/api/static/previews/{}.ogg".format(urlcode), audio_bitrate=bitrate)
+        ffmpeg.run(audio_output)
+        helpers.deleteAudio("temp/{}.ogg".format(urlcode))
+    except Exception as e: return {"status": "error", "details": {"error_code": 102, "error_details": str(e), "result": "http://funapi.dnszilla.bar/static/temp/{}.ogg".format(urlcode)}}
+    return {"status": "pass", "details": {"code": error_code, "name":"{}.ogg".format(urlcode), "result": "http://funapi.dnszilla.bar/static/previews/{}.ogg".format(urlcode)}}
+  

routes/ytApi/search.py

@@ -0,0 +1,22 @@
+import urllib
+import re
+from .. import helpers
+
+def search(request):
+    try:
+        if request.method == 'POST': searchQuery = request.form['query']
+        else: searchQuery = request.args['query']
+        if searchQuery.strip() in ['', None]:
+            raise Exception()
+    except: searchQuery = "rickroll"
+    try:
+        if request.method == 'POST': signature = request.form['signature']
+        else: signature = request.args['signature']
+    except: return {"status": "error", "details": { "error_code": 103, "error_details": "No signature" }}
+    if not helpers.checkSignature(signature): return {"status": "error", "details": { "error_code": 105, "error_details": " signature" }}
+    html = urllib.request.urlopen("https://www.youtube.com/results?search_query={}".format(urllib.parse.quote_plus(searchQuery)))
+    videoList = re.findall(r"watch\?v=(\S{11})", html.read().decode())
+    videoIds = dict()
+    for i in range(len(videoList)):
+        videoIds.update({i: videoList[i]})
+    return {"status": "pass", "query": searchQuery, "videoIds": videoIds}

static/api.yaml

@@ -0,0 +1,193 @@
+openapi: 3.0.0
+info:   
+  title: DNSZilla's FunAPI
+  description:  Collection of APIs for bots or just fun by @imperialwool. Thx DNSZilla for host!
+  version: 0.1.103
+servers:
+  - url: 'https://funapi.dnszilla.bar/'
+    description: Main API. 
+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

static/template.yaml

@@ -0,0 +1,652 @@
+openapi: 3.0.0
+info:
+  title: Providing Examples
+  description:  Providing Examples
+  version: 1.0.0
+paths:
+  /multiple-examples-in-request-parameters/{path-param-1}/{path-param-2}:
+    get:
+      tags:
+        - Providing Examples
+      parameters:
+        - name: 'path-param-1'
+          in: 'path'
+          schema:
+            type: 'string'
+            default: "p1-opt-2"  
+          examples:
+            example1: 
+              value: "p1-opt-1"
+            example2:
+              value: "p1-opt-2"
+        - name: 'path-param-2'
+          in: 'path'
+          schema:
+            type: 'string'
+          examples:
+            example1: 
+              value: "p2-opt-1"
+            example2:
+              value: "p2-opt-2"
+        - name: 'age'
+          description: Single Example
+          in: 'query'
+          schema:
+            type: 'number'
+          example: 24
+        - name: 'country-code'
+          description: Multiple examples _(Notice `us` do not have a summary)_
+          in: 'query'
+          schema:
+            type: 'string'
+            default: " "
+          examples:
+            example1: 
+              value: "uk"
+              summary: "United Kingdom"
+            example2:
+              value: "us"
+            example3:
+              value: "ch"
+              summary: "China"
+        - name: 'marital-status'
+          in: 'query'
+          schema:
+            type: 'string'
+            default: "unmarried"  
+          examples:
+            example1: 
+              value: "married"
+            example2:
+              value: "unmarried"
+            example3:
+              value: "widowed"
+        - name: luckyNumbers
+          in: query
+          schema:
+            type: array
+            items:
+              type: number
+            minItems: 4
+            maxItems: 4
+            examples:
+              - ""
+              - "   "
+              - [10]
+              - [10, 20, 30, 40]
+
+  /multiple-examples-by-response-type:
+    get:
+      description: Multiple Examples provide for each media-type (`application/json` or `application/json`) 
+      tags:
+        - Providing Examples
+      responses:
+        '200':
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  age:
+                    description: Person Age
+                    type: integer
+                  fullName:
+                    description: Person Full name
+                    type: object
+                    properties:
+                      firstName:
+                        description: First name
+                        type: string
+                      lastName:
+                        description: Last name
+                        type: string
+              examples:
+                valid-json:
+                  summary: Example with Valid JSON String
+                  description: If valid JSON is provided in the example, It will be displayed in JSON tree form. Allowing copy/expand/collapse functionality
+                  value: |
+                    {
+                      "person": {
+                        "fullName": {
+                          "firstName": "Mickey",
+                          "lastName": "Mouse"
+                        },
+                        "age": "9"
+                      }
+                    }
+                invalid-json:
+                  summary: Example with Invalid JSON String
+                  description: Invalid JSON is displayed in text-area as is
+                  value: |
+                    {
+                      person: {
+                        fullName: {
+                          firstName: Donald,
+                          lastName: Duck
+                        },
+                        age: 10
+                      }
+                    }
+                as-object:    
+                  summary: Example specified as object
+                  value:
+                    fullName:
+                      firstName: Donald
+                      lastName: Duck       
+                    age: 10
+            application/xml:
+              schema:
+                type: object
+                properties:
+                  age:
+                    description: Person Age
+                    type: integer
+                  fullName:
+                    description: Person Full name
+                    type: object
+                    properties:
+                      firstName:
+                        description: First name
+                        type: string
+                      lastName:
+                        description: Last name
+                        type: string
+              examples:
+                example-1:
+                  description: Exmple 1 Description
+                  value: |
+                    <root>
+                      <person>
+                        <fullName>
+                          <firstName> Mickey </firstName>
+                          <lastName> Mouse </lastName>
+                        </fullName>
+                        <age> 9 </age>
+                      </person>
+                    </root>
+  /single-example-by-response-type:
+    get:
+      summary: Single Example at schema Level
+      tags:
+        - Providing Examples
+      responses:
+        '200':
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  age:
+                    description: Person Age
+                    type: integer
+                  fullName:
+                    description: Person Full name
+                    type: object
+                    properties:
+                      firstName:
+                        description: First name
+                        type: string
+                      lastName:
+                        description: Last name
+                        type: string
+              example: |
+                {
+                  age: 10,
+                  fullName: {
+                    firstName: Donald,
+                    lastName: Duck
+                  }
+                }
+  /example-with-array-1:
+    get:
+      summary: Single Example at schema Level
+      tags:
+        - Providing Examples
+      responses:
+        '200':
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ArrayOfInt-1"
+  /example-with-array-2:
+    get:
+      summary: Single Example at schema Level
+      tags:
+        - Providing Examples
+      responses:
+        '200':
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ArrayOfInt-2"
+
+  /object-example-for-a-schema:
+    get:
+      summary: Single example having invalid JSON, under a Schema
+      tags:
+        - Providing Examples
+      responses:
+        '200':
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  age:
+                    description: Person Age
+                    type: integer
+                  fullName:
+                    description: Person Full name
+                    type: object
+                    properties:
+                      firstName:
+                        description: First name
+                        type: string
+                      lastName:
+                        description: Last name
+                        type: string
+                example: |
+                  {
+                    person: {
+                      fullName: {
+                        firstName: Donald,
+                        lastName: Duck
+                      },
+                      age: 10
+                    }
+                  }
+  /array-example-for-a-schema:
+    get:
+      summary: Single Example of Type Array Under a Schema
+      tags:
+        - Providing Examples
+      responses:
+        '200':
+          description: An array of currency codes
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/currencies"
+  /example-with-simple-object:
+    get:
+      summary: Single Example of Type Array Under a Schema
+      tags:
+        - Providing Examples
+      responses:
+        '200':
+          description: An array of currency codes
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PersonObject"
+  /per-field-example-with-root-as-object:
+    get:
+      summary: Root node of the example is an object. and the object is constituted using field level example
+      tags:
+        - Providing Examples
+      responses:
+        '200':
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  age:
+                    description: Person Age
+                    type: integer
+                    example: 8
+                  fullName:
+                    description: Person Full name
+                    type: object
+                    properties:
+                      firstName:
+                        description: First name
+                        type: string
+                        example: 'Daisy'
+                      lastName:
+                        description: Last name
+                        type: string
+                        example: 'Duck'
+                  dependents:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        dependentName:
+                          type: string
+                        relation:
+                          type: string
+                        age:
+                          type: number
+  /per-field-example-with-root-as-array:
+    get:
+      summary: Root node of the example is an array. and the object is constituted using field level example
+      tags:
+        - Providing Examples
+      responses:
+        '200':
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    dependentName:
+                      type: string
+                    relation:
+                      type: string
+                    age:
+                      type: number
+                  example:
+                    dependentName: Natasha
+                    relation: wife
+                    age: 28    
+  /example-with-refs:
+    get:
+      description: |
+        When a Schema definition is `provided` as a ref  
+        (provide the example at schema-level)
+      tags:
+        - Providing Examples
+      responses:
+        '200':
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/cost'
+              examples:
+                USD:
+                  description: Cost in `US Dollars`
+                  value: |
+                    {
+                      amount: 10,
+                      currency: USD
+                    }
+                INR:
+                  description: Cost in `Indian Rupees`
+                  value: |
+                    {
+                      amount: 700,
+                      currency: INR
+                    }
+  /multiple-example-in-request-body:
+    post:
+      summary: Request body with multiple examples
+      tags:
+        - Providing Examples
+      requestBody:
+        description: Request body containing **multiple** examples
+        required: true
+        content:
+          application/json:
+            schema:
+              type: array
+              items:
+                $ref: '#/components/schemas/cost'
+            examples:
+              USD:
+                description: Cost in `US Dollars`
+                value: |
+                  {
+                    amount: 10,
+                    currency: USD
+                  }
+              INR:
+                description: Cost in `Indian Rupees`
+                value: |
+                  {
+                    amount: 700,
+                    currency: INR
+                  }
+  /object-containg-array-property-with-example:
+    get:
+      summary: Object schema with array type property containing example
+      tags:
+        - Providing Examples
+      responses:
+        200:
+          description: Object with array type property containing example
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ObjectWithArrayPropExample"
+  /examples-anyOf:
+    get:
+      tags:
+        - Providing Examples
+      summary: AnyOf schemas with examples as part of the subschema
+      responses:
+        '200':
+          description: AnyOf schemas with examples as part of the subschema
+          content:
+            application/problem+json:
+              schema:
+                anyOf:
+                  - title: AnyOf example 1
+                    description: First example
+                    type: object
+                    properties:
+                      foo:
+                        type: string
+                      bar:
+                        type: integer
+                    example:
+                      foo: foo
+                      bar: 42
+                  - title: Second anyOf
+                    description: Another example
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        foo:
+                          type: string
+                        quux:
+                          type: array
+                          items:
+                            type: number
+                    example:
+                      foo: foo
+                      quux: [ 42, 24 ]
+                  - title: No example defined
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        foo:
+                          type: string
+                        quux:
+                          type: array
+                          items:
+                            type: number
+  /examples-anyOf-with-general-properties:
+    get:
+      tags:
+        - Providing Examples
+      summary: AnyOf schemas with general properties 
+      responses:
+        '200':
+          description: AnyOf schemas with general properties
+          content:
+            application/problem+json:
+              schema:
+                title: A composed object
+                type: object
+                properties:
+                  common:
+                    type: string
+                  other:
+                    type: number
+                anyOf:
+                  - title: Schema 1
+                    type: object
+                    properties:
+                      foo:
+                        type: string
+                      bar:
+                        type: integer
+                    example:
+                      foo: foo
+                      bar: 42
+                  - title: Second schema
+                    type: object
+                    properties:
+                      baz:
+                        type: string
+                        format: url
+  /examples-oneOf:
+    get:
+      tags:
+        - Providing Examples
+      summary: OneOf schema with examples as part of the subschema
+      responses:
+        '200':
+          description: OneOf schema with examples as part of the subschema
+          content:
+            application/problem+json:
+              schema:
+                oneOf:
+                  - title: Schema 1
+                    type: object
+                    properties:
+                      foo:
+                        type: string
+                      bar:
+                        type: integer
+                    example:
+                      foo: foo
+                      bar: 42
+                  - title: Second schema
+                    type: object
+                    properties:
+                      baz:
+                        type: string
+                        format: url
+  /examples-allOf:
+    get:
+      tags:
+        - Providing Examples
+      summary: AllOf schemas with examples as part of the subschema
+      responses:
+        '200':
+          description: AllOf schemas with examples as part of the subschema
+          content:
+            application/problem+json:
+              schema:
+                allOf:
+                  - title: Schema 1
+                    type: object
+                    properties:
+                      foo:
+                        type: string
+                      bar:
+                        type: integer
+                  - title: Second schema
+                    type: object
+                    properties:
+                      baz:
+                        type: string
+                        format: url
+  /examples-allOf-anyOf:
+    get:
+      tags:
+        - Providing Examples
+      summary: Combination of allOf & nested anyOf schemas
+      responses:
+        '200':
+          description: Combination of allOf & nested anyOf schemas
+          content:
+            application/problem+json:
+              schema:
+                allOf:
+                  - title: Schema 1
+                    type: object
+                    properties:
+                      foo:
+                        type: string
+                      bar:
+                        type: integer
+                  - title: Second schema
+                    anyOf:
+                      - type: object
+                        properties:
+                          baz:
+                            type: string
+                            format: url
+                      - type: object
+                        properties:
+                          foobar:
+                            type: string
+components:
+  schemas:
+    cost:
+      type: object
+      properties:
+        amount:
+          type: integer
+          description: Amount
+        currency:
+          description: Currency Code
+          type: string
+    currencies:
+      type: array
+      items:
+        type: object
+        properties:
+          currencyCode:
+            type: string
+          evaluationDate:
+            type: string
+            format: date-time
+      example:
+        - currencyCode: USD
+          evaluationDate: '2017-07-21T17:32:28Z'
+        - currencyCode: INR
+          evaluationDate: '2017-07-21T17:32:28Z'
+    ArrayOfInt-1:
+      type: array
+      items:
+        type: integer
+        format: int64
+      example: [1, 2, 3, 4]
+    ArrayOfInt-2:
+      type: array
+      items:
+        type: integer
+        format: int64
+        example: 1
+    PersonObject:
+      type: object
+      properties:
+        name:
+          type: string
+        age:
+          type: integer
+      example:
+        name: name-1
+        age: 1
+    ObjectWithArrayPropExample:
+      type: object
+      properties:
+        numberProp:
+          type: number
+          example: 1000
+        stringProp:
+          type: string
+          enum: [value0, value1]
+        arrayProp:
+          type: array
+          items:
+            type: number
+          example: [0, 1, 2]

templates/4a1504d326b35eaad3b9d4f48b5119a6/403.html

@@ -0,0 +1 @@
+<html><head><title>403 Forbidden</title></head><body><center><h1>403 Forbidden</h1></center><hr><center>mangoo</center></body></html>

templates/4a1504d326b35eaad3b9d4f48b5119a6/404.html

@@ -0,0 +1 @@
+<html><head><title>404 Not Found</title></head><body><center><h1>404 Not Found</h1></center><hr><center>mangoo</center></body></html>

templates/4a1504d326b35eaad3b9d4f48b5119a6/429.html

@@ -0,0 +1 @@
+<html><head><title>429 Too Many Requests</title></head><body><center><h1>429 Too Many Requests</h1></center><hr><center>mangoo</center></body></html>

templates/4a1504d326b35eaad3b9d4f48b5119a6/502.html

@@ -0,0 +1 @@
+<html><head><title>502 Bad Gateway</title></head><body><center><h1>502 Bad Gateway</h1></center><hr><center>mangoo</center></body></html>

templates/badgateway.html

@@ -0,0 +1 @@
+<html><head><title>502 Bad Gateway</title></head><body><center><h1>502 Bad Gateway</h1></center><hr><center>mangoo</center></body></html>

templates/forbidden.html

@@ -0,0 +1 @@
+<html><head><title>403 Forbidden</title></head><body><center><h1>403 Forbidden</h1></center><hr><center>mangoo</center></body></html>

templates/index.html

@@ -0,0 +1,25 @@
+<!doctype html> <!-- Important: must specify -->
+<html>
+<head>
+	<title>DNSZilla's FunAPI</title>
+	<style> body {background-color:#14191f;} </style>
+	<meta charset="utf-8">
+	<meta name="viewport" content="width=device-width, minimum-scale=1, initial-scale=1, user-scalable=yes">
+	<script type="module" src="https://unpkg.com/rapidoc/dist/rapidoc-min.js"></script>
+</head>
+<body>
+	<rapi-doc
+		spec-url="/static/api.yaml"
+		theme="dark"
+		allow-try="false"
+		allow-search="false"
+		allow-authentication="false"
+		show-info="true"
+		show-header="false"
+		render-style="view"
+		bg-color="#14191f"
+		text-color="#aec2e0"
+		primary-color="#c7d8f2"
+	> <br> </rapi-doc>
+</body>
+</html>

templates/notfound.html

@@ -0,0 +1 @@
+<html><head><title>404 Not Found</title></head><body><center><h1>404 Not Found</h1></center><hr><center>mangoo</center></body></html>

templates/ratelimit.html

@@ -0,0 +1 @@
+<html><head><title>429 Too Many Requests</title></head><body><center><h1>429 Too Many Requests</h1></center><hr><center>mangoo</center></body></html>