Hosted Gateway & Registry - Getting Started

Quick start guide for using Better Data hosted AI Gateway and Commerce Registry

Hosted Gateway & Registry - Getting Started

Get started with Better Data’s hosted AI Gateway and Commerce Registry in minutes.

Hosted Endpoints:

• Gateway: https://gateway.betterdata.co
• Registry: https://registry.betterdata.co

Prerequisites

• A Better Data account (sign up at app.betterdata.co)
• A commerce platform (Shopify, BigCommerce, WooCommerce, or custom)
• API credentials for your commerce platform

Step 1: Create Gateway Connection

1. Log in to app.betterdata.co
2. Navigate to Integrations → AI Gateway
3. Click Create Gateway
4. Select your commerce platform:
   • Shopify
   • BigCommerce
   • WooCommerce
   • Custom (REST API)

Step 2: Configure Connector

Shopify

{
  "platform": "shopify",
  "storeUrl": "your-store.myshopify.com",
  "storefrontAccessToken": "your-storefront-token",
  "apiVersion": "2024-01"
}

BigCommerce

{
  "platform": "bigcommerce",
  "storeHash": "your-store-hash",
  "accessToken": "your-access-token"
}

WooCommerce

{
  "platform": "woocommerce",
  "storeUrl": "https://yourstore.com",
  "consumerKey": "your-consumer-key",
  "consumerSecret": "your-consumer-secret"
}

Step 3: Register in Commerce Registry

Once your gateway is configured, register it in the Commerce Registry to enable @shop discovery:

curl -X POST https://registry.betterdata.co/api/gateways \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_name": "Your Brand",
    "domain": "yourstore.com",
    "endpoint": "https://gateway.betterdata.co/v1/your-gateway-id",
    "verified": true
  }'

Response:

{
  "id": "gw_123",
  "brand_name": "Your Brand",
  "domain": "yourstore.com",
  "endpoint": "https://gateway.betterdata.co/v1/your-gateway-id",
  "verified": true,
  "created_at": "2024-01-15T10:00:00Z"
}

Step 4: Test Your Gateway

Test with Claude (MCP)

curl -X POST https://gateway.betterdata.co/v1/your-gateway-id/tools \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "claude",
    "session_id": "test-session-123"
  }'

Test with OpenAI (Functions)

curl -X POST https://gateway.betterdata.co/v1/your-gateway-id/tools \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "openai",
    "session_id": "test-session-123"
  }'

Step 5: Enable @shop Discovery

Once registered, users can discover your products via:

• @shop Your Brand - Browse your catalog
• @shop Your Brand product name - Search your products
• @shop 012345678901 - Lookup by GTIN/UPC

Next Steps

• Registry Management
• Gateway Configuration
• Analytics & Monitoring
• API Reference

---

Support

Need help? Contact us at [e-mail] or visit our documentation.