MeshHub Developer Portal

Integration guide

The canonical spec — authentication, conventions, the async task model, every endpoint, webhooks, and a quick start.

• Tenant integration guide (markdown)

Adding signup to your website

Put a "Create account" form on your own marketing site. One open endpoint, no API key needed, and the visitor lands in their dashboard already signed in.

• Signup integration (markdown)

Live API schema

OpenAPI 3 contract generated from the running API — always in sync. Load it directly into codegen and AI tools.

• OpenAPI schema (JSON)
• OpenAPI schema (YAML)
• Interactive API explorer (Swagger UI)

API playground

Drive the full flow — search, book, pay, track, cancel — from your browser with the API key issued for your tenant. Every request and response is shown in an inspector you can copy into your integration.

• Open the playground

SDKs

The official TypeScript SDK wraps every endpoint with typed requests and responses, task polling, webhook signature verification, and unified error handling.

• @meshhub/sdk on npm
• SDK README (markdown)

Starter kit

The fastest paths from zero to a working shop.

• Thin-frontend reference example — a complete minimal shop (browser → your backend → MeshHub; the API key stays server-side)
• Postman collection — ready to import: mint key → search → book → pay → orders
• AI-builder prompt — paste into Replit Agent (or similar) to generate a working shop with safe key handling

For AI builders

AI-ingestible indexes of this documentation, following the llms.txt convention.

• llms.txt — index with links
• llms-full.txt — full docs in one file

Quick start

Mint a free 30-day trial key and run a first search — no signup:

# 1. Get a key (once — reuse it; minting is capped at 3/hour per IP)
curl -s -X POST https://merchant.meshhub.ai/api/v1/auth/trial-keys/
# → 201 {"key": "mh_...", "expires_at": ..., "scopes": [...]}

# 2. Search (async: 202 + task_id)
curl -s -X POST https://merchant.meshhub.ai/api/v1/search/ \
  -H "X-MH-Key: $MESHHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "category": "shipping",
        "currency": "EUR",
        "extra": {"origin": "LT", "destination": "DE", "weight_kg": 1}
      }'

# 3. Poll — immediately, then back off
curl -s https://merchant.meshhub.ai/api/v1/tasks/$TASK_ID/ \
  -H "X-MH-Key: $MESHHUB_API_KEY"
# when "status" is "completed", the offers are in result.offers

The integration guide (§12) continues from here through book, pay, and order history.