Ceyu

API recipes

Diese Rezepte verwenden den offiziellen Client, begrenzte Pagination und ausdrückliche Fehlerbehandlung. Ihre Anfrageformen werden durch die SDK-Tests ausgeführt.

Formulareingaben als Aufgaben anlegen

import { CeyuApiError, CeyuClient } from "@ceyu/api";

const ceyu = new CeyuClient({ apiKey: process.env.CEYU_API_KEY! });
try {
  await ceyu.createTask({
    workspace: process.env.CEYU_WORKSPACE_ID!,
    project: process.env.CEYU_PROJECT_ID!,
    title: submission.subject,
    description: submission.message,
  }, { idempotencyKey: `form:${submission.id}` });
} catch (error) {
  if (error instanceof CeyuApiError) console.error(error.code, error.requestId);
  throw error;
}

Zeiteinträge schrittweise lesen

Speichere next_cursor nach jeder erfolgreichen Seite und übergib ihn als starting_after. Wähle nur die Felder aus, die die Buchhaltungstransformation benötigt.

Slack nach einer Statusänderung benachrichtigen

Abonniere nur Aufgabenänderungen, prüfe den Rohinhalt, bestätige sofort und sende anschließend aus einer Warteschlange an Slack. Speichere die Ceyu-Ereignis-ID vor dem Senden, damit Wiederholungen folgenlos bleiben.

Zwei-Wege-Synchronisation ohne Schleife

Erstelle das Ziel mit exclude_own_events, speichere die IDs beider Systeme dauerhaft, nutze die externe Änderungs-ID als Idempotency-Key und lehne veraltete Änderungen mit If-Match ab.