How do I make a simple PHP API handler for Digital Ocean?

@hozza

A very simple way to do this, without curl would be using file_get_contents and streams.

<?php
function doapi( $key, $method, $uri, array $data = [] )
{
    /**
     * DigitalOcean API URI
     */
    $api = 'https://api.digitalocean.com/v2';

    /**
     * Merge DigitalOcean API URI and Endpoint URI
     *
     * i.e if $uri is set to 'domains', then $api ends up as
     *     $api = 'https://api.digitalocean.com/v2/domains'
     */
    $uri = $api . DIRECTORY_SEPARATOR . $uri;

    /**
     * Define Authorization and Content-Type Header.
     */
    $headers = "Authorization: Bearer $key \r\n" .
               "Content-Type: application/json";

    /**
     * If $data array is not empty, assume we're passing data, so we'll encode
     * it and pass it to 'content'. If $data is empty, assume we're not passing
     * data, so we won't sent 'content'.
     */
    if ( ! empty( $data ) )
    {
        $data = [
                    'http'          => [
                        'method'    =>  strtoupper( $method ),
                        'header'    =>  $headers,
                        'content'   =>  json_encode( $data )
                    ]
                ];
    }
    else
    {
        $data = [
                    'http'          => [
                        'method'    =>  strtoupper( $method ),
                        'header'    =>  $headers
                    ]
                ];
    }

    /**
     * Create Stream Context
     * http://php.net/manual/en/function.stream-context-create.php
     */
    $context = stream_context_create( $data );

    /**
     * Send Request and Store to $response.
     */
    $response = file_get_contents( $uri, false, $context );

    /**
     * Return as decoded JSON (i.e. an array)
     */
    return json_decode( $response, true );
}

/**
 * Example Usage
 */

var_dump(doapi(
    'do-api-key',
    'get',
    'domains'
));

An example is at the bottom of the file.

var_dump(doapi(
    'do-api-key',
    'get',
    'domains'
));

Which just dumps the output of the response. You could assign it to a variable, like so:

$response = doapi( 'do-api-key', 'get', 'domains' );

You could then filter through the response as needed. The above is very basic and doesn’t have any sort of error handling built-in, so you’d need to make sure you’re passing exactly what is required.

Looking at the initial function definition:

function doapi( $key, $method, $uri, array $data = [] )

You’ll pass:

$key = DigitalOcean API Key

$method = Upper or Lowercase Method (get, post, delete, etc). It’ll be converted to uppercase.

$uri = The endpoint your calling, without a / (i.e. domains, droplets, etc).

$data = An array of data that isn’t JSON encoded (the function will encode it for you).

…

For $uri, you could pass endpoints with a slash between them, i.e. domains/action (where action is an endpoint off domains`), though no front or trailing slash should be added.

…

I just tested this locally using one of my API keys and it works. Hopefully that’ll help :-).