Developer
API Documentation

Integrate BlockMedic's powerful log analysis into your own applications, bots, or websites. Our API is fast, secure, and easy to use.

Headers & Security

CORS Support

Our API is fully CORS-enabled. You can make requests directly from your own web applications using fetch or XMLHttpRequest.

Custom Headers

Accept Set to application/json for structured data.

Rate Limiting

To ensure stability for everyone, we enforce a global rate limit based on your IP address. Please handle 429 Too Many Requests errors gracefully.

Standard Limit

120 Requests

per minute

Burst Limit

Unlimited

for static content

POST /api/v1/paste/upload

Upload a Log

Upload a text file (.log, .txt, or .gz) for processing. The server automatically scrubs sensitive data before storage.

Request Body (Form Data)

file	The log file to upload.
is_permanent	Boolean. If true, the paste never expires.

Code Examples

cURL

curl -X POST https://blockmedic.ampznetwork.com/api/v1/paste/upload \
  -F "[email protected]"

Python (Requests)

import requests

files = {'file': open('latest.log', 'rb')}
res = requests.post('https://blockmedic.ampznetwork.com/api/v1/paste/upload', files=files)
print(res.json())

Node.js (Axios)

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

const form = new FormData();
form.append('file', fs.createReadStream('latest.log'));

axios.post('https://blockmedic.ampznetwork.com/api/v1/paste/upload', form, {
  headers: form.getHeaders()
}).then(res => console.log(res.data));

GET /api/v1/paste/:id

Get Analysis

Retrieve full metadata and parsed analysis for a specific paste ID.

Success Response

{
  "id": "e2e9...",
  "game": "Minecraft",
  "minecraft_version": "1.20.1",
  "mod_loader": "Forge",
  "suspected_mod": "OptiFine",
  "content": "...",
  "created_at": "2024-01-01T00:00:00Z"
}

GET /api/v1/paste/:id/raw

Fetch Raw Content

Returns the scrubbed log content as plain text (text/plain). Ideal for command-line tools and bots.

Status Codes

Code	Error Key	Description
200	—	Request was successful.
400	invalid_file	The uploaded file type is not supported.
429	too_many_requests	Rate limit exceeded for your IP.
500	server_error	An internal error occurred.

Developer API Documentation