Centrum pomocy

Przykłady integracji

API clarife można łatwo podłączyć do popularnych platform automatyzacji. Poniżej znajdziesz instrukcje dla n8n, Make (Integromat) i Zapier.

n8n

n8n to open-source platforma automatyzacji. clarife podłączysz przez węzły HTTP Request i Webhook.

Pobieranie dokumentów (polling)

  1. Dodaj węzeł Schedule Trigger - Ustaw interwał (np. co 5 minut).
  2. Dodaj węzeł HTTP Request - Skonfiguruj:
    • Method: GET
    • URL: https://my.clarife.app/api/v1/documents?limit=10&sort=updated_at&order=desc
    • Authentication: Header Auth
    • Header Name: Authorization
    • Header Value: Bearer clrf_xxxxx
  3. Przetwarzaj wyniki - Dodaj kolejne węzły do przetwarzania danych z odpowiedzi (np. filtrowanie, zapis do bazy, powiadomienia).

Webhook (real-time)

Krok 1 - Dodaj węzeł Webhook

Skopiuj URL webhooka wygenerowany przez n8n (np. https://n8n.example.com/webhook/abc123).

Krok 2 - Utwórz subskrypcję webhook w clarife

bash
curl -s -X POST https://my.clarife.app/api/webhooks/subscriptions \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "n8n integration",
    "url": "https://n8n.example.com/webhook/abc123",
    "events": ["document.created", "document.updated"]
  }' | jq

Krok 3 - Zweryfikuj podpis

Dodaj węzeł Function do weryfikacji nagłówka X-Clarife-Signature (patrz Webhooki).

Tworzenie dokumentu z n8n

json
{
  "method": "POST",
  "url": "https://my.clarife.app/api/v1/documents",
  "headers": {
    "Authorization": "Bearer clrf_xxxxx",
    "Content-Type": "application/json"
  },
  "body": {
    "title": "{{ $json.title }}",
    "description": "Automatycznie utworzony z n8n",
    "project_id": "p1234567-..."
  }
}

Make (Integromat)

Make umożliwia tworzenie scenariuszy automatyzacji za pomocą interfejsu drag-and-drop.

Konfiguracja modułu HTTP

  1. Dodaj moduł HTTP > Make a request - Skonfiguruj:
    • URL: https://my.clarife.app/api/v1/documents
    • Method: GET
    • Headers:
      • Authorization: Bearer clrf_xxxxx
  2. Parsuj odpowiedź - Dodaj moduł JSON > Parse JSON i zmapuj data z odpowiedzi.
  3. Iteruj po dokumentach - Użyj modułu Iterator na tablicy data, aby przetworzyć każdy dokument osobno.

Webhook w Make

Krok 1 - Dodaj moduł Custom Webhook

Make wygeneruje URL (np. https://hook.make.com/abc123xyz).

Krok 2 - Zarejestruj webhook w clarife

bash
curl -s -X POST https://my.clarife.app/api/webhooks/subscriptions \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Make integration",
    "url": "https://hook.make.com/abc123xyz",
    "events": ["document.created", "share.created"]
  }' | jq

Krok 3 - Określ strukturę danych

Kliknij Redetermine data structure w module Webhook po otrzymaniu pierwszego zdarzenia.

Zapier

Zapier obsługuje API clarife przez akcje Webhooks by Zapier.

Trigger: Catch Hook

Krok 1 - Utwórz nowy Zap

Wybierz trigger Webhooks by Zapier > Catch Hook.

Krok 2 - Skopiuj URL webhooka

Zapier wygeneruje URL (np. https://hooks.zapier.com/hooks/catch/123/abc/).

Krok 3 - Zarejestruj webhook w clarife

bash
curl -s -X POST https://my.clarife.app/api/webhooks/subscriptions \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Zapier integration",
    "url": "https://hooks.zapier.com/hooks/catch/123/abc/",
    "events": ["document.created"]
  }' | jq

Krok 4 - Przetestuj trigger

Wyślij zdarzenie testowe z clarife, a następnie kliknij Test trigger w Zapier.

Action: POST do API

  1. Dodaj akcję Webhooks by Zapier > POST - Skonfiguruj:
    • URL: https://my.clarife.app/api/v1/documents
    • Payload Type: json
    • Data: title = wartość z triggera
    • Headers: Authorization | Bearer clrf_xxxxx

Podsumowanie

  • n8n - Open-source, self-hosted. Pełna kontrola nad danymi. Idealne dla zespołów technicznych.
  • Make - Wizualny kreator scenariuszy. Bogate opcje filtrowania i transformacji danych.
  • Zapier - Najprostsza konfiguracja. Największa biblioteka integracji z innymi aplikacjami.

💡 Wskazówka: Dla wszystkich platform zalecamy korzystanie z webhooków zamiast pollowania - zmniejsza to liczbę zapytań API i daje natychmiastowe powiadomienia.