{ "openapi": "3.0.3", "info": { "title": "MeGame Reseller API", "version": "1.1.0", "description": "ໃຊ້ສຳລັບຮ້ານທີ່ອະນຸມັດແລ້ວ. ຍອດເງິນເປັນ LAK. ເອີ້ນຈາກ Server ເທົ່ານັ້ນ. ຕັ້ງ Webhook ໃນສູນຕົວແທນ." }, "servers": [ { "url": "https://megametopup.com/api/reseller/v1" } ], "paths": { "/catalog": { "get": { "summary": "ດຶງສິນຄ້າ, ລາຄາ ແລະສະຖານະ", "security": [ { "ApiKey": [] } ], "responses": { "200": { "description": "ສຳເລັດ", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "catalogVersion": { "type": "string", "description": "ລະຫັດລຸ້ນສິນຄ້າ; ປຽບທຽບເປັນຂໍ້ຄວາມ ບໍ່ແມ່ນວັນທີ" }, "generatedAt": { "type": "string" }, "games": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "name": { "type": "string" }, "developer": { "type": "string" }, "image": { "type": "string" }, "fulfillmentType": { "type": "string" }, "inputFields": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "required": { "type": "boolean" }, "type": { "type": "string" } } } }, "servers": { "type": "array", "items": { "type": "string" } }, "verification": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "endpoint": { "type": "string", "enum": [ "/player-check" ] } } }, "available": { "type": "boolean" }, "packages": { "type": "array", "items": { "$ref": "#/components/schemas/Package" } } } } }, "summary": { "type": "object" }, "updates": { "type": "array", "items": { "$ref": "#/components/schemas/CatalogUpdate" } } } } } } }, "400": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/updates": { "get": { "summary": "ກວດລາຄາ ແລະສິນຄ້າປ່ຽນ", "security": [ { "ApiKey": [] } ], "responses": { "200": { "description": "ສຳເລັດ", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "catalogVersion": { "type": "string", "description": "ລະຫັດລຸ້ນສິນຄ້າ; ປຽບທຽບເປັນຂໍ້ຄວາມ ບໍ່ແມ່ນວັນທີ" }, "generatedAt": { "type": "string" }, "summary": { "type": "object" }, "updates": { "type": "array", "items": { "$ref": "#/components/schemas/CatalogUpdate" } } } } } } }, "400": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/profile": { "get": { "summary": "ກວດບັນຊີ ແລະ Agent Balance", "security": [ { "ApiKey": [] } ], "responses": { "200": { "description": "ສຳເລັດ", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/player-check": { "post": { "summary": "ກວດບັນຊີ ແລະຮັບ Token ຢືນຢັນ", "security": [ { "ApiKey": [] } ], "responses": { "200": { "description": "ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlayerResult" } } } }, "400": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "gameId" ], "additionalProperties": false, "properties": { "gameId": { "type": "string", "maxLength": 2000 }, "userId": { "type": "string", "maxLength": 2000 }, "zoneId": { "type": "string", "maxLength": 2000 }, "serverId": { "type": "string", "maxLength": 2000 }, "selectedServer": { "type": "string", "maxLength": 2000 }, "charname": { "type": "string", "maxLength": 2000 }, "account": { "type": "string", "maxLength": 2000 }, "password": { "type": "string", "maxLength": 2000 }, "captcha": { "type": "string", "maxLength": 2000 }, "key": { "type": "string", "maxLength": 2000 }, "captchaToken": { "type": "string", "maxLength": 4096 }, "captchaChallengeToken": { "type": "string", "maxLength": 4096 }, "action": { "type": "string", "maxLength": 2000 } } } } } } } }, "/orders": { "get": { "summary": "ກວດອໍເດີຂອງທ່ານ; ສົ່ງ id ຫຼື idempotencyKey", "security": [ { "ApiKey": [] } ], "responses": { "200": { "description": "ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderResponse" } } } }, "400": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "query", "name": "id", "schema": { "type": "string" }, "required": false }, { "in": "query", "name": "idempotencyKey", "schema": { "type": "string" }, "required": false } ] }, "post": { "summary": "ສ້າງອໍເດີ ແລະຫັກ Agent Balance", "security": [ { "ApiKey": [] } ], "responses": { "200": { "description": "ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderResponse" } } } }, "400": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "ຄຳຂໍບໍ່ສຳເລັດ", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "header", "name": "X-Idempotency-Key", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 160 }, "description": "ໃຊ້ Header ຫຼື JSON; ຖ້າສົ່ງທັງສອງຕ້ອງຄືກັນ" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderRequest" } } } } } } }, "components": { "securitySchemes": { "ApiKey": { "type": "http", "scheme": "bearer", "bearerFormat": "mgtu_live_..." } }, "schemas": { "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "string" }, "code": { "type": "string" }, "currentPrice": { "type": "integer", "minimum": 0 }, "retryAfterSeconds": { "type": "integer", "minimum": 0 } } }, "Package": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "price": { "type": "integer", "minimum": 0 }, "retailPrice": { "type": "integer", "minimum": 0 }, "agentCost": { "type": "integer", "minimum": 0 }, "earningAmount": { "type": "integer", "minimum": 0 }, "image": { "type": "string" }, "available": { "type": "boolean" }, "availabilityCode": { "type": "string" }, "availabilityLabel": { "type": "string" }, "platform": { "type": "string" }, "screenshotRequired": { "type": "boolean" }, "requireOnline": { "type": "boolean" } } }, "CatalogUpdate": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "price_up", "price_down", "out_of_stock", "back_in_stock" ] }, "gameId": { "type": "string" }, "gameName": { "type": "string" }, "packageId": { "type": "string" }, "packageName": { "type": "string" }, "previousPrice": { "type": "integer", "minimum": 0 }, "currentPrice": { "type": "integer", "minimum": 0 }, "priceBasis": { "type": "string", "enum": [ "agent_base_cost" ], "description": "previousPrice/currentPrice ແມ່ນລາຄາຖານຕົວແທນ; ຍອດສັ່ງຊື້ໃຊ້ catalog.price" }, "currentRetailPrice": { "type": "integer", "minimum": 0 }, "currentAgentCost": { "type": "integer", "minimum": 0 } } }, "OrderRequest": { "type": "object", "required": [ "gameId", "packageId", "accountFields" ], "properties": { "gameId": { "type": "string" }, "packageId": { "type": "string" }, "accountFields": { "type": "object", "additionalProperties": { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "maxProperties": 30 }, "idempotencyKey": { "type": "string", "minLength": 8, "maxLength": 160 }, "expectedPrice": { "type": "integer", "minimum": 1 }, "selectedServer": { "type": "string" }, "packagePlatform": { "type": "string" }, "playerVerificationToken": { "type": "string" }, "playerServerId": { "type": "string" }, "playerRoleId": { "type": "string" }, "robloxConfirmedUserId": { "type": "string" }, "proofImage": { "type": "string" }, "proofImages": { "type": "array", "items": { "type": "string" }, "maxItems": 5 }, "emailNotify": { "type": "boolean", "default": true } } }, "Order": { "type": "object", "properties": { "id": { "type": "string" }, "idempotencyKey": { "type": "string" }, "gameId": { "type": "string" }, "gameName": { "type": "string" }, "packageId": { "type": "string" }, "packageName": { "type": "string" }, "price": { "type": "integer", "minimum": 0 }, "status": { "type": "string" }, "accountFields": { "type": "object", "additionalProperties": { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "maxProperties": 30 }, "selectedServer": { "type": "string" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "deliveredKey": { "type": "string" } } }, "OrderResponse": { "type": "object", "properties": { "success": { "type": "boolean" }, "order": { "$ref": "#/components/schemas/Order" } } }, "PlayerResult": { "type": "object", "properties": { "ok": { "type": "boolean" }, "reason": { "type": "string" }, "error": { "type": "string" }, "username": { "type": "string" }, "userId": { "type": "string" }, "id": { "type": "string" }, "displayName": { "type": "string" }, "avatar": { "type": "string" }, "server": { "type": "string" }, "characterName": { "type": "string" }, "serverName": { "type": "string" }, "verificationToken": { "type": "string" }, "verificationExpiresAt": { "type": "integer" }, "verificationUnavailable": { "type": "boolean" }, "verificationSkipped": { "type": "boolean" }, "verificationDisabled": { "type": "boolean" }, "key": { "type": "string" }, "image": { "type": "string" }, "captchaChallengeToken": { "type": "string" }, "captchaNonce": { "type": "string" }, "captchaExpiresAt": { "type": "integer" }, "servers": { "type": "array", "items": { "type": "object" } }, "roles": { "type": "array", "items": { "type": "object" } } } }, "WebhookEvent": { "type": "object", "required": [ "id", "sequence", "type", "createdAt" ], "properties": { "id": { "type": "string" }, "sequence": { "type": "integer", "minimum": 1 }, "createdAt": { "type": "string" }, "type": { "type": "string", "enum": [ "order.created", "order.status_changed", "webhook.test" ] }, "test": { "type": "boolean" }, "order": { "type": "object", "properties": { "id": { "type": "string" }, "idempotencyKey": { "type": "string" }, "status": { "type": "string" }, "previousStatus": { "type": "string" }, "price": { "type": "integer", "minimum": 0 }, "paidAmount": { "type": "integer", "minimum": 0 }, "currency": { "type": "string", "enum": [ "LAK" ] } } } } } } }, "x-megame-webhook": { "description": "ຕັ້ງ URL HTTPS ຢູ່ສູນຕົວແທນ. ຮັບ POST JSON ທີ່ມີລາຍເຊັນ. ຕອບ 2xx ພາຍໃນ 10 ວິນາທີ. ສົ່ງຊ້ຳສູງສຸດ 8 ຄັ້ງ.", "headers": { "X-MeGame-Event-ID": "event.id", "X-MeGame-Timestamp": "Unix seconds", "X-MeGame-Signature": "v1=hex(HMAC-SHA256(secret, timestamp + \".\" + rawBody))" }, "schema": { "$ref": "#/components/schemas/WebhookEvent" } } }