如何在PHP中使用Mojang API

Question

The Mojang API allows you to access information related to the Players that play the game. There is a documenation to the API which can be found here . However, since I am not so experienced with using an API , I'd like to know how to grab Username History of a Player. On the Documentation, under UUID -> Name history there is a URL, https://api.mojang.com/user/profiles/<uuid>/names . I know how to get the UUID of a player, and by using the above URL in PHP, I get this output;

---

[{"name":"JizzInYaTaco22"},{"name":"_scrunch","changedToAt":1423047892000}]

---

How do I style this output to make it only show the names of the player? Here's a link showing what I'd like for it to show: Link

Here's my code:

$username comes from a form on a separate php page.

$username = $_POST["username"];

// Get the userinfo
$content = file_get_contents('https://api.mojang.com/users/profiles/minecraft/' . urlencode($username));

// Decode it
$json = json_decode($content);


// Save the uuid
$uuid = $json->uuid;
var_dump($json, $json->id, $uuid);
// Get the history (using $json->uuid)
$content = file_get_contents('https://api.mojang.com/user/profiles' . urlencode($uuid) . '/names');

// Decode it
$json = json_decode($content);

$names = array(); // Create a new array

foreach ($json as $name) {
    $names[] = $name->name; // Add each "name" value to our array "names"
}

echo 'UUID: ' . $uuid . '<br />Name history: ' . implode(', ', $names);

Answer 1

The data is JSON.

You can request the data using file_get_contents() (which will, by default, execute a GET request) or cURL for a more advanced way of getting data from an URL.

Decoding can be done using json_decode() and reading the properties of the object it creates. Also note that I've used urlencode() in case there's special characters in the username.

<?php

$username = $_POST["username"];
$url = "https://api.mojang.com/users/profiles/minecraft/" . urlencode($username);

$content = file_get_contents($url); // Loads data from an URL
// eg. {"id":"360d11df2b1d41a78e1775df49444128","name":"_scrunch"}

$json = json_decode($content);

print_r($json);
/*
 *  stdClass Object
 *  (
 *      [id] => 360d11df2b1d41a78e1775df49444128
 *      [name] => _scrunch
 *  )
 */

var_dump( $json->id ); // string(32) "360d11df2b1d41a78e1775df49444128"
var_dump( $json->name ); // string(8) "_scrunch"

Let's get a bit more advanced and business-like for just a second in order to increase readability:

class MojangApi {
    const BASE_URL = 'https://api.mojang.com/';

    public static function getInstance() {
        static $instance;

        if ($instance === null) {
            $instance = new MojangApi();
        }

        return $instance;
    }

    protected function callApi($url) {
        $fullUrl = self::BASE_URL . $url;

        $rawJson = file_get_contents($url);

        return json_decode($rawJson);
    }

    public function getUserInfo($username) {
        return $this->callApi('users/profiles/minecraft/' . urlencode($username));
    }

    public function getNames($uuid) {
        $result = $this->callApi(sprintf('user/profiles/%s/names', urlencode($uuid)));

        $names = array();

        foreach ($result as $singleResult) {
            $names[] = $singleResult->name;
        }

        return $names;
    }
}

Usage:

$api = MojangApi::getInstance();

$userInfo = $api->getUserInfo($_POST['username']);

var_dump($userInfo->name); // eg. string(8) "_scrunch"

// ---------------

$usernames =$api->getNames($uuid);

print_r($usernames); // Array ( 'JizzInYaTaco22', '_scrunch' )

You'd be able to extend this class with new methods if you need to contact other parts of their API. Simply call $this->callApi() with the URL that comes after https://api.mojang.com/ .

For your original question, super simplified:

<?php

// Load the username from somewhere
$username = '_scrunch';

// Get the userinfo
$content = file_get_contents('https://api.mojang.com/user/profiles/minecraft/' . urlencode($username));

// Decode it
$json = json_decode($content);

// Check for error
if (!empty($json->error)) {
    die('An error happened: ' . $json->errorMessage);
}

// Save the uuid
$uuid = $json->id;

// Get the history (using $json->uuid)
$content = file_get_contents('https://api.mojang.com/user/profiles/' . urlencode($uuid) . '/names');

// Decode it
$json = json_decode($content);

$names = array(); // Create a new array

foreach ($json as $name) {
    $input = $name->name;

    if (!empty($name->changedToAt)) {
        // Convert to YYYY-MM-DD HH:MM:SS format
        $time = date('Y-m-d H:i:s', $name->changedToAt);

        $input .= ' (changed at ' . $time . ')';
    }

    $names[] = $input; // Add each "name" value to our array "names"
}

echo 'UUID: ' . $uuid . '<br />Name history: ' . implode(', ', $names);