Vendu Developers
StatusGitHubGet API Key

API Changelog

Breaking changes, new endpoints, and deprecations.

v1.0.0
  • NewInitial public release of Vendu v1 API.
  • NewEndpoints: GET/POST /api/v1/orders, GET /api/v1/orders/{id}, GET/POST /api/v1/products, POST /api/v1/products/bulk, GET /api/v1/conversations.
  • NewCursor-based pagination (?cursor= + ?limit=). Legacy ?offset= accepted until 2026-07-31.
  • NewSparse fieldsets: ?fields=id,name,customer.email.
  • NewETag / If-None-Match caching on all GET endpoints.
  • NewRFC 7807 problem details on all error responses (application/problem+json).
  • NewRate limiting: sliding-log per API key, two buckets (read / write). Plans: free 30/5 → enterprise 600/120 per minute.
  • NewX-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset headers on every response.
  • NewOutbound webhooks: order.created, order.status_changed, conversation.started. HMAC-SHA256 signed.
  • Deprecated?offset= pagination deprecated. Sunset: 2026-07-31. Migrate to ?cursor=.
Deprecation policy: Features are deprecated with at least 60 days notice and a Sunset date in response headers. Breaking changes ship only in major versions.