Obriym CRMObriym CRMCustomer flow workspace
KIFunktionenErste SchrittePreiseRoadmapIntegrationenBlog
DE
  • ukUkrainisch
  • enEnglisch
  • itItalienisch
  • deDeutsch
  • frFrançais
AnmeldenJetzt starten
KIFunktionenErste SchrittePreiseRoadmapIntegrationenBlogAnmeldenJetzt starten

Für Entwickler

Ein Codepfad steuert Oberfläche und API, sodass sie nie auseinanderlaufen können.

Jede Anfrage – aus der Oberfläche oder über die API – läuft durch dieselbe gemeinsame Operationsebene, sodass das Verhalten nie abweicht. Unten finden Sie die technischen Details, die wir bewusst von den Marketingseiten fernhalten: das Auth-Modell, die Idempotenzgarantien, Rate-Limiting, signierte Webhooks und den MCP-Server.

API-Referenz öffnenMCP-Server

POST /api/v1/orders

Authorization: Bearer obr_••••••••

Content-Type: application/json

{ "externalId": "web-10482" }

201 Created

409 IDEMPOTENCY_CONFLICT

API-Zugriff ist eine kostenpflichtige Funktion

Die Dokumentation auf dieser Seite und unter /api-docs ist öffentlich – ohne Konto, ohne Token, ohne Tarif. Zum Aufrufen der API benötigen Sie einen API-Token des Arbeitsbereichs, den die Tarife Team und Scale erstellen können; ein Free-Arbeitsbereich hat keinen. Die kostenpflichtige Berechtigung wird bei jeder Anfrage erneut geprüft, sodass ein Downgrade den Zugriff sofort widerruft und nicht nur neue Tokens blockiert.

Tarife ansehen

Garantien

Was der Vertrag tatsächlich garantiert

Jede Zeile unten beschreibt echten Code, kein Versprechen – überprüfen Sie es mit einer einzigen Anfrage.

01

Vertrag mit Isolation je Arbeitsbereich

Ein Arbeitsbereich ist eine harte Grenze, kein Filter. Jede Operation ermittelt ihre Organisation aus dem vertrauenswürdigen Auth-Kontext – nie aus der Nutzlast der Anfrage –, und jede Abfrage enthält ein Prädikat für den Arbeitsbereich.

  • Die Organisations-ID stammt aus dem Token, nie aus dem Body: Eine Nutzlast kann keinen Arbeitsbereich auswählen
  • Serverfunktionen leiten den Kontext aus der Organisationsrolle von Better Auth ab; die API leitet ihn aus Token-Hash, Scopes und Integrationsquelle ab
  • Beide Grenzen laufen in denselben gemeinsamen Operationen zusammen, sodass Oberfläche und API im Verhalten nicht auseinanderlaufen können
  • Ressourcen mit Quellenbezug prüfen zusätzlich die Integrationsquelle, die sie geschrieben hat

02

Bearer-Tokens mit Scopes

Tokens folgen konstruktionsbedingt dem Prinzip der minimalen Rechte. Sie wählen die Scopes bei der Erstellung, der Token wird einmal angezeigt, und nur sein SHA-256-Hash wird gespeichert.

  • Unabhängige Lese-/Schreib-/Lösch-Scopes je Ressource: Produkte, Leads, Kontakte, Unternehmen, Verkaufschancen, Bestellungen, Kunden, Bestand, Zahlungen, Sendungen, Rücksendungen
  • Nur ein SHA-256-Hash wird gespeichert; der Token im Klartext wird genau einmal angezeigt
  • Der engste erforderliche Scope wird geprüft, bevor irgendeine Geschäftslogik läuft
  • Ein Schutz gegen fehlgeschlagene Authentifizierung pro IP weist einen wiederholt scheiternden Aufrufer ab, bevor die Token-Suche einen Lesezugriff kostet

03

Idempotente Endpunkte mit typisierten Konfliktantworten

Die Annahme ist gefahrlos wiederholbar. Senden Sie dieselbe externalId zweimal, erhalten Sie denselben Datensatz zurück – kein Duplikat und kein stilles Überschreiben.

  • Das erneute Senden einer identischen Nutzlast liefert den vorhandenen Datensatz zurück
  • Eine abweichende Nutzlast unter derselben externalId liefert einen typisierten 409 IDEMPOTENCY_CONFLICT, statt Daten zu überschreiben
  • Gleichzeitige Wiederholungen werden durch ein transaktionsbezogenes Advisory-Lock serialisiert, das auf Arbeitsbereich + Operation + externer ID basiert
  • Dauerhafte Idempotenzeinträge liegen in der Datenbank, sodass Wiederholungen über Deployments und Instanzen hinweg sicher bleiben

04

Verteilter Postgres-Rate-Limiter

Limits mit festem Zeitfenster werden in der Datenbank durchgesetzt, sodass jede Serverless-Instanz denselben Zähler teilt, statt jeweils einen eigenen zu führen.

  • Pro Arbeitsbereich + Integrationsquelle + Endpunkt – eine laute Integration kann das Kontingent einer anderen nicht aufbrauchen
  • x-ratelimit-limit und x-ratelimit-remaining in den Antworten; retry-after bei einem 429
  • Ein Redis-gestütztes Limit kommt hinzu, wenn es konfiguriert ist, und fällt andernfalls sauber auf die Datenbank zurück
  • Das Browser-Widget hat ein eigenes, getrenntes Limit und trägt nie einen Bearer-Token des Arbeitsbereichs

05

Ein Fehlerformat, überall

Jeder Endpunkt – Bearer und Adapter-Webhook gleichermaßen – schlägt auf dieselbe strukturierte Weise fehl, mit einer Request-ID, die Sie uns nennen können.

  • { error: { type, code, message, requestId } } bei jedem Fehler
  • 400 VALIDATION_ERROR · 401 UNAUTHORIZED · 402 SUBSCRIPTION_INACTIVE · 403 FORBIDDEN / PLAN_LIMIT_EXCEEDED · 404 NOT_FOUND · 409 CONFLICT · 429 RATE_LIMITED
  • Die Validierung läuft an der Grenze über Zod, sodass eine fehlerhafte Nutzlast nie die Geschäftslogik erreicht
  • Interne Fehler werden nie preisgegeben: 5xx-Antworten werden serverseitig mit Anfragekontext und ohne Secrets erfasst

06

Signierte Webhooks, eingehend und ausgehend

Ausgehende Ereignisse sind per HMAC signiert, damit Sie uns verifizieren können. Eingehende Adapter prüfen das eigene Signaturverfahren der jeweiligen Plattform, statt dem Absender zu vertrauen.

  • Ausgehend: mit HMAC-SHA256 signierte Zustellungen für Ereignisse wie deal.won, lead.converted, order.delivered
  • Dauerhafte asynchrone Zustellung mit Wiederholungen, wenn QStash konfiguriert ist; synchrone Zustellung, wenn nicht
  • Eingehende Adapter prüfen das tatsächliche Verfahren jeder Plattform – HMAC-SHA256, SHA1, ECDSA oder OAuth –, entnommen der offiziellen Dokumentation dieser Plattform und nie zwischen Adaptern kopiert
  • Ein universeller Endpunkt nimmt { resource: lead | order, data } von Zapier, Make, n8n oder Ihrem eigenen Backend entgegen

07

MCP-Server

Eine dritte Grenze über denselben gemeinsamen Operationen, sodass ein KI-Client den Arbeitsbereich genau mit den Berechtigungen bedient, die auch ein Mensch hätte.

  • Streamable HTTP, zustandslos – nichts zu installieren und kein SSE, das offen gehalten werden muss
  • OAuth-2.1-Verbindung mit einem Klick oder derselbe Bearer-Token mit Scopes wie bei der REST-API
  • Die Tools werden aus Ihrer Rolle im Arbeitsbereich abgeleitet; jedes prüft Scope, Abonnement und sein eigenes Rate-Limit erneut
  • Kein direkter Datenbankzugriff: Jedes Tool läuft über die gemeinsame Operationsebene
  • get_obriym_product_facts liefert geprüfte Produktaussagen, Limits, Preise und den Stand der Integrationen auf Ukrainisch oder Englisch; es bewertet nicht die Konfiguration eines bestimmten Arbeitsbereichs

08

OpenAPI 3.1 und ein Live-Request-Builder

Der Vertrag ist schriftlich festgehalten und wird mit den Routen abgeglichen, die er beschreibt.

  • OpenAPI-3.1-Spezifikation unter /api/v1/openapi.json
  • Interaktive Referenz unter /api-docs mit einem Live-Request-Builder – öffentlich, kein Konto erforderlich
  • Ein maschinenlesbarer Widget-Deskriptor unter /widget.json für Agenten, die gegen die Browser-Grenze entwickeln
  • llms.txt, roadmap.json und changelog.json veröffentlichen dieselben Fakten für KI-Agenten

Loslegen

Bauen Sie darauf auf

Lesen Sie die Referenz, erstellen Sie unter Einstellungen → Integrationen einen Token mit Scopes und integrieren Sie. Die Dokumentation ist für alle offen.

API-Referenz öffnen
Obriym CRMObriym CRMCustomer flow workspace

Obriym CRM ist ein fokussierter Arbeitsbereich für Vertriebsteams und E-Commerce-Abläufe. Leads, Verkaufschancen, Bestellungen und Kundenbindung an einem Ort.

Ein Produkt von OBRIYM

  • crm@obriym.com
  • OBRIYM
  • Serhii Oberemchuk

Individual Entrepreneur Oberemchuk Serhii Oleksandrovych · Staatsregister 178752761226

Produkt

  • CRM für den Handel
  • KI
  • Funktionen
  • Erste Schritte
  • Preise
  • Vergleich
  • Blog
  • Roadmap
  • Integrationen
  • API-Referenz

Unternehmen

  • Über OBRIYM
  • Gründer
  • Kontakt
  • Roadmap

Entwickler

  • Für Entwickler
  • OpenAPI-Spezifikation
  • JS-Widget
  • API zur Lead-Erfassung
  • Bestell-API

©2026Obriym CRM von OBRIYM. Entwickelt für den produktiven Einsatz in Vertrieb und E-Commerce.

NutzungsbedingungenLeistungsbedingungenZahlung und RückerstattungenDatenschutzerklärungUnterauftragsverarbeiterDatenverarbeitungAnbieterangabenDatenlöschungPreiseAPI-Dokumentation