Schnellstart

In drei Schritten zum ersten Aufruf.

1. Schlüssel anlegen

In claritos: Organisation → Einstellungen → API → Schlüssel anlegen. Wähle nur die Scopes, die deine Integration braucht. Der Schlüssel (capi_…) wird genau einmal angezeigt — kopiere ihn sofort.

2. Erster Aufruf: GET /me

Sende den Schlüssel als Bearer-Token. GET /me liefert Organisation, Scopes und Limits deines Zugangs — der Beweis, dass alles verdrahtet ist.

curl

curl https://www.claritos.io/api/v1/me \
  -H "Authorization: Bearer capi_…"

typescript

const res = await fetch("https://www.claritos.io/api/v1/me", {
  headers: { Authorization: "Bearer capi_…" },
});
const me = await res.json();

python

import requests

r = requests.get("https://www.claritos.io/api/v1/me",
    headers={"Authorization": "Bearer capi_…"})
print(r.json())

php

$ch = curl_init("https://www.claritos.io/api/v1/me");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer capi_…"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$me = json_decode(curl_exec($ch), true);

req, _ := http.NewRequest("GET", "https://www.claritos.io/api/v1/me", nil)
req.Header.Set("Authorization", "Bearer capi_…")
res, err := http.DefaultClient.Do(req)

SDK statt rohem HTTP

Dieselben Aufrufe mit den offiziellen SDKs — TypeScript (@claritos/api) und Python (claritos). Details im Leitfaden „SDKs“.

typescript (sdk)

import { createClaritos, metaMe } from "@claritos/api";

const claritos = createClaritos({ apiKey: process.env.CLARITOS_API_KEY! });
const { data: me } = await metaMe({ client: claritos });

python (sdk)

from claritos import create_client
from claritos_api.api.organization import meta_me

client = create_client(api_key="capi_…")
me = meta_me.sync(client=client)

3. Weiter

Referenz durchsehen, Fehlerformat und Paginierung lesen, dann die erste Domäne anbinden. Für Zapier, n8n und Make: Webhooks abonnieren, sobald sie verfügbar sind.