iOS SDK Error Codes

Last updated:2022-03-14
iOS SDK Error Codes

Client error codes

Code Description Details
1005 AppKey does not exist Check whether the app for this AppKey was deleted in the console
1008 Invalid AppKey Verify AppKey in application details on the console
1009
  • No iOS app under this AppKey
  • SDK version is below 2.1.0
  • Check application details on the console
  • Update JPush SDK to the latest version
  • 6001 Invalid setting; tag/alias/property parameters cannot all be null Provide non-empty parameters
    6002 Setting timeout Retry; common when network is poor or initialization is incomplete
    6003 Invalid alias string Valid alias/tag: letters (case-sensitive), digits, underscore, Chinese, special chars (2.1.9+) @!#$&*+=.|
    6004 Alias too long, max 40 bytes Chinese UTF-8 uses 3 bytes per character
    6005 Invalid tag string Valid alias/tag: letters (case-sensitive), digits, underscore, Chinese, special chars (2.1.9+) @!#$&*+=.|
    6006 Tag too long, max 40 bytes per tag Chinese UTF-8 uses 3 bytes per character
    6007 Too many tags, max 1000 Per-device limit; no global limit per app
    6008 Total tag length exceeded Max total length 7 KB
    6009 Unknown error Unexpected SDK exception; see client logs
    6011 Too frequent operations More than 10 tag/alias/property or 3 phone number sets within 10s, or more than 10 property sets within 10s
    6012 set tag/alias/phone while JPush service is stopped Handle or prompt based on this error code
    6013 Device time axis abnormal Local time change affected phone number setting
    6014 Network busy Request failed; retry
    6015 Blacklist User is blacklisted; contact support
    6016 Invalid user Invalid user request failed
    6017 Invalid request
  • Abnormal parameters
  • Since 2020/03/10: alias bound to more than 10 devices; contact sales for higher limit
  • 6018 Too many tags User already has more than 1000 tags
    6019 Failed to get tags Exception while fetching all tags
    6020 Request failed Special issue caused request failure
    6021 Previous tags request pending Wait for previous tag API callback; or wait 20s without callback
    6022 Previous alias request pending Wait for previous alias API callback; or wait 20s without callback
    6023 Invalid phone number Must start with "+" or digit; remainder may contain "-" and digits only
    6024 Internal server error Retry later
    6025 Phone number too long Max length 20
    6027 Alias device binding limit exceeded Since SDK 3.3.2; max 10 devices per alias since 2020/03/10; contact sales for higher limit
    6036 Property operation not permitted Since SDK 4.8.0; user properties not enabled; contact sales
    6037 Invalid property parameters Property name must be NSString; value supports NSString, NSNumber, NSDate
    6038 Previous property request pending Wait for previous property API callback; or wait 20s without callback
    6039 liveActivity PushToken length exceeded Verify PushToken value
    6040 liveActivity identifier missing or too long (max 64 bytes) Verify liveActivity identifier
    6041 liveActivity PushToken set too frequently Wait 60 seconds and retry
    6042 liveActivity PushToken count exceeded Check API usage
    7000 Geofence expired Current time exceeds expiration
    7001 Geofence does not exist geofenceid not found in local cache when triggered
    Was this document helpful?

    Copyright 2011-2026, jiguang.cn, All Rights Reserved. 粤ICP备12056275号-13 Shenzhen Hexun Huagu Information Technology Co., Ltd.

    Open in Docs Center