API Reference
Endpoint format, supported methods, and REST/GraphQL usage.
Base URL
https://api.driple.devEndpoint Format
REST API
https://api.driple.dev/shopify/{store-name}/admin/api/{version}/{resource}.jsonExample:
# 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.jsonExample:
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
| Method | Support |
|---|---|
GET | REST reads |
POST | REST creates, GraphQL queries/mutations |
PUT | REST updates |
DELETE | REST deletes |
PATCH | REST partial updates |
OPTIONS | CORS 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-01Health Check
GET https://api.driple.dev/healthNo 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: 86400Preflight OPTIONS requests are handled automatically with a 204 response.