import { Devotel } from '@devotel-orbit/node';

const orbit = new Devotel({ apiKey: process.env.ORBIT_API_KEY });

// orbit.request is the escape hatch for endpoints the typed resources
// do not wrap (here: /analytics/messages). It attaches the API key and
// retries 429/5xx responses automatically.
const report = await orbit.request<{ data: { totals: { delivery_rate: number } } }>(
  'GET',
  '/analytics/messages?channel=sms&status=delivered&start_date=2026-05-01T00:00:00Z&end_date=2026-05-08T00:00:00Z&group_by=day',
);

console.log(report.data.totals.delivery_rate);

from devotel_orbit import Devotel

client = Devotel(api_key=os.environ["ORBIT_API_KEY"])

# client.request is the escape hatch for endpoints the typed clients
# do not wrap; it returns the parsed JSON body as a dict.
report = client.request(
    "GET",
    "/analytics/messages",
    params={
        "channel": "sms",
        "status": "delivered",
        "start_date": "2026-05-01T00:00:00Z",
        "end_date": "2026-05-08T00:00:00Z",
        "group_by": "day",
    },
)

print(report["data"]["totals"]["delivery_rate"])

import (
    "context"
    "log"
    "net/url"
    "os"

    "github.com/devotel/orbit-go/orbit"
)

func main() {
    client, err := orbit.NewClient(os.Getenv("ORBIT_API_KEY"))
    if err != nil {
        panic(err)
    }

    // client.Request is the escape hatch for endpoints the typed
    // resources do not wrap; it unmarshals the body into `out`.
    query := url.Values{
        "channel":    {"sms"},
        "status":     {"delivered"},
        "start_date": {"2026-05-01T00:00:00Z"},
        "end_date":   {"2026-05-08T00:00:00Z"},
        "group_by":   {"day"},
    }
    var report map[string]any
    if err := client.Request(context.Background(), "GET", "/analytics/messages", query, nil, &report, ""); err != nil {
        log.Fatal(err)
    }

    totals := report["data"].(map[string]any)["totals"].(map[string]any)
    log.Println("delivery rate:", totals["delivery_rate"])
}

require "orbit_sdk"

client = OrbitSdk::Client.from_env

# client.request is the escape hatch — returns the parsed body as a Hash.
report = client.request("GET", "/analytics/messages", query: {
  channel: "sms",
  status: "delivered",
  start_date: "2026-05-01T00:00:00Z",
  end_date: "2026-05-08T00:00:00Z",
  group_by: "day",
})

puts "delivery rate: #{report.dig('data', 'totals', 'delivery_rate')}"

use Devotel\Orbit\OrbitClient;

$client = OrbitClient::fromEnv();

// $client->request is the escape hatch — returns the parsed body array.
$report = $client->request('GET', '/analytics/messages', [
    'channel' => 'sms',
    'status' => 'delivered',
    'start_date' => '2026-05-01T00:00:00Z',
    'end_date' => '2026-05-08T00:00:00Z',
    'group_by' => 'day',
]);

echo 'delivery rate: '.$report['data']['totals']['delivery_rate'].PHP_EOL;

import io.devotel.orbit.OrbitClient;

import java.util.LinkedHashMap;
import java.util.Map;

OrbitClient client = OrbitClient.fromEnv();

// client.request is the escape hatch — returns the parsed body as Map.
Map<String, Object> query = new LinkedHashMap<>();
query.put("channel", "sms");
query.put("status", "delivered");
query.put("start_date", "2026-05-01T00:00:00Z");
query.put("end_date", "2026-05-08T00:00:00Z");
query.put("group_by", "day");

Map<String, Object> report = client.request("GET", "/analytics/messages", query, null, null);
Map<?, ?> totals = (Map<?, ?>) ((Map<?, ?>) report.get("data")).get("totals");
System.out.println("delivery rate: " + totals.get("delivery_rate"));

using Orbit.Sdk;

var client = OrbitClient.FromEnv();

// client.RequestAsync is the escape hatch — returns a JsonElement.
var query = new Dictionary<string, object?>
{
    ["channel"] = "sms",
    ["status"] = "delivered",
    ["start_date"] = "2026-05-01T00:00:00Z",
    ["end_date"] = "2026-05-08T00:00:00Z",
    ["group_by"] = "day",
};

var report = await client.RequestAsync("GET", "/analytics/messages", query: query);
var totals = report.GetProperty("data").GetProperty("totals");
Console.WriteLine($"delivery rate: {totals.GetProperty("delivery_rate").GetDouble()}");

import pandas as pd
from devotel_orbit import Devotel

client = Devotel(api_key=os.environ["ORBIT_API_KEY"])

report = client.request(
    "GET",
    "/analytics/messages",
    params={"channel": "sms", "start_date": "2026-05-01T00:00:00Z", "end_date": "2026-05-08T00:00:00Z", "group_by": "day"},
)

frame = pd.DataFrame(report["data"]["time_series"]).set_index("period")
print(frame[["total_sent", "total_delivered", "delivery_rate"]])

const report = await orbit.request<{ data: { time_series: Array<{ period: string; total_sent: number; total_delivered: number }> } }>(
  'GET',
  '/analytics/messages?channel=sms&start_date=2026-05-01T00:00:00Z&end_date=2026-05-08T00:00:00Z&group_by=day',
);

// Recharts, Chart.js, and most BI overlays accept { x, y } point arrays.
const points = report.data.time_series.map((row) => ({
  x: row.period,
  sent: row.total_sent,
  delivered: row.total_delivered,
}));