目录

Result Codes

The result codes of Push Kit consist of HMS Core SDK Framework Result Codes and HMS Core Push SDK Result Codes. If you encounter a result code that cannot be found here, contact technical support. Technical support personnel will get back to you as soon as possible.

HMS Core SDK Framework Result Codes

Result Code

Value

Description

Solution

ErrorCode.ARGUMENTS_INVALID

907135000

Incorrect input parameters.

Verify that related input parameters are correctly set. For example, verify that app_id in the agconnect-services.json file is correctly set and the signing certificate is configured in the build.gradle file.

ErrorCode.INTERNAL_ERROR

907135001

An internal error occurred and cannot be rectified.

Retry or restart the process.

ErrorCode.NAMING_INVALID

907135002

Failed to query the specified service API, because the API does not exist or the API instance failed to be created.

Verify that the service API exists and the API instance is successfully created.

ErrorCode.CLIENT_API_INVALID

907135003

Invalid ApiClient object.

Generally, this error does not occur. Try again if this error code is returned. If the error persists after several retries, submit a ticket online.

ErrorCode.NOT_IN_SERVICE

907135005

This service is unavailable in this region.

Verify that the API is supported in the region where the user is located.

ErrorCode.SESSION_INVALID

907135006

HMS Core SDK internal error. The AIDL connection session is invalid.

Generally, this error does not occur. Try again if this error code is returned. If the error persists after several retries, submit a ticket online.

ErrorCode.DENY_NETWORK

907135007

Failed to access the network, because you did not agree to the privacy statement in the out-of-box experience (OOBE) phase.

Agree to the privacy statement in the OOBE phase.

ErrorCode.CERT_FINGERPRINT_EMPTY

907135702

No certificate fingerprint is configured for OpenGW.

  1. Verify that your phone has Internet access.
  2. Verify that the certificate fingerprint is correctly configured when you apply for related services. Sign in to AppGallery Connect, click My projects, and select a required project. On the displayed page, select the app, go to Project settings > General information, and check whether the value in SHA-256 certificate fingerprint is the same as that generated in the signing certificate. If not, change the value.

ErrorCode.PERMISSION_LIST_EMPTY

907135703

The permission of OpenGW is not configured.

Verify that the related function has been enabled during app creation. For example, to represent a user using unionId in an app, enable unionId when creating the app.

StatusCode.AUTH_INFO_NOT_EXIST

6002

The app's authentication information does not exist.

Verify that the current app has been created and has applied for related services.

StatusCode.PERMISSION_NOT_AUTHORIZED

6005

API authentication: Permission not granted.

Verify that the current app has been created and has applied for related services.

StatusCode.PERMISSION_EXPIRED

6006

API authentication: Permission expired.

Verify that the current app has been created and has applied for related services.

ErrorCode.FRAMEWORK_UPDATING

1200

The framework is being upgraded, and the AMS and PMS services are not ready.

  1. Verify that the framework upgrade is complete and the AMS and PMS services are ready.
  2. Send the request again.

ErrorCode.FRAMEWORK_NOT_READY

1201

The AMS and PMS services are not ready.

  1. Verify that the AMS and PMS services are ready.
  2. Send the request again.

ErrorCode.PARAMETER_INVALID

1210

Invalid parameter.

Verify that the input parameter is correct.

ErrorCode.SESSION_INVALID

1211

Invalid session.

Verify that the app ID of the caller is correct.

ErrorCode.KIT_NEED_UPDATE

1212

The kit needs to be upgraded.

  1. Verify that the kit upgrade is complete.
  2. Verify that a later version of the kit is available on AppGallery or in the local installation directory.
  3. Send the request again.

ERRORCODE.KIT_BREAKER

1213

The kit needs to be in the circuit breaker state.

Do not call the kit because it is unavailable in the circuit breaker state.

ERRORCODE.FRAMEWORK_BREAKER

1214

The framework needs to be in the circuit breaker state.

Do not call the framework because it is unavailable in the circuit breaker state.

ERRORCODE.MEMORY_OVER_LIMIT

1215

The memory usage exceeds the threshold.

  1. Verify that the memory usage does not exceed the threshold.
  2. If the memory usage exceeds the threshold, release the memory and try again.

ERRORCODE.RUNTIME_AMS

1230

An error occurs during AMS running.

  1. Wait for a few seconds and try again.
  2. Restart HMS Core (APK).
  3. Reinstall HMS Core (APK) from HUAWEI AppGallery.

ERRORCODE.RUNTIME_PMS

1240

An error occurs during PMS running.

  1. Wait for a few seconds and try again.
  2. Restart HMS Core (APK).
  3. Reinstall HMS Core (APK) from HUAWEI AppGallery.

ERRORCODE.RUNTIME_KAC

1250

An error occurs during KAC running.

  1. Wait for a few seconds and try again.
  2. Restart HMS Core (APK).
  3. Reinstall HMS Core (APK) from HUAWEI AppGallery.

ERRORCODE.RUNTIME_OTHER

1260

Other types of errors.

Obtain relevant error logs and submit a ticket online.

BaseCode.KPMS_UPDATE_FAILED

-10

The kit failed to be updated using the KPMS.

1. Verify that the network is normal.

2. Verify that relevant kits have been released.

3. If the fault persists, submit a ticket online.

ResolutionResult.INTERNAL_ERROR

8

Internal error.

Try again.

AvailableCode.CANCELED

13

The user cancels the download or installation, or the app uses an incorrect certificate.

  1. Ensure that HMS Core (APK) is downloaded successfully.
  2. Ensure that HMS Core (APK) is installed successfully.
  3. Ensure that the used hmsrootcas.bks certificate is correct and contains "052root".

AvailableCode.APP_IS_BACKGROUND_OR_LOCKED

28

The update Dialog failed to be displayed because the app is running in the background or the screen of the device is locked.

Ensure that the app is running in the foreground.

AvailableCode.HMS_IS_SPOOF

29

HMS Core (APK) is spoofed.

Reinstall HMS Core (APK) from HUAWEI AppGallery.

HMS Core Push SDK Result Codes

Result Code

Description

Solution

6003

Inconsistent certificate fingerprint configurations.

  1. Ensure that the certificate fingerprint packed in the app on your device is consistent with the value of SHA-256 certificate fingerprint you have set in AppGallery Connect. For details, please refer to Preparations.
  2. HMS Core (APK) will cache the signing certificate file. You need to find HMS Core (APK) on the Apps screen of your device and clear its cache, restart your app, and perform the previous operation again.

6004

You are not authorized to authenticate the API.

For details, please refer to Preparations to check whether the related service is enabled for the app.

  • If any required service has not been enabled, enable it.

  • If all required services have been enabled, you are advised to disable them and then enable them again.

Wait for about 30 minutes, clear the HMS Core (APK) cache on your device, restart your device, and test again.

To clear the HMS Core (APK) cache, go to Settings > Apps > Apps > HMS Core, and clear the cache and other stored data.

907122030

No token.

Ensure that the input parameters are correct for calling the method for obtaining a token.

907122031

The network is unavailable.

Verify that the network is available.

907122032

The token has expired.

Delete the token and obtain a new one.

907122036

Push Kit is not enabled.

For details, please refer to Preparations to check whether the related service is enabled for the app.

907122037

Failed to obtain the token.

Try again later or contact technical support.

907122038

No storage location is selected for the app, or the storage location is invalid.

Set a correct data processing location for your app. For details, please refer to Managing the Default Data Processing Location.

907122041

The message body size exceeds the maximum (1 KB).

Ensure that the size of the message body does not exceed the maximum.

907122042

The message contains invalid parameters.

Ensure that the parameters in the message body are valid.

907122045

Unknown error.

An internal system exception occurs, and you cannot handle it by yourself. Contact technical support.

907122047

Common Push Kit error.

This error may occur in many scenarios. Contact technical support to locate it.

907122048

HMS Core (APK) cannot connect to Push Kit.

Contact technical support.

907122050

The operation cannot be performed in the main thread.

Create a thread and call a specific method in the new thread.

907122051

Failed to authenticate the device certificate.

Contact technical support.

907122052

Failed to bind the service.

Try again later or contact technical support.

907122053

Failed to obtain the token. Cross-location application is not allowed.

Ensure that the token is not obtained across data processing locations.

907122054

The HMS Core Push SDK is being automatically initialized.

HMS Core (APK) is not installed or is not in the required version on the device. Search for HMS Core on HUAWEI AppGallery, install it, and try again.

907122055

The system is busy.

Try again later.

907122060

Your server is offline.

Try again later.

907122064

The agconnect-services.json file does not contain the projectId field.

Sign in to AppGallery Connect, select My projects, find your project in the project list, choose Project settings, and re-download the agconnect-services.json file.

907122065

Failed to obtain a token for the apps on smart watches, VR devices, or routers.

Apps on third-party smart watches, VR devices, and routers are not supported.

If the error persists, contact technical support. Technical support personnel will get back to you as soon as possible.