01 /Developer Documentation & API Specification
REST & GRAPHQL V2.4 • OAS 3.1 • ZERO RETENTION

Clean Primitives for Autonomous Commerce.

Integrate JB.er's multi-channel inventory mutex, AI catalog enrichment, and headless storefront telemetry directly into your existing CI/CD and ERP workflows.

02 /Interactive Endpoint Reference

Production API Endpoints.

HTTP Request Payload
curl -X POST https://api.jber.dev/v2/catalog/enrich \
  -H "Authorization: Bearer <YOUR_JBER_API_TOKEN>" \
  -H "X-Data-Retention: zero" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "JBER-CERAMIC-VASE-09",
    "channels": ["shopify_plus", "etsy_v3", "amazon_sp"],
    "raw_title": "Handmade minimalist matte black stoneware vessel",
    "image_urls": ["https://cdn.jber.dev/assets/vase-09.jpg"],
    "models": ["claude-3-5-sonnet", "gemini-1-5-flash"]
  }'
200 OK Deterministic Responseapplication/json
{
  "status": "enriched",
  "idempotency_key": "enr_01J9Z8K4M2P7X",
  "retention_policy": "ephemeral_zero_retention",
  "etsy_v3_tags": [
    "matte black vase", "stoneware vessel", "minimalist decor",
    "modern ceramic", "wabi sabi home", "wheel thrown pot",
    "nordic table vase", "artisan pottery", "blackried clay",
    "architectural vase", "dried flower vessel", "shelf styling",
    "handcrafted gift"
  ],
  "shopify_metafields": {
    "material": "High-Fire Stoneware",
    "finish": "Matte Obsidian Glaze",
    "taxonomy_id": "sg-4-17-2"
  },
  "latency_ms": 412
}
/01

HMAC-SHA256 Webhook Guard

Every inbound webhook from Shopify Plus, Etsy v3, and Amazon EventBridge is verified against rotating cryptographic secrets before touching worker memory.

/02

Automatic Rate-Limit Token Buckets

Built-in leaky-bucket and cost-based GraphQL query throttlers prevent 429 Too Many Requests errors during high-concurrency flash sales.

/03

Strict TypeScript & Zod Schemas

End-to-end type safety across storefront RSC payloads, LLM structured outputs, and marketplace mutation responses.