API Documentation

Allgemeine Information

Die API ist für Entwickler, um Sachen zu vereinfachen.

Open API Endpoint: https://marvinmc.dev/

IP-Adresse

127.0.0.1

{"ip":"127.0.0.1"}

Calculator

18

{
    "expression":"(5+5)*2-((10\/4)-0.5)",
    "result":"18"
}

    (5+5)*2-((10/4)-0.5)
    18

Minecraft Server Ping

{
    "description":{
        "text":"\u00a7aTestserver (\u00a76\u00a7lMarvinMC-Hosting\u00a7a)\n\u00a78141.95.14.85 \u00a77user null"
    },
    "players":{
        "max":20,
        "online":0
    },
    "version":{
        "name":"Paper 1.12.2",
        "protocol":340
    },
    "favicon":"data:image\/png;base64,iVBORw0KGgoAAAAN...",
    "ping":41,
    "ip":"141.95.14.85",
    "port":10003
}

    
        §aTestserver (§6§lMarvinMC-Hosting§a) §8141.95.14.85 §7user null
    
    
        20
        0
    
    
        Paper 1.12.2
        340
    
    data:image/png;base64,iVBORw0KGgoAAAAN...
    41
    141.95.14.85
    10003

IP Whois

{}

HTML to PDF

{
    "id": "VQ5gUs",
    "name": "unnamed",
    "file": "unnamed.pdf",
    "path": {
        "view": "/view/VQ5gUs/unnamed.pdf",
        "download": "/download/VQ5gUs/unnamed.pdf"
    }
}

    rXEjg3
    unnamed
    unnamed.pdf
    
        /view/rXEjg3/unnamed.pdf
        /download/rXEjg3/unnamed.pdf
    

sVR9J8/unnamed.pdf

<h1 style="text-align: center;">Example PDF Document</h1>
<p>You can use regular HTML here.<br>
When you run your request, this will automatically convert to a PDF.</p>
<p>You can also use images:</p>
<img src="https://marvinmc.net/src/Marvin.png" width="50px" height="auto" alt="Marvin Logo" />
<p>Special characters like &amp;, &lt;, and &gt; will be displayed correctly in the PDF.</p>
<p>Example of using special characters in text:</p>
<ul>
    <li>&amp; - Ampersand</li>
    <li>&lt; - Less than</li>
    <li>&gt; - Greater than</li>
    <li>&quot; - Double quote</li>
    <li>&#39; - Single quote</li>
</ul>
<h4>Many features you can use</h4>
<ol>
    <li>Custom Document</li>
    <li>Custom Author, Name, Theme, ...</li>
    <li>No Watermark inside the Document Content</li>
    <li>Free</li>
    <li>Unlimited uses</li>
</ol>

CAPTCHA

If you want to transmit the data with a signature to prevent unauthorized access to your captchas, send a header named 'signature' with any arbitrary string. If a signature is used during captcha creation, the same signature must also be sent in the header during verification. If no signature was sent during creation, none should be sent during verification either

{
    "images": {
        "png": "https://marvinmc.dev/captcha/images/kbDSOOWQpqLU.png",
        "jpeg": "https://marvinmc.dev/captcha/images/kbDSOOWQpqLU.jpeg",
        "gif": "https://marvinmc.dev/captcha/images/kbDSOOWQpqLU.gif",
        "webp": "https://marvinmc.dev/captcha/images/kbDSOOWQpqLU.webp"
    },
    "id": "kbDSOOWQpqLU",
    "expire": 1728752943
}

    
        https://marvinmc.dev/captcha/images/kOESUfEQvbtY.png
        https://marvinmc.dev/captcha/images/kOESUfEQvbtY.jpeg
        https://marvinmc.dev/captcha/images/kOESUfEQvbtY.gif
        https://marvinmc.dev/captcha/images/kOESUfEQvbtY.webp
    
    kOESUfEQvbtY
    1729973651

images:
    png: https://marvinmc.dev/captcha/images/sGdahnwPplQV.png
    jpeg: https://marvinmc.dev/captcha/images/sGdahnwPplQV.jpeg
    gif: https://marvinmc.dev/captcha/images/sGdahnwPplQV.gif
    webp: https://marvinmc.dev/captcha/images/sGdahnwPplQV.webp

id: sGdahnwPplQV
expire: 1729973735

CAPTCHA Verify

{
    "solved":true
}

    true

true

PHP usage Code example:

<?php
if ($_SERVER["REQUEST_METHOD"] == "GET") {
    $captcha = curl_init("https://marvinmc.dev/captcha/json");
    curl_setopt($captcha, CURLOPT_RETURNTRANSFER, true);
    $captcha = json_decode(curl_exec($captcha), true);

    echo '<form method="POST">
            <input name="captcha-id" value="' . $captcha["id"] . '" hidden/>
            <input name="captcha-code" type="text" placeholder="000000" required />
            <img src="'.$captcha["images"]['png'].'" />
            <button type="submit">Send</button>
          </form>';
} else if ($_SERVER["REQUEST_METHOD"] == "POST") {
    $captchaId = $_POST["captcha-id"];
    $captchaCode = $_POST["captcha-code"];
    $captchaCurl = curl_init("https://marvinmc.dev/captcha/verify/json?id=$captchaId&code=$captchaCode");
    curl_setopt($captchaCurl, CURLOPT_RETURNTRANSFER, true);
    $captcha = json_decode(curl_exec($captchaCurl), true);
    curl_close($captchaCurl);
    if (!$captcha["solved"]) {
        exit("wrong captcha");
    }
    echo "Your code if captcha is solved";
}
?>

Random String

Base64 to Image

XML to Json string

Json to XML string

Unixtime Converter

Date to Unix

Unix to Date