Authentication

curl -X POST "https://communication-api.artofluminaire.com/api/v1/oauth/token" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "grant_type": "client_credentials",
  "client_id": "omni_ci_YOUR_CLIENT_ID",
  "client_secret": "omni_sk_live_YOUR_CLIENT_SECRET",
  "scope": "messages.send messages.read"
}'

// Node.js 18+ (built-in fetch), saved as request.mjs for top-level await. Replace the key with your own.
const response = await fetch("https://communication-api.artofluminaire.com/api/v1/oauth/token", {
  method: "POST",
  headers: {
    "Accept": "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "grant_type": "client_credentials",
    "client_id": "omni_ci_YOUR_CLIENT_ID",
    "client_secret": "omni_sk_live_YOUR_CLIENT_SECRET",
    "scope": "messages.send messages.read"
  }),
});

const payload = await response.json();

if (!response.ok) {
  // Every error is { error: { code, message, details, request_id } }.
  throw new Error(`${payload.error.code}: ${payload.error.message} (request ${payload.error.request_id})`);
}

console.log(payload.data);

# pip install requests
import requests

response = requests.post(
    "https://communication-api.artofluminaire.com/api/v1/oauth/token",
    headers={
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json={
        "grant_type": "client_credentials",
        "client_id": "omni_ci_YOUR_CLIENT_ID",
        "client_secret": "omni_sk_live_YOUR_CLIENT_SECRET",
        "scope": "messages.send messages.read",
    },
    timeout=30,
)

payload = response.json()

if not response.ok:
    # Every error is {"error": {"code", "message", "details", "request_id"}}.
    error = payload["error"]
    raise RuntimeError(f"{error['code']}: {error['message']} (request {error['request_id']})")

print(payload["data"])

<?php
// composer require guzzlehttp/guzzle
require 'vendor/autoload.php';

$client = new GuzzleHttp\Client(['http_errors' => false, 'timeout' => 30]);

$response = $client->post('https://communication-api.artofluminaire.com/api/v1/oauth/token', [
    'headers' => [
        'Accept' => 'application/json',
        'Content-Type' => 'application/json',
    ],
    'json' => [
        'grant_type' => 'client_credentials',
        'client_id' => 'omni_ci_YOUR_CLIENT_ID',
        'client_secret' => 'omni_sk_live_YOUR_CLIENT_SECRET',
        'scope' => 'messages.send messages.read',
    ],
]);

$payload = json_decode((string) $response->getBody(), true);

if ($response->getStatusCode() >= 400) {
    // Every error is ['error' => ['code', 'message', 'details', 'request_id']].
    throw new RuntimeException(sprintf('%s: %s (request %s)', $payload['error']['code'], $payload['error']['message'], $payload['error']['request_id']));
}

echo json_encode($payload['data'], JSON_PRETTY_PRINT), PHP_EOL;

// Java 17+, no dependencies (java.net.http). Parse the JSON with your usual library.
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://communication-api.artofluminaire.com/api/v1/oauth/token"))
            .header("Accept", "application/json")
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString("""
            {
                "grant_type": "client_credentials",
                "client_id": "omni_ci_YOUR_CLIENT_ID",
                "client_secret": "omni_sk_live_YOUR_CLIENT_SECRET",
                "scope": "messages.send messages.read"
            }
            """))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

        if (response.statusCode() >= 400) {
            // Every error is {"error": {"code", "message", "details", "request_id"}}.
            throw new RuntimeException("Request failed: " + response.body());
        }

        System.out.println(response.body());
    }
}

// .NET 7+ (C# 11 raw string literals). Parse the JSON with System.Text.Json.
using System;
using System.Net.Http;
using System.Text;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://communication-api.artofluminaire.com/api/v1/oauth/token");
request.Headers.TryAddWithoutValidation("Accept", "application/json");
request.Content = new StringContent("""
{
    "grant_type": "client_credentials",
    "client_id": "omni_ci_YOUR_CLIENT_ID",
    "client_secret": "omni_sk_live_YOUR_CLIENT_SECRET",
    "scope": "messages.send messages.read"
}
""", Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
var payload = await response.Content.ReadAsStringAsync();

if (!response.IsSuccessStatusCode)
{
    // Every error is {"error": {"code", "message", "details", "request_id"}}.
    throw new Exception($"Request failed: {payload}");
}

Console.WriteLine(payload);

// Go 1.20+, standard library only. Decode the JSON with encoding/json.
package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "grant_type": "client_credentials",
  "client_id": "omni_ci_YOUR_CLIENT_ID",
  "client_secret": "omni_sk_live_YOUR_CLIENT_SECRET",
  "scope": "messages.send messages.read"
}`)

	req, err := http.NewRequest("POST", "https://communication-api.artofluminaire.com/api/v1/oauth/token", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	payload, _ := io.ReadAll(resp.Body)

	if resp.StatusCode >= 400 {
		// Every error is {"error": {"code", "message", "details", "request_id"}}.
		panic(fmt.Sprintf("request failed: %s", payload))
	}

	fmt.Println(string(payload))
}