Быстрый старт

Три шага до первого вызова.

1. Создайте ключ

В claritos: Организация → Настройки → API → Создать ключ. Выберите только те scope, которые нужны интеграции. Ключ (capi_…) показывается ровно один раз — сразу скопируйте его.

2. Первый вызов: GET /me

Отправьте ключ как bearer-токен. GET /me возвращает организацию, scope и лимиты вашего доступа — подтверждение, что всё подключено.

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 вместо чистого HTTP

Те же вызовы с официальными SDK — TypeScript (@claritos/api) и Python (claritos). Подробности в руководстве «SDK».

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. Дальше

Изучите справочник, прочитайте про ошибки и пагинацию, затем подключите первую область. Для Zapier, n8n и Make: подпишитесь на вебхуки, когда они станут доступны.