Error CodesERRORS

Error Codes

Error Code Rules

Error codes use a 4-digit numeric format:

• 1 prefix (1xxx): SDK basic and configuration errors (client-side issues).
• 3 prefix (3xxx): Server-side business errors (AppKey, Placement ID, or signature validation failures).
• 5 prefix (5xxx): Server internal errors (SSP returns HTTP 500).

Error Codes

Code	Constant	Description
1000	SDK_ERROR	Generic SDK error
1001	APP_KEY_EMPTY	AppKey is empty
1002	INVALID_PARAMS	Invalid AdConfig parameters
1003	ALREADY_INITIALIZED	Already initialized
1010	NETWORK_UNAVAILABLE	No network / host unreachable
1011	NETWORK_TIMEOUT	Network timeout
1012	NETWORK_ERROR	Network error
1020	RESPONSE_PARSE_ERROR	Failed to parse SSP response
1100	SDK_NOT_INITIALIZED	SDK not initialized
1101	SDK_DISABLED	SDK is disabled
1102	PLACEMENT_ID_EMPTY	Placement ID is empty
1103	API_CLIENT_UNAVAILABLE	ApiClient unavailable
1110	MATERIAL_TIMEOUT	Material prefetch timeout
1111	MATERIAL_DOWNLOAD_FAIL	Material prefetch download failed
1112	MATERIAL_EXTRACT_FAIL	Playable ad extraction failed
1200	AD_EXPIRED	Ad has expired
1201	AD_DESTROYED	Ad instance destroyed
1202	AD_NOT_READY	Ad not ready
1203	HOST_ACTIVITY_DESTROYED	Host Activity destroyed or finishing
1210	RENDER_FAIL	Ad render failed
3000	SSP_ERROR	Generic server error
3001	NO_AD_FILL	No ad fill
3002	INVALID_REQUEST	Request body parse error
3003	INVALID_APP_KEY	App removed or not found
3004	INVALID_PLACEMENT	Placement disabled or not found
3005	INVALID_SIGNATURE	Signature verification failed
3006	FREQUENCY_LIMITED	Frequency limit exceeded for this device/user on this placement
3007	REQUEST_EXPIRED	X-Timestamp differs too much from server time
3008	REPLAY_ATTACK_DETECTED	Duplicate X-Nonce detected (replay attack)
3009	RATE_LIMIT_EXCEEDED	Rate limit exceeded
3010	INVALID_PLACEMENT_TYPE	Placement type not supported in this SDK version
5000	SERVER_INTERNAL_ERROR	SSP server internal error