Skip to main content

​
Czym jest API clarife

API clarife umożliwia programowy dostęp do Twojego konta — tworzenie dokumentów, zarządzanie projektami, konfigurowanie udostępnień i wiele więcej. Wszystko, co robisz w interfejsie webowym, jest dostępne przez REST API.

Deweloperzy

Buduj integracje i automatyzacje z własnymi narzędziami.

Agenty AI

Podłącz Claude, GPT lub inne modele przez MCP lub REST.

Automatyzacja

Połącz clarife z n8n, Make, Zapier i innymi platformami.

​
Wymagania planowe

API jest dostępne na planach Pro i Business.
FunkcjaProBusiness
Limit zapytań100 req/min500 req/min
Klucze APIdo 5do 20
Subskrypcje webhookówdo 3do 20
Serwer MCPtaktak
Plan Free nie ma dostępu do API. Zaktualizuj plan w Ustawienia > Plany i płatności.

​
Base URL

Wszystkie endpointy API znajdują się pod adresem: 
https://my.clarife.app/api/v1

​
Szybki start

1

Utwórz klucz API

Przejdź do Ustawienia > API i kliknij Utwórz klucz. Skopiuj klucz — zobaczysz go tylko raz.
2

Wyślij pierwsze zapytanie

Sprawdź połączenie wywołując endpoint /me:
curl -s https://my.clarife.app/api/v1/me \
  -H "Authorization: Bearer clrf_xxxxx" | jq
3

Pobierz listę dokumentów

curl -s "https://my.clarife.app/api/v1/documents?limit=5" \
  -H "Authorization: Bearer clrf_xxxxx" | jq

​
Format odpowiedzi

Wszystkie odpowiedzi zwracane są w formacie JSON. Sukces (listy z paginacją): 
{
  "data": [...],
  "total": 42,
  "limit": 50,
  "offset": 0
}
Sukces (pojedynczy zasób): 
{
  "id": "uuid",
  "title": "Mój tutorial",
  "created_at": "2026-03-28T12:00:00Z"
}
Błąd: 
{
  "error": "Document not found",
  "code": "NOT_FOUND"
}

​
Następne kroki

Uwierzytelnianie

Tworzenie kluczy API i zarządzanie scopami.

Dokumenty

CRUD na dokumentach — główny zasób platformy.

Webhooki

Powiadomienia w czasie rzeczywistym o zmianach.

Serwer MCP

Podłącz agenta AI przez Model Context Protocol.