Obriym CRMObriym CRMCustomer flow workspace
IAFonctionnalitésBien démarrerTarifsFeuille de routeIntégrationsBlog
FR
  • ukУкраїнська
  • enEnglish
  • itItaliano
  • deDeutsch
  • frFrançais
ConnexionCommencer
IAFonctionnalitésBien démarrerTarifsFeuille de routeIntégrationsBlogConnexionCommencer

Pour les développeurs

Un chemin de code conduit l’interface utilisateur et le API, pour qu’ils ne puissent jamais s’éloigner.

Chaque demande — depuis l’interface ou à partir du API — traverse la même couche d’opérations partagées, de sorte que le comportement ne diverge jamais. Voici les détails techniques que nous gardons délibérément hors des pages marketing: le modèle d’auth, les garanties d’idempotency, les limites de taux, les webhooks signés, et le serveur MCP.

Ouverture de la référence APIServeur MCP

POST /api/v1/orders

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

Content-Type: application/json

{ "externalId": "web-10482" }

201 Created

409 IDEMPOTENCY_CONFLICT

API accès est une capacité payée

La documentation sur cette page et sur /api-docs est publique — pas de compte, pas de jeton, pas de plan. Appeler les API a besoin d’un espace de travail API jeton, que les plans Team et Scale peuvent créer; un espace de travail Free n’en a pas. Le droit payé est revérifié sur chaque demande, de sorte qu’une rétrogradation annule l’accès immédiatement plutôt que de bloquer seulement de nouveaux jetons.

Voir plans

Garanties

Ce que le contrat garantit en réalité

Chaque ligne ci-dessous décrit le code réel, et non une promesse — vérifiez - le avec une seule demande.

01

Contrat d’espace de travail isolé

Un espace de travail est une limite dure, pas un filtre. Chaque opération résout son organisation à partir du contexte d’auth confiance — jamais à partir de la charge utile de la requête — et chaque requête porte un prédicat d’espace de travail.

  • L’identifiant de l’organisation vient du jeton, jamais du corps: une charge utile ne peut pas sélectionner un espace de travail
  • Les fonctions du serveur proviennent du rôle d’organisation de Better Auth; le API provient du hachage, des champs d’application et de la source d’intégration
  • Les deux limites convergent sur les mêmes opérations partagées, de sorte que l’assurance-chômage et les API ne peuvent pas dériver séparément dans le comportement
  • Les ressources à champ source vérifient en outre la source d’intégration qui les a écrites

02

Jetons à portée de main

Les jetons sont les moins privilégiés par la construction. Vous choisissez les champs au moment de la création, le jeton est montré une fois, et seulement son SHA-256 hachage est stocké.

  • Espaces de lecture/écriture/delete indépendants par ressource: produits, leads, contacts, entreprises, offres, commandes, clients, stocks, paiements, expéditions, retours
  • Seul un hachage de SHA-256 est maintenu; le jeton en texte simple est affiché exactement une fois
  • La portée la plus étroite requise est vérifiée avant tout travail d’entreprise
  • Un garde d’auth par IP a échoué rejette un appel à plusieurs reprises, avant que la recherche de jeton ne coûte une lecture

03

Critères d’évaluation des idéopontes avec des réponses de conflit dactylographiées

L’absorption est sans danger pour réessayer. Envoyez le même ID externe deux fois et vous obtenez le même enregistrement en retour — pas un duplicata, et pas une écrasement silencieuse.

  • Rejouer une charge utile identique renvoie l’enregistrement existant
  • Une charge utile différente sous le même externalId retourne un code 409 IDEMPOTENCE_CONFLICT plutôt que des données de cambriolage
  • Les replays concurrents sont sérialisés par un verrou de conseil sur l’espace de travail + opération + id externe
  • Enregistrements d’idempotency durables en direct dans la base de données, de sorte que les relevés restent en sécurité pendant les déploiements et les instances

04

Limiteur de taux de Postgres distribué

Les limites de la fenêtre fixe sont appliquées dans la base de données, de sorte que chaque instance sans serveur partage un compteur au lieu de chacun d’entre eux.

  • Par espace de travail + source d’intégration + paramètre — une intégration bruyante ne peut pas dépenser le budget d’un autre
  • x-limite de taux et x-limite de taux restant sur les réponses; réessayer après un 429
  • Redis-backed limiting layers on when configured, et dégrade gracieusement à la base de données quand il n’est pas
  • Le widget de navigateur a sa propre limite séparée et ne porte jamais un jeton d’espace de travail porteur

05

Une enveloppe d’erreur, partout

Chaque point d’arrêt — le porteur et l’adaptateur webhook — échoue de la même manière structurée, avec un id de demande que vous pouvez nous citer.

  • { erreur : { type, code, message, requestId }} sur chaque échec
  • 400 VALIDATION_ERROR · 401 NON AUTORISÉ · 402 SOUSCRIPTION_INACTIVE · 403 FORBIDDEN / PLAN_LIMIT_EXCEED · 404 NON_FOND · 409 CONFLIT · 429 TAUX_LIMITÉS
  • La validation passe à la frontière par Zod, donc une mauvaise charge utile n’atteint jamais la logique commerciale
  • Les erreurs internes ne sont jamais divulguées : les réponses 5xx sont saisies côté serveur avec le contexte de requête et aucun secret

06

Des webhooks signés, entrées et sorties

Les événements sortants sont signés à HMAC afin que vous puissiez nous vérifier. Les adaptateurs entrants vérifient le système de signature propre de la plateforme plutôt que de faire confiance à l’expéditeur.

  • Sortie: HMAC-SHA256 livraisons signées pour des événements tels que deal.won, lead.converted, order.livered
  • Livraison async durable avec rétries lorsque QStash est configuré; livraison synchrone quand il n’est pas
  • Les adaptateurs entrants vérifient le régime réel de chaque plateforme — HMAC-SHA256, SHA1, ECDSA ou OAuth — lu à partir des documents officiels de cette plate-forme, jamais copié entre les adaptateurs
  • Un paramètre universel accepte { resource: lead | order, data } de Zapier, Make, n8n, ou votre propre moteur

07

Serveur MCP

Une troisième limite sur les mêmes opérations partagées, de sorte qu’un client de IA exploite l’espace de travail sous exactement les permissions qu’un humain obtiendrait.

  • HTTP Streamable, apatride — rien à installer et pas de SSE pour rester en vie
  • Connexion OAuth 2.1 en un clic, ou le même jeton Bearer à permissions limitées que pour l’API REST
  • Les outils sont projetés à partir de votre rôle d’espace de travail; chacun revérifie son champ d’application, l’abonnement et sa limite de tarifs
  • Pas d’accès direct à la base de données : chaque outil passe par la couche des opérations partagées
  • get_obriym_product_facts fournit des demandes de produits examinées, des limites, des prix et une préparation à l’intégration en ukrainien ou en anglais; il n’évalue pas une configuration particulière de l’espace de travail.

08

OpenAPI 3.1 et un constructeur de requête en direct

Le contrat est rédigé et maintenu en phase avec les itinéraires qu’il décrit.

  • OpenAPI 3.1 spec à /api/v1/openapi.json
  • Référence interactive chez /api-docs avec un constructeur de demande en direct — public, aucun compte requis
  • Un descripteur de widget lisible par machine à /widget.json pour les agents construisant contre la limite du navigateur
  • llms.txt, feuille de route.json et changelog.json publient les mêmes faits pour IA agents

Commencez.

Construisez contre elle

Lire la référence, créer un jeton scoped dans Paramètres → Intégrations, et intégrer. Les docs sont ouverts à tous.

Ouverture de la référence API
Obriym CRMObriym CRMCustomer flow workspace

Obriym CRM réunit les ventes et le commerce en ligne : prospects, opportunités, commandes et fidélisation des clients dans un seul espace.

Un produit OBRIYM

  • crm@obriym.com
  • OBRIYM
  • Serhii Oberemchuk

Individual Entrepreneur Oberemchuk Serhii Oleksandrovych · Enregistrement d’État 178752761226

Produit

  • Commerce CRM
  • IA
  • Caractéristiques
  • Commencer
  • Tarifs
  • Comparer
  • Blog
  • Feuille de route
  • Intégrations
  • Documentation API

Entreprise

  • Environ OBRIYM
  • Fondateur
  • Personne à contacter
  • Feuille de route

Développeurs

  • Pour les développeurs
  • Documentation API
  • JS Widget
  • API de collecte de prospects
  • API de commandes

©2026Obriym CRM par OBRIYM. Construit pour les ventes de production et les équipes de commerce électronique.

Conditions d’utilisationOffre publiquePaiement et remboursementsPolitique de confidentialitéSous-traitantsTraitement des donnéesMentions légalesSuppression des donnéesTarifsDocumentation API