Dumpling AI

🚀 API Documentation

This API server offers a comprehensive set of features designed to streamline various tasks, including file management, data processing, network requests, AI generation, and development support.

✨ Features

The server provides the following functional modules:

1. File Storage
2. Data Processing
3. Network Requests
4. AI Generation
5. Developer Tools

📦 Installation

Install Dependencies

Install all the dependencies required for the project:

npm install
pip install -r requirements.txt

Configure Environment Variables

Set the necessary environment variables:

export API_KEY=your_api_key_here

Start the Service

Start the API server:

node app.js
python server.py

💻 Usage Examples

Upload a File to the Server (upload-file)

const fetch = require('node-fetch');

async function uploadFile(filePath) {
    const formData = new FormData();
    formData.append('file', fs.createReadStream(filePath));

    const response = await fetch('http://api.example.com/upload', {
        method: 'POST',
        body: formData,
    });

    return response.json();
}

uploadFile('/path/to/file.txt').then(data => console.log(data));

Download a File (download-file)

const fs = require('fs');
const fetch = require('node-fetch');

async function downloadFile(url, outputPath) {
    const response = await fetch(url);
    const writer = fs.createWriteStream(outputPath);

    response.body.pipe(writer);
    return new Promise((resolve, reject) => {
        writer.on('finish', () => resolve());
        writer.on('error', (err) => reject(err));
    });
}

downloadFile('http://api.example.com/download', '/path/to/output.pdf').then(() => console.log("Download complete"));

Handle Network Errors

async function handleError(url) {
    try {
        await fetch(url);
    } catch (error) {
        console.error('Error:', error.message);
    }
}

handleError('http://nonexistent.com').catch(() => console.log("Request failed."));

📚 Documentation

File Storage

Upload a Single File (upload-file)

Upload a single file.

Request Example:

curl -X POST http://api.example.com/upload \
-F "file=@/path/to/file.txt"

Parameters:

• file: The file to upload, supporting multiple formats.

Upload Multiple Files (upload-multiple-files)

Upload multiple files simultaneously.

Request Example:

curl -X POST http://api.example.com/upload/multiple \
-F "file=@/path/to/file1.txt" \
-F "file=@/path/to/file2.txt"

Data Processing

Process a CSV File (process-csv)

Perform data processing on a CSV file.

Request Example:

curl -X POST http://api.example.com/process/csv \
-F "file=@data.csv" \
-d '{"headers": true, "delimiter": ","}' --header "Content-Type: application/json"

Network Requests

Get YouTube Video Information (get-youtube-info)

Retrieve video information for a specified YouTube link.

Request Example:

curl http://api.example.com/youtube/info?url=https://www.youtube.com/watch?v=abc123

Download a File (download-file)

Download a file from a specified URL.

Request Example:

curl -o output.pdf http://api.example.com/download?url=http://example.com/report.pdf

AI Generation

Generate YouTube Subtitles (generate-youtube-subtitles)

Generate subtitles for a YouTube video.

Request Example:

curl -X POST http://api.example.com/youtube/subtitles \
-d '{"url": "https://www.youtube.com/watch?v=abc123"}' --header "Content-Type: application/json"

Download a YouTube Video (download-youtube-video)

Download a YouTube video from a specified URL.

Request Example:

curl -o video.mp4 http://api.example.com/youtube/download?url=https://www.youtube.com/watch?v=abc123

Developer Tools

Execute JavaScript Code (run-js-code)

Execute JavaScript code in a sandbox environment.

Request Example:

curl -X POST http://api.example.com/run/js \
-d '{"code": "console.log(\"Hello, World!\");", "dependencies": {}}' --header "Content-Type: application/json"

Execute Python Code (run-python-code)

Execute Python code in a sandbox environment.

Request Example:

curl -X POST http://api.example.com/run/python \
-d '{"code": "print(\"Hello, World!\")", "dependencies": {}}' --header "Content-Type: application/json"

Error Handling

Server-Provided Error Handling:

• Detailed Error Information: Includes HTTP status codes and specific error descriptions.
• API Key Verification: Ensures requests contain valid API authentication.
• Input Validation: Uses Zod schemas for strict parameter validation.
• Network Error Handling: Provides detailed feedback on network connection issues.

Example Error Response:

{
  "error": {
    "code": 404,
    "message": "Resource not found"
  }
}

Developer Tools

Document Generation (generate-docs)

Automatically generate API documentation from code.

Request Example:

curl -X POST http://api.example.com/docs/generate \
-d '{"src": "/path/to/code", "format": "markdown"}' --header "Content-Type: application/json"

Code Review (code-review)

Automatically review specified code and generate a report.

Request Example:

curl -X POST http://api.example.com/review \
-F "code=@/path/to/file.php" 

📄 Version Information

• API Version: 1.0.0
• Document Update Date: September 1, 2023

With the above features, you can easily perform tasks such as file management, data processing, AI generation, and network requests.