{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"d8e29ad9-e017-45b5-8f88-7bec4fafb0c7","name":"SaiGame Unity API","description":"# SaiGame Unity API (debug)\n\nEvery HTTP endpoint the SaiGame Unity package (`Assets/SaiGame/Scripts`, v0.2.60c) calls. Use it to try a call\nby hand, inspect real responses and compare them with what your game receives. Each request lists the Unity method\nthat calls it and has saved example responses.\n\n## Quick start\n1. Import this collection and `SaiGame.unity-api.postman_environment.json`, select the environment.\n2. Set `api_url` (default `https://api.saigame.studio`, no `/api` suffix), `game_id`, `username`, `password`.\n3. **01 Auth > Login** (or Register first). The token is saved to `access_token` automatically.\n4. **02 Gamer Progress > Get my gamer progress** (or Create). The Unity client refuses every game API until\n   gamer progress is loaded, so mirror that here.\n5. Call anything else. List requests save the first result's ID (`shop_id`, `container_id`,\n   `inventory_item_id`, `mailbox_message_id`, ...) for the detail/action requests; edit the variable to target\n   another one.\n\n## Headers sent by Unity\n| Header | Value |\n| --- | --- |\n| `X-Client-Version` | `sai-unity/0.2.60c` |\n| `X-Client-ID` | `{{game_id}}` |\n| `Authorization` | `Bearer {{access_token}}` |\n| `Content-Type` | `application/json` on POST/PUT/PATCH |\n\nErrors use `{ \"error\", \"message\", \"message_code\" }`.\n\n## Variables you may need to fill in\n`recipe_key`, `gacha_pack_id`, `gacha_code`, `gift_code`, `preset_definition_id`, `battle_script_name`,\n`steam_ticket` (fresh, single-use ticket from a running Steam client).\n\nPurchases, crafting, gacha, claims and **Delete my gamer progress** change real data — debug on a test game.\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"401284","team":4911157,"collectionId":"d8e29ad9-e017-45b5-8f88-7bec4fafb0c7","publishedId":"2sBYHbrbq5","public":true,"publicUrl":"https://documenter-api.postman.tech/view/401284/2sBYHbrbq5","privateUrl":"https://go.postman.co/documentation/401284-d8e29ad9-e017-45b5-8f88-7bec4fafb0c7","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":"HTTP API reference for the SaiGame Unity SDK: player login (email, Steam, Google, 2FA), gamer progress, inventory, crafting, gacha, mailbox, shop, daily and chain quests, battle pass, leaderboards and Lua scripts. 95 requests with headers, request bodies and example responses.\n"},{"name":"title","value":"SaiGame Unity API – Game Backend for Auth, Inventory, Quests, Shop &amp; Leaderboards"}],"appearance":{"default":"dark","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.12.12","publishDate":"2026-11-17T18:51:14.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"SaiGame Unity API – Game Backend for Auth, Inventory, Quests, Shop &amp; Leaderboards","description":"HTTP API reference for the SaiGame Unity SDK: player login (email, Steam, Google, 2FA), gamer progress, inventory, crafting, gacha, mailbox, shop, daily and chain quests, battle pass, leaderboards and Lua scripts. 95 requests with headers, request bodies and example responses.\n"},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"SS-GO.unity-client","id":"dddbefa7-4f02-4dd6-a8f6-6d13242b2987","owner":"401284","values":[{"key":"api_url","value":"https://api.saigame.studio","enabled":true,"type":"default"},{"key":"game_id","value":"","enabled":true,"type":"default"},{"key":"qty_item_definition_id","value":"","enabled":true,"type":"default"},{"key":"preset_definition_id","value":"","enabled":true,"type":"default"},{"key":"recipe_key","value":"","enabled":true,"type":"default"},{"key":"gacha_pack_id","value":"","enabled":true,"type":"default"},{"key":"gacha_code","value":"","enabled":true,"type":"default"},{"key":"gift_code","value":"","enabled":true,"type":"default"},{"key":"battle_script_name","value":"","enabled":true,"type":"default"},{"key":"steam_ticket","value":"","enabled":true,"type":"secret"},{"key":"studio_username","value":"","enabled":true,"type":"default"},{"key":"studio_password","value":"","enabled":true,"type":"secret"},{"key":"access_token","value":"","enabled":true,"type":"secret"},{"key":"refresh_token","value":"","enabled":true,"type":"secret"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://postman-image-service.postman.com/api/cloudinary-proxy/postman/image/upload/t_team_logo_pubdoc/v1/team/3bf61a375775a28fda16a0971af32081e4cae2cee8a59e90644093a21dc30299","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"SS-GO.unity-client","value":"401284-dddbefa7-4f02-4dd6-a8f6-6d13242b2987"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sBYHbrbq5"}