{"openapi":"3.0.0","info":{"title":"FioTech NFT Marketplace API","version":"1.0.0","description":"Official API Documentation for FioTech NFT Marketplace with Vercel Postgres, Vercel Blob & Vercel KV."},"servers":[{"url":"","description":"Current Host"}],"tags":[{"name":"Auth","description":"Authentication and JWT tokens"},{"name":"NFTs","description":"NFT discovery, details, and minting"},{"name":"Collections","description":"NFT collections management"},{"name":"Categories","description":"Category taxonomy"},{"name":"Users","description":"User profiles and creators"},{"name":"Storage","description":"Vercel Blob asset uploads"},{"name":"Stats","description":"Vercel KV analytics and rankings"},{"name":"System","description":"Health check and diagnostics"}],"paths":{"/api/health":{"get":{"tags":["System"],"summary":"System Health Status","responses":{"200":{"description":"API health status OK","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"healthy"},"timestamp":{"type":"string"},"version":{"type":"string","example":"1.0.0"}}}}}}}}},"/api/auth/register":{"post":{"tags":["Auth"],"summary":"Register new user","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["username","password","name"],"properties":{"username":{"type":"string"},"password":{"type":"string"},"name":{"type":"string"}}}}}},"responses":{"201":{"description":"User registered successfully"}}}},"/api/auth/login":{"post":{"tags":["Auth"],"summary":"Log in with credentials","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["username","password"],"properties":{"username":{"type":"string"},"password":{"type":"string"}}}}}},"responses":{"200":{"description":"Logged in successfully with token"}}}},"/api/nfts":{"get":{"tags":["NFTs"],"summary":"List all NFTs with filters","parameters":[{"name":"search","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"collection","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"List of NFTs"}}},"post":{"tags":["NFTs"],"summary":"Create / Mint a new NFT","responses":{"201":{"description":"NFT created successfully"}}}},"/api/nfts/{id}":{"get":{"tags":["NFTs"],"summary":"Get NFT by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"NFT Details"},"404":{"description":"NFT Not Found"}}}},"/api/collections":{"get":{"tags":["Collections"],"summary":"List all collections","responses":{"200":{"description":"List of collections"}}}},"/api/categories":{"get":{"tags":["Categories"],"summary":"List all categories","responses":{"200":{"description":"List of categories"}}}},"/api/upload":{"post":{"tags":["Storage"],"summary":"Upload image/media asset to Vercel Blob","responses":{"200":{"description":"Blob URL and details"}}}},"/api/stats":{"get":{"tags":["Stats"],"summary":"Platform and market stats from Vercel KV","responses":{"200":{"description":"Realtime analytics data"}}}}}}