Databox

Push API resources Open API documentation, _(*1)

Installation & Usage

Requirements

PHP 7.4 and later. Should also work with PHP 8.0., _(*2)

Composer

To install the bindings via Composer, add the following to composer.json:, _(*3)

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/GIT_USER_ID/GIT_REPO_ID.git"
    }
  ],
  "require": {
    "GIT_USER_ID/GIT_REPO_ID": "*@dev"
  }
}

Then run composer install, _(*4)

Manual Installation

Download the files and include autoload.php:, _(*5)

<?php
require_once('/path/to/Databox/vendor/autoload.php');

Getting Started

Please follow the installation procedure and then run the following:, _(*6)

<?php

require_once __DIR__ . '/../../../vendor/autoload.php';

use Databox\Api\DefaultApi;
use Databox\ApiException;
use Databox\Configuration;
use Databox\Model\PushData as DataboxPushData;
use Databox\Model\PushDataAttribute;
use GuzzleHttp\Client;

execute();

function execute()
{
    // Configure HTTP basic authorization: basicAuth
    $config = Configuration::getDefaultConfiguration()
        ->setHost('https://push.databox.com')
        ->setUsername('<CUSTOM_DATA_TOKEN>');

    $headers = [
        'Content-Type' => 'application/json',
        'Accept'       => 'application/vnd.databox.v2+json'
    ];

    $apiInstance = new DefaultApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
        new Client(['headers' => $headers]),
        $config
    );

    $pushData = (new DataboxPushData())
        ->setKey('<METRIC_KEY_NAME>') // for e.g. sessions
        ->setValue(125)
        ->setDate('2017-01-01T00:00:00Z') // Date in ISO8601 format
        ->setUnit('<UNIT>'); // for e.g. $

    // Optional
    if (true) { // If you want to push data to a specific dimension
        $pushDataAttribute = new PushDataAttribute(
            [
                'key'   => '<DIMENSION_KEY>', // for e.g. country
                'value' => '<DIMENSION_VALUE>' // for e.g. US
            ]
        );

        $pushData->setAttributes([$pushDataAttribute]);
    }

    try {
        $apiInstance->dataPost([$pushData]);
        echo "Successfully pushed data to Databox";
    } catch (ApiException $e) {
        echo 'Exception when calling DefaultApi->dataPost: ' . $e->getMessage() . PHP_EOL . $e->getResponseBody() . PHP_EOL;
    }
}

API Endpoints

All URIs are relative to https://push.databox.com, _(*7)

Class	Method	HTTP request
DefaultApi	dataDelete	DELETE /data
DefaultApi	dataMetricKeyDelete	DELETE /data/{metricKey}
DefaultApi	dataPost	POST /data
DefaultApi	metrickeysGet	GET /metrickeys
DefaultApi	metrickeysPost	POST /metrickeys
DefaultApi	pingGet	GET /ping