Skip to main content
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)

1

Dodaj węzeł Webhook

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

Utwórz subskrypcję webhook w clarife

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
3

Zweryfikuj podpis

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

​
Tworzenie dokumentu z n8n

{
  "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

1

Dodaj moduł Custom Webhook

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

Zarejestruj webhook w clarife

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
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

1

Utwórz nowy Zap

Wybierz trigger Webhooks by Zapier > Catch Hook.
2

Skopiuj URL webhooka

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

Zarejestruj webhook w clarife

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
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.
Dla wszystkich platform zalecamy korzystanie z webhooków zamiast pollowania — zmniejsza to liczbę zapytań API i daje natychmiastowe powiadomienia.