Développeur

Construisez sur Vendably. API en premier, piloté par webhook, supporté par SDK.

Chaque fonctionnalité Vendably est disponible via une API stable. Les webhooks poussent chaque changement d'état. SDK officiels pour Python, Node, PHP. Construisez des outils internes, des intégrations ou des applications entières sur la plateforme.

REST + gRPC Surface API
Chaque événement Couverture webhook
Python, Node, PHP SDK officiels
// vue d'ensemble

Tout ce que vous voyez dans l'application, exposé en tant qu'API.

Trois surfaces d'intégration couvrent chaque cas d'usage : une API REST et gRPC stable pour interroger et écrire des données, des webhooks pour la diffusion d'événements en temps réel, et des SDK idiomatiques pour ne plus jamais écrire de code d'authentification standard.

API

REST pour usage général, gRPC pour les sous-API à haut débit. OAuth 2.0, périmètres par marchand.

Webhooks

Abonnez-vous à chaque changement d'état. Charges utiles signées. Nouvelle tentative avec backoff exponentiel.

SDKs

Python, Node, PHP de premier ordre. Types TypeScript générés. Exemples d'applications et CLI.

API

Un contrat sur chaque fonctionnalité.

Vendably expose une API REST à /api/v1/ couvrant le modèle de données complet : marchands, produits, sources, destinations, règles, connexions et audit. Chaque réponse est limitée au marchand authentifié afin qu'aucune donnée inter-locataires ne soit accessible quelle que soit la portée du jeton.

Les sous-API à haut débit utilisent gRPC. L'authentification est OAuth 2.0 avec des autorisations de portée par marchand. Les limites de débit s'appliquent par locataire par classe de limitation. Les points de terminaison sont versionnés par sous-API afin que les changements incompatibles n'arrivent jamais sans préavis.

  • OAuth 2.0 avec autorisations de portée par marchand
  • Portées par marchand : jamais d'accès inter-locataires
  • Limites de débit : rafale, soutenu, écritures, classes sensibles
  • Points de terminaison versionnés : par sous-API, contrats stables
Lire la référence API
vendably / api
cURL Python Node
# Create a product via the REST API
curl -X 'POST' \
https://api.vendably.com/api/v1/products/ \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"sku": "ABC-123",
"title": "Wireless headphones",
"price": "49.99",
"currency": "GBP"
}'
201 Created Content-Type: application/json
{
"id": "prod_9a2f7c",
"sku": "ABC-123",
"title": "Wireless headphones",
"status": "active"
}
Webhooks

Chaque changement d'état, livré chez vous.

Abonnez-vous à toute combinaison de sujets d'événements : commandes, produits, avis, mises à jour de dépenses de campagne et alertes système. Chaque livraison porte une charge utile signée HMAC afin que vous puissiez vérifier l'origine avant le traitement.

Les livraisons échouées effectuent de nouvelles tentatives avec backoff exponentiel. Après la fermeture de la fenêtre de nouvelle tentative, les événements non livrés passent dans la file des lettres mortes où vous pouvez inspecter la charge utile, voir le code de réponse et rejouer manuellement.

  • Charges utiles signées HMAC : vérification de l'origine à chaque requête
  • Abonnements aux sujets : commandes, produits, avis, dépenses, alertes
  • Nouvelle tentative exponentielle : jusqu'à 72 heures avant la file des lettres mortes
  • Inspection des lettres mortes et relecture manuelle
événements de webhooks
orders.created
orders.created
2026-05-11T09:14:02Z
200 OK
products.updated
products.updated
2026-05-11T09:13:48Z
200 OK
reviews.submitted
reviews.submitted
2026-05-11T09:12:31Z
200 OK
Livré à https://your-app.example.com/webhooks · 200 OK · 84ms
// orders.created payload (truncated)
{
"topic": "orders.created",
"merchant_id": "mch_ab12cd",
"hmac_sha256": "e3b0c44..."
}
SDKs

Bibliothèques idiomatiques, dans votre pile.

Les SDK officiels pour Python, Node et PHP encapsulent l'API REST avec des modèles de requête et de réponse typés, gèrent le renouvellement des jetons OAuth automatiquement et sont fournis avec des patterns idiomatiques au langage afin que le code d'intégration se lise naturellement.

Les types TypeScript sont générés depuis le schéma OpenAPI à chaque version. Un outil CLI couvre les scripts et les workflows CI. Les exemples d'applications dans le dépôt public couvrent les patterns d'intégration courants depuis zéro.

  • Python : vendably, typé, prêt pour l'async, renouvellement automatique du jeton
  • Node : @vendably/sdk, builds ESM et CJS, TypeScript inclus
  • PHP : vendably/sdk, compatible PSR-7, installable via Composer
  • CLI : vendably, scripts, CI, commandes de réinitialisation sandbox
Voir les exemples SDK
Exemple SDK
Python Node PHP
from vendably import Client
client = Client ( api_key = "vnd_live_..." )
# List products with pagination
products = client.products . list ( limit = 50 )
# Create a product
product = client.products . create (
sku="ABC-123",
title="Wireless headphones",
price="49.99",
currency="GBP",
)
# product.id == "prod_9a2f7c"

La comparaison

Ce que cela coûterait séparément.

La plupart des marchands utilisent un outil séparé pour l'intégration et l'accès API. Voici ce qu'un marchand mid-market typique paie avant Vendably, et ce qui change lorsque l'accès Développeur fait partie d'une seule plateforme.

Outils spécialisés

Plateformes iPaaS ou temps développeur pour construire le code d'assemblage d'intégration

1 500 £ à 20 000 £/mois

Contrats iPaaS ; 500 £ à 1 500 £/mois pour la maintenance continue des développeurs

Plans standard, mid-market. Source : erppeers.com. voir les tarifs ↗

  • Connexion et tableau de bord séparés
  • Données séparées, mappées à la main
  • Frais de mise à niveau par poste ou par produit
  • Maintenance à chaque fois que l'une ou l'autre extrémité de l'intégration modifie son API
Une plateforme Vendably

Accès Développeur, inclus.

Inclusdans chaque plan

Un abonnement. La tarification évolue avec la plage de SKU, pas en fonction des postes par outil.

  • Une connexion, toutes les fonctionnalités
  • Modèle de données partagé, aucun mapping
  • Se connecte automatiquement aux autres fonctionnalités
  • Connectez-vous une seule fois à une API stable déjà comprise dans votre abonnement

Voir la tarification complète Vendably

// inclus dans chaque offre

Construisez quelque chose que seul vous pouvez construire.

L'accès API est inclus dans chaque plan Vendably. Obtenez votre première clé depuis les paramètres et vous êtes en ligne.

Aucun frais par capacité Les six capacités dans chaque offre Annulez à tout moment