{"openapi":"3.1.0","info":{"title":"Playzor Minecraft Server Hosting API","description":"India's #1 Premium Minecraft Server Hosting — Enterprise-grade hardware, NVMe SSD, DDoS protection. Manage servers, billing, and configurations programmatically.","version":"1.0.0","contact":{"name":"Playzor Support","email":"info@playzor.me","url":"https://playzor.me"},"license":{"name":"Proprietary","url":"https://playzor.me/terms"},"x-service-info":{"name":"Playzor","categories":["game-hosting","minecraft-hosting","cloud-infrastructure"],"regions":["IN","SG"]}},"servers":[{"url":"https://playzor.me/api/v1","description":"Production API"}],"paths":{"/servers":{"get":{"operationId":"listServers","summary":"List all servers","description":"List all Minecraft servers belonging to the authenticated user.","tags":["Servers"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"List of servers","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Server"}}}}}}},"post":{"operationId":"createServer","summary":"Create a new Minecraft server","description":"Provision a new Minecraft server with the specified plan and configuration.","tags":["Servers"],"security":[{"bearerAuth":[]}],"x-payment-info":{"intent":"charge","method":"card","amount":199,"currency":"INR","description":"Server creation starting from ₹199/month"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateServerRequest"}}}},"responses":{"201":{"description":"Server created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Server"}}}},"402":{"description":"Payment required"}}}},"/servers/{serverId}":{"get":{"operationId":"getServer","summary":"Get server details","tags":["Servers"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"serverId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Server details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Server"}}}}}},"delete":{"operationId":"deleteServer","summary":"Delete a server","tags":["Servers"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"serverId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Server deleted"}}}},"/servers/{serverId}/start":{"post":{"operationId":"startServer","summary":"Start a server","tags":["Servers"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"serverId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Server started"}}}},"/servers/{serverId}/stop":{"post":{"operationId":"stopServer","summary":"Stop a server","tags":["Servers"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"serverId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Server stopped"}}}},"/plans":{"get":{"operationId":"listPlans","summary":"List available hosting plans","description":"Get all available Minecraft server hosting plans with pricing.","tags":["Plans"],"responses":{"200":{"description":"Available plans","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Plan"}}}}}}}},"/plans/{planId}/upgrade":{"post":{"operationId":"upgradePlan","summary":"Upgrade server plan","tags":["Plans"],"security":[{"bearerAuth":[]}],"x-payment-info":{"intent":"charge","method":"card","amount":200,"currency":"INR","description":"Plan upgrade with prorated billing"},"parameters":[{"name":"planId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Plan upgraded"},"402":{"description":"Payment required"}}}},"/health":{"get":{"operationId":"healthCheck","summary":"Health check","tags":["System"],"responses":{"200":{"description":"Service is healthy"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Obtain a token via the OIDC flow at /.well-known/openid-configuration"}},"schemas":{"Server":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"plan":{"type":"string","enum":["iron","gold","diamond","netherite"]},"status":{"type":"string","enum":["running","stopped","provisioning","error"]},"region":{"type":"string","enum":["ap-south-1","ap-southeast-1"]},"ip":{"type":"string"},"port":{"type":"integer"},"software":{"type":"string"},"version":{"type":"string"},"ram_mb":{"type":"integer"},"storage_gb":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"}}},"CreateServerRequest":{"type":"object","required":["name","plan","region"],"properties":{"name":{"type":"string","minLength":3,"maxLength":32},"plan":{"type":"string","enum":["iron","gold","diamond","netherite"]},"region":{"type":"string","enum":["ap-south-1","ap-southeast-1"]},"software":{"type":"string","default":"paper"},"version":{"type":"string","default":"latest"}}},"Plan":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ram_mb":{"type":"integer"},"vcpu":{"type":"integer"},"storage_gb":{"type":"integer"},"price_inr":{"type":"integer"},"features":{"type":"array","items":{"type":"string"}}}}}}}