Quantum API v1

Backend API for Meta-PTCG decklist processing, shortcode resolution, and card lookup.

Base URL: https://uri.meta-ptcg.org/api/v1

Documentation: See deploy/ folder for comprehensive integration guides

Available Endpoints

POST /api/v1/decklist

Process decklist import/export (Quantum Format ↔ Quantum Viewer JSON)

Request: { "decklist": "Pokémon: 4\n1 Oddish SOA 001\n..." }
Response: { "success": true, "cards": [...], "stats": {...} }

GET /api/v1/shortcode/{SET}-{NUMBER}

Resolve shortcode to card data (e.g., /api/v1/shortcode/SOA-001)

Example: GET /api/v1/shortcode/SOA-001
Response: { "success": true, "card": {...} }

GET /api/v1/card/{meta}/{set}/{number}

Get card by path (e.g., /api/v1/card/all-era/soaring_titans/001)

Status: Implementation pending

GET /api/v1/url/sanitize?url={encoded}

Sanitize and shorten CDN URLs

Example: GET /api/v1/url/sanitize?url=https://cdn.meta-ptcg.org/...

GET /api/v1/proxy/external

Proxy external images with caching

API JSON Schema
Integration Guides:
- deploy/API_INTEGRATION.md - Complete API guide
- deploy/CDN_INTEGRATION.md - CDN integration
- deploy/CROSS_SERVICE_COMMUNICATION.md - Service communication
Backend Architecture:
- docs/API_BACKEND_ARCHITECTURE.md - Comprehensive backend docs

API Version: 1.0 | Last Updated: 2025-01-11 | Documentation: GitHub Docs