Documentation: Quick Code-to-API Conversion Tool

The Quick Code-to-API Conversion Tool is designed to accelerate the development process for programmers by eliminating the need to deal with server-side issues and more. With this tool, you can easily write code in various programming languages and link them together via APIs.

To use the tool, simply write your functions in the website’s editor and send your request according to the documentation below.

Key Features of the Tool:

  • No Server Required: All processes are performed online without the need for a dedicated host or server.
  • Simple User Interface: Use the website’s online editor to easily input your code and activate the corresponding API.
  • Multi-Language Support: In addition to Python, the tool supports various programming languages, enabling the connection of different codebases via APIs.
  • High Speed: Convert your code into an API in less than 5 minutes and use it across different projects.
  • Pay-Per-Use: Instead of hefty monthly hosting and server costs, you only pay per request.

By signing up on the website, you will receive 100 free requests as a gift, which you can use to test the site’s APIs. After that, 10 Tomans will be deducted from your account balance for each request.

Get Your API Key

Types of APIs

Using this tool, you can create two types of APIs, which are categorized based on their use cases:

1. Standard Endpoint API

This method is similar to common API websites. You write your code, receive an endpoint, send a POST request to the API, and quickly receive your response.

2. Processing Script API

The second type of API is for scripts that require longer processing times. For example, a script that connects to OpenAI to generate a long text or a script that extracts audio from a video file. These APIs cannot deliver an immediate response, and requests cannot be kept open for too long due to timeout constraints. For such APIs, the system first returns a predefined response like “the process started…” to close the request, and then processes your request in the background. In these cases, you must send the response to a custom webhook or save it in a log file via your code.

Example of a Simple API

Let’s explore this with an example:

Assume you’ve written a Python code to generate a random password, and you want to use it in WordPress. (Note: This can also be done easily with PHP in WordPress, but for simplicity, we’ll use this example.)

Python Code:

import secrets
import string

def generate_password(length=12, min_digits=2, min_special=2):
    if length < min_digits + min_special:
        raise ValueError("Length too short for the required number of digits and special characters.")

    # Required characters
    letters = string.ascii_letters
    digits = string.digits
    special_chars = "!@#$%^&*()"

    # Random selection
    password = [
        secrets.choice(letters) for _ in range(length - min_digits - min_special)
    ] + [
        secrets.choice(digits) for _ in range(min_digits)
    ] + [
        secrets.choice(special_chars) for _ in range(min_special)
    ]

    # Shuffle characters
    secrets.SystemRandom().shuffle(password)
    return "".join(password)

Now, let’s call this function in WordPress. To do this, first enter the above code into the website’s online editor and save it.

After saving, an API icon will appear in the right sidebar. Click on it and activate the API. Keep the debug mode enabled during testing, but disable it during production to avoid exposing code errors.

Next, log into your user panel and obtain your API key. You will receive two keys: client key and client secret. Save these immediately. (If you lose your client secret, you will need to generate new keys.) These keys must be sent in the headers using Basic Auth. Also, set the content-type header to application/json since the data must be sent in JSON format.

Send the required parameters for the function via a POST request to the following URL:
https://backendbaz.com/auto-api/{code_id}/{method_name}

  1. code_id: This is the ID of your code, which you can extract from the URL of your code in the online editor.
    Example: backendbaz.com/online-editor/python/35399
    Here, the code ID is 35399.
  2. method_name: The name of the main function to be called.
  3. parameters: This should be sent in JSON format and includes the input parameters of the function.
    The inputs should be provided as key/value pairs under the key inputs.

For example, if you want to generate a 20-character password with at least 6 digits and 6 special characters, the JSON data to send to the API would look like this:

curl -X POST https://backendbaz.com/auto-api/35399/generate_password \
-H "Content-Type: application/json" \
-d '{"length": 20,"min_digits": 6,"min_special": 6}'

Documentation

Method: POST

Endpoint: https://backendbaz.com/auto-api/{code_id}/{method_name}
Headers:

  • Content-type: application/json
  • Authorization: Basic Auth
    Body: Dictionary of inputs

Sample Code

This sample code demonstrates how to execute the API for the provided code:

PHP:

<?php

$client_key = 'Your Client Key';
$client_secret = 'Your Client Secret';
$Authorization = sprintf('Authorization: Basic %s', base64_encode(sprintf('%s:%s', $client_key, $client_secret)));

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://backendbaz.com/auto-api/{code_id}/{method_name}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{"numbers": [1, 2, 3, 5]}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    $Authorization
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Example of a Processing Script API

All steps for creating this type of API are similar to the previous method, except you must check the “Processing Script” option in the settings and increase the timeout value based on your estimated processing time.

Below is an example of a processing script that extracts audio from a video using the ffmpeg-python library and sends the result to a Telegram bot.

import os
import ffmpeg
import requests
import telegram
from telegram import InputFile

def extract_audio_from_video(video_file_url, tg_bot_token, chat_id):
    # Download the video file
    video_file = "temp_video.mp4"
    download_file(video_file_url, video_file)

    # Extract audio from the video
    audio_file = "temp_audio.mp3"
    (
        ffmpeg
        .input(video_file)
        .output(audio_file, format='mp3')
        .run()
    )

    # Send the audio file to Telegram
    bot = telegram.Bot(token=tg_bot_token)
    with open(audio_file, 'rb') as audio:
        bot.send_audio(chat_id=chat_id, audio=InputFile(audio))

    # Clean up temporary files
    os.remove(video_file)
    os.remove(audio_file)


def download_file(url, local_filename):
    with requests.get(url, stream=True) as r:
        r.raise_for_status()
        with open(local_filename, 'wb') as f:
            for chunk in r.iter_content(chunk_size=8192):
                f.write(chunk)
    return local_filename

This concludes the documentation for the Quick Code-to-API Conversion Tool. For further assistance, please refer to the website’s support section.