Driple Docs

API Reference

Endpoint format, supported methods, and REST/GraphQL usage.

Base URL

https://api.driple.dev

Endpoint Format

REST API

https://api.driple.dev/shopify/{store-name}/admin/api/{version}/{resource}.json

Example:

# Get products
curl -H "X-Driple-Api-Key: drpl_xxx" \
     -H "X-Shopify-Access-Token: shpat_xxx" \
     "https://api.driple.dev/shopify/my-store/admin/api/2024-01/products.json"

# Create an order
curl -X POST \
     -H "X-Driple-Api-Key: drpl_xxx" \
     -H "X-Shopify-Access-Token: shpat_xxx" \
     -H "Content-Type: application/json" \
     -d '{"order": {"line_items": [{"variant_id": 123, "quantity": 1}]}}' \
     "https://api.driple.dev/shopify/my-store/admin/api/2024-01/orders.json"

GraphQL API

POST https://api.driple.dev/shopify/{store-name}/admin/api/{version}/graphql.json

Example:

curl -X POST \
     -H "X-Driple-Api-Key: drpl_xxx" \
     -H "X-Shopify-Access-Token: shpat_xxx" \
     -H "Content-Type: application/json" \
     -d '{"query": "{ shop { name } }"}' \
     "https://api.driple.dev/shopify/my-store/admin/api/2024-01/graphql.json"

Driple automatically detects GraphQL requests and applies GraphQL-specific rate limiting (cost-based points instead of REST bucket counts).

Supported HTTP Methods

MethodSupport
GETREST reads
POSTREST creates, GraphQL queries/mutations
PUTREST updates
DELETEREST deletes
PATCHREST partial updates
OPTIONSCORS preflight (handled automatically)

URL Mapping

Driple maps your request URL to Shopify transparently:

Query parameters are passed through unchanged:

# Pagination
.../products.json?limit=50&page_info=eyJsYXN0...

# Filtering
.../orders.json?status=open&created_at_min=2024-01-01

Health Check

GET https://api.driple.dev/health

No authentication required. Returns:

{
  "status": "ok",
  "version": "0.1.0",
  "timestamp": "2024-01-15T10:30:00.000Z"
}

CORS

Driple includes CORS headers on all responses:

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, PUT, DELETE, PATCH, OPTIONS
Access-Control-Allow-Headers: *
Access-Control-Max-Age: 86400

Preflight OPTIONS requests are handled automatically with a 204 response.

On this page