API Ideas

[Incrementing]

So I own MCUUID.COM.
What APIs should I have? Just UUID based or loads of Minecraft based APIs (server info, server blacklist lookup, idk...)?

Spoiler: Current APIs

The api subdomain doesn't exist yet... but the APIs work and cache for 24hrs and sh*t

(Images work now! Thanks to Christopher)

 

[Samuel]

API?! PSCH! I'll stick to parsing HTML with Regular Expression!

 

[Incrementing]

For the love of God, whatever type of API you choose to do, please don't make it have a JSON based output.

Everyone has told you lies. JSON is not the way to go.

If you make it give the response in plaintext, magical things will happen

jk, I don't care what output you do, though it would be nice to see a basic plaintext Minecraft API someday.

Hmmm...
https://api.mcuuid.com/json/name/uuid-here
&
https://api.mcuuid.com/raw/name/uuid-here
I feel like the urls will just end up being long as hell but oh well.
If people want plain text then people will get plain text.

 

[Christopher]

Imgur is blocked, use these:

Spoiler

[DOUBLEPOST=1473143944][/DOUBLEPOST]Server API?

 

[Incrementing]

Imgur is blocked, use these:

Spoiler

Thanks babes
I was going to put them on i.incrementing.pw but... eh... effort.

 

[Christopher]

Thanks babes
I was going to put them on i.incrementing.pw but... eh... effort.

* Self advertising Warning *

Also use i.christophermoore.website because you can take other links (like imgur) and upload it directly without having to download it to your computer using the 'remote' option

Sorry, I had too

 

[Incrementing]

* Self advertising Warning *

The best form of advertising :tup:.

 

[XenoPanel]

Would be nice for simple reasons to have a UUID > Username and Username > UUID.

Some kind of blacklist would be cool too.

 

[Incrementing]

UPDATE: The website has been released (ish).

APIs:
https://api.mcuuid.com/json/name/7944c9ef-a57b-4e4f-b4b3-531d92f579da
https://api.mcuuid.com/json/uuid/Incrementing
or (for txt as Remade requested)
https://api.mcuuid.com/txt/name/7944c9ef-a57b-4e4f-b4b3-531d92f579da
https://api.mcuuid.com/txt/uuid/Incrementing

Please Note:

• All APIs are rated limited to 200 requests per minute (a very reasonable limit).
• The main website is horrible and needs to be changed
• Very limited documentation can be found here (if you can't copy and paste a url?...)
• https://mcuuid.com/q/Incrementing is horrible, unfished and makes me want to commit.

Enjoy?
Let me know what you think?

 

[Incrementing]

You are clearly not a developer. JSON is a very common API response. Most public APIs use either JSON or XML. I don't know of a single API that returns plain text.

Of course I'm not . But as a complete amateur, there should be options available. I have no doubt that parsing JSON is simple, but TXT will always be simpler.

I'd use and do use JSON but I could see why some (n00b) people would want to use plain text.

 

[Christopher]

Still no server API?

 

[Incrementing]

Still no server API?

Blacklist?

Also,
Added past names (txt doesn't return the time they were changed)
https://api.mcuuid.com/json/names/7944c9ef-a57b-4e4f-b4b3-531d92f579da
https://api.mcuuid.com/txt/names/7944c9ef-a57b-4e4f-b4b3-531d92f579da

Fixed the success var on JSON requests, if the username(s)/uuid isn't found the success var will be false.

 

[Christopher]

Blacklist?

Also,
Added past names (txt doesn't return the time they were changed)
https://api.mcuuid.com/json/names/7944c9ef-a57b-4e4f-b4b3-531d92f579da
https://api.mcuuid.com/txt/names/7944c9ef-a57b-4e4f-b4b3-531d92f579da

Fixed the success var on JSON requests, if the username(s)/uuid isn't found the success var will be false.

Online, offline, players, version, etc.

Just an idea.

 

[Incrementing]

Online, offline, players, version, etc.

Just an idea.

I'll add it
Added: Checks for Invalid UUID/Username and Docs for UUID -> Names

 

[Incrementing]

Online, offline, players, version, etc.

Just an idea.

https://api.mcuuid.com/json/server/domain:port

Spoiler: Bungeecord Server (with query enabled)

{
"success": true,
"server": "mc.arespvp.com",
"port": "25565",
"latency": "3ms",
"player_list": "2ms,Incrementing",
"player_count": "2",
"max": "4000",
"software": "Bungeecord",
"version": "1.8.x, 1.9.x, 1.10.x",
"favicon": "N/A",
"received_at": 1474310400885,
"replied_at": 1474310400894,
"request_count": 1,
"max_requests": 200
}

Spoiler: Spigot Server (with query enabled)

{
"success": true,
"server": "192.xx.xxx.xx",
"port": "25565",
"latency": "1ms",
"player_list": "Incrementing,2ms",
"player_count": "2",
"max": "2500",
"software": "CraftBukkit on Bukkit 1.8.8-R0.1-SNAPSHOT",
"version": "1.8.8",
"favicon": "N/A",
"received_at": 1474310581433,
"replied_at": 1474310581442,
"request_count": 1,
"max_requests": 200
}

Spoiler: Any Server (with[B]out[/B] query enabled)

{
"success": false,
"server": "mc.hypixel.net",
"port": "25565",
"latency": "36ms",
"player_list": "N/A",
"player_count": "N/A",
"max": "N/A",
"software": "N/A",
"version": "N/A",
"favicon": "N/A",
"received_at": 1474310631549,
"replied_at": 1474310634593,
"request_count": 2,
"max_requests": 200
}

Spoiler: Offline Server

{
"success": false,
"server": "random.thingy.lol",
"port": "25565",
"latency": "-1ms",
"player_list": "N/A",
"player_count": "N/A",
"max": "N/A",
"software": "N/A",
"version": "N/A",
"favicon": "N/A",
"received_at": 1474310769434,
"replied_at": 1474310769466,
"request_count": 1,
"max_requests": 200
}

I'm still working on the favicon (it will be a base64 encoded image of the favicon).
I'll add it to the documentation later.

 

[Christopher]

Idk if I am just stupid or if there is something wrong with your API because I use this exact code all the time and it works... but not for you:

<?php
$jsonurl='https://api.mcuuid.com/json/server/test.blaa.net:25589';
$json = file_get_contents($jsonurl,0,null,null);
$json = strip_tags($json);
$json_output = var_dump(json_decode($json,true));

echo $json_output;
?>

Returns => NULL

Any ideas?
Incrementing

EDIT: Yes I use a real IP, I have just removed it here.[DOUBLEPOST=1474939462][/DOUBLEPOST]

Idk if I am just stupid or if there is something wrong with your API because I use this exact code all the time and it works... but not for you:

<?php
$jsonurl='https://api.mcuuid.com/json/server/test.blaa.net:25589';
$json = file_get_contents($jsonurl,0,null,null);
$json = strip_tags($json);
$json_output = var_dump(json_decode($json,true));

echo $json_output;
?>

Returns => NULL

Any ideas?
Incrementing

EDIT: Yes I use a real IP, I have just removed it here.

Lyphiard you are a dev, can you help?

 

[Lyphiard]

Idk if I am just stupid or if there is something wrong with your API because I use this exact code all the time and it works... but not for you:

<?php
$jsonurl='https://api.mcuuid.com/json/server/test.blaa.net:25589';
$json = file_get_contents($jsonurl,0,null,null);
$json = strip_tags($json);
$json_output = var_dump(json_decode($json,true));

echo $json_output;
?>

Returns => NULL

Any ideas?
Incrementing

EDIT: Yes I use a real IP, I have just removed it here.[DOUBLEPOST=1474939462][/DOUBLEPOST]
Lyphiard you are a dev, can you help?

smh use cURL. The content contained " " which you didn't strip with strip_tags

$ch = curl_init('https://api.mcuuid.com/json/server/test.blaa.net:25589');
curl_setopt_array($ch, array(
    CURLOPT_SSL_VERIFYPEER => 0,
    CURLOPT_SSL_VERIFYHOST => 0,
    CURLOPT_RETURNTRANSFER => 1
));
$res = curl_exec($ch);

if (!$res) {
    die('Could not connect.');
}

var_dump(json_decode(strip_tags(str_replace(' ', '', $res))));

Incrementing
Please don't output your JSON with html tags & nbsp's...

$data = array(
    'key' => 'value'
);

header('Content-Type: application/json');
echo json_encode($data, JSON_PRETTY_PRINT);

More Suggestions:

• Use "ServerTokens Prod" to avoid showing your server version
• Use nginx, it's so much better than apache
• (personal preference: centos over ubuntu )
• Invalid API endpoints should return a JSON response, not a 404 document