01/10/2025 10:53:00
Solution
I. Common error return codes
| Return code | Return code description | Detailed description |
|---|---|---|
| 0 | Client callback success | - |
| -1000 | SDK parameter error | - |
| -1001 | SDK is not initialized | - |
| -1002 | SDK internal error | - |
| -1003 | network request exception | - |
| -1004 | User does not log in | - |
| -1005 | User cancels operation | - |
| -1006 | Initialization exception | - |
| -1007 | Kwai is not installed | - |
| -1008 | Automatic login failed and scope delivery changes. Need to log in again | - |
| 6001 | Sharing failed | - |
| 6002 | Sharing is canceled | - |
| 6003 | Sharing data error | - |
| 6004 | The sharing channel is not supported | - |
| 7001 | Unsupported share type (iOS) | - |
| 7002 | No album permission. Please skip to the settings to enable (iOS) | - |
II. Sharing error return code
| Return code | Return code description | Detailed description |
|---|---|---|
| -1011 | Kwai is not logged in | message |
| -1010 | Error parameter | message |
| -1006 | Kwai does not support function | message |
| -1005 | Kwai is not installed | message |
| -1 | User cancels operation | message |
| 1 | Sharing success | message |
| 20088 | No operation permission | message |
| 20089 | Unable to get gameId's corresponding Kwai userId | message |
| 20090 | Invalid command word | message |
| 20091 | GameId is not the same user as the current user logging in Kwai | message |
| 20092 | targetGameId is not your friend | message |
| 20094 | Invalid targetGameId | message |
| 100200100 | Invalid parameter | message |
| 1001 | Parameter error | video |
| 1000 | Unsupported video share type | video |
| 7002 | No album permission. Please skip to the settings to enable (iOS) | video |
III. oauth authorization error return codes
| Return code | Return code description | Detailed description |
|---|---|---|
| 1 | Success | - |
| 100200100 | Request parameter missing or format error | - |
| 100200101 | Unauthorized client, invalid app or developer | - |
| 100200102 | The request is rejected. It may be an invalid token, etc. | - |
| 100200103 | Request's responseType error | - |
| 100200104 | Request's grantType is not supported | - |
| 100200105 | Request's code errors | - |
| 100200106 | Request's scope errors | - |
| 100200107 | Invalid openid | - |
| 100200108 | access_token or refresh_token expired | - |
| 100200109 | The user cancels the app's authorization | - |
| 100200110 | The User's authorization expired | - |
| 100200111 | The user has not been authorized | - |
| 100200112 | bundleToken is illegal | - |
| 100200410 | api limits traffic | - |
| 100200300 | SMS verification code error | - |
| 100200301 | The merchant does not exist | - |
| 100200302 | The developer does not exist | - |
| 100200303 | The merchant already has a developer | - |
| 100200304 | Developer status is wrong | - |
| 100200312 | App does not exist | - |
| 100200313 | There are already the same type of apps for unified developers | - |
| 100200314 | App status is wrong | - |
| 100200220 | No operation permission | - |
| 100200500 | Server's internal error | - |
IV. Server errors' return codes
| Return code | Return code description | Detailed description |
|---|---|---|
| 1 | Success | - |
| 100200100 | Request parameter missing or format error | - |
| 100200500 | Server's internal error | - |
| 100200600 | Signature error | - |
| 100200601 | Timestamp error | - |
| 100201000 | Account binding failed | - |
| 100201001 | Authorization failed. Need to call SDK's login interface again | - |
| 100202101 | The Kwai account has been bound by other users | - |
| 100201102 | The current account has been bound by other Kwai accounts | - |
| 100201106 | The user has not yet bound a Kwai account | - |
| 100201107 | Kwai account does not register the current game | - |
| 100201108 | gameId is not bound on the game side | - |
| 100201109 | The main app token is invalid | - |
| 100201110 | The master station user does not exist | - |
| 100201111 | Kwai oauth code is invalid | - |
| 100202000 | TOKEN error. Need to call SDK's login interface again | - |
| 100202001 | TOKEN expired. Need to call SDK's login interface again | - |
| 100203000 | Live broadcast-related exception | - |
| 100203001 | The gift is sent repeatedly | - |
| 100203002 | Kwai account not bound to the live broadcast | - |
| 100203003 | Watch the live broadcast without authorization | - |
| 100203004 | The live room's id and the game's uid do not match | - |
| 100204000 | ID card binding error | - |
| 100204001 | The user has been bound to another identity | - |
| 100205001 | No push permission | - |
| 100205002 | No im permission | - |
| 100205003 | Abtest permission is not activated yet | - |
| 100205004 | The feedback permission is not activated yet | - |
| 100206001 | appId does not exist | - |
| 100207001 | Failed to get LINKMIC id | - |
| 100207002 | The necessary configuration is missing | - |
| 100207003 | Download exception | - |
| 100207004 | No such file | - |
| 100208000 | cdkey format error | - |
| 100208001 | cdkey and app_id do not match | - |
| 100208002 | The gift package has not yet begun to be redeemed | - |
| 100208003 | CDKEY has expired | - |
| 100208004 | CDKEY has been used (out of use) | - |
| 100208005 | The gift package cannot be taken repeatedly | - |
| 100208006 | The gift package channel does not match the account channel | - |
| 100208007 | gameId does not match the game character id | - |
| 100208008 | The gift package props do not exist | - |
| 100208009 | The gift package does not exist | - |
| 100208010 | The number of cdkey exchanges has reached the upper limit | - |
| 100208011 | Failed to receive the gift package | - |
| 100209000 | Failed to upload cdn | - |
| 100209001 | Duplicate file name | - |
| 100210000 | Failed to receive rewards for Spring Festival activities | - |
| 100211000 | There is no channel package to update | - |
| 100212000 | The user does not enable the automatic synchronization of Kwai works | - |
| 100213000 | Verification code error | - |
| 100213001 | Mobile phone number error | - |
| 100213002 | Send verification codes too frequently | - |
Special description:
A. 100200101 means an unauthorized client, invalid app or developer. It is needed to check if KWAI_APP_ID in MSDKConfig.ini and the Kwai ID recorded on Feiying System -> Game Management -> My Game- > SDK Information Page are consistent.
B. 100201001 means that the authorization fails. The login interface needs to be called again. It is needed to pay attention to the following points.
- When an error related to Kwai authorization occurs, the login interface needs to be called again to allow the user to re-authorize login;
- Kwai authorization errors generally occur in scenarios where the access function exceeds the scope of the Scope permission or the authorization function has not been accessed for a long time. The game needs to handle these scenarios correctly;
C. 100202001 means that TOKEN expires and the login interface needs to be called again. It is needed to pay attention to the following points.
- (1) The expiration time of TOKEN is 30 days (it is configurable; if you want to configure it, you need to contact MSDK Assistant for docking). After the first login and after each call of automatic login, the validity period of your token will be kindly extended;
- It is recommended that all access parties should first actively call automatic login to refresh TOKEN when cold starting their apps each time after actually authorizing login with KwaiGameSDK successfully and obtaining the user information. If the automatic login fails, call login again and re-authorize login;
- When using KwaiGameSDK and Kwai game middle-end business, if you encounter the TOKEN expiration error 100202001, you need to call KwaiGameSDK's RefreshToken interface to refresh TOKEN, and call the function again;
- TOKEN is different after each refresh (Login, AutoLogin, RefreshToken);
D. As for Kwai third-party error codes, you can also refer to Kwai Official-Game Access Guide.
Copyright © 2025 MSDK.
All rights reserved.
All rights reserved.