Skip to content

SDK-Error-code.md

Latest commit

 

History

History
93 lines (57 loc) · 5.67 KB

SDK-Error-code.md

File metadata and controls

93 lines (57 loc) · 5.67 KB

Mappls SDK – Error Code Reference

This document outlines possible error codes and exceptions encountered while using the Mappls Android SDKs. Use this guide for debugging integration issues across different SDK modules.

Core SDK Errors

Condition Exception/Error Message
Mappls Plugin is not applied in build.gradle Please apply plugin "com.mappls.services.android" in your app/build.gradle
.olf file is invalid or corrupted Please add a valid .olf configuration file.
Package name or app fingerprint mismatch in .olf file You are using Invalid Configuration. Please check your Package Name / App Fingerprint & download it from the developer console again.
.conf config file is invalid Please add a valid .conf configuration file.
Static key is not found (improper app setup or missing plugin) Error Code: 1
Error Message: Static Key Not Found
No HTTP status code associated
Invalid payload while creating the payload JSON Error Code: 2
Error Message: Invalid Payload
No HTTP status code associated
Missing config data, appId, or payloadPubKey Error Code: 3
Error Message: Invalid Config
No HTTP status code associated
Payload encryption failure Error Code: 3
Error Message: Invalid Payload
No HTTP status code associated
Auth1 Token (Bearer accessToken) missing or expired during API call Error Code: 5
Error Message: Authentication Failed
No HTTP status code associated
Auth1 Token usage attempted but config lacks access token Error Code: 6
Error Message: This authentication is not supported
No HTTP status code associated

Rest API SDK Errors

Condition Exception/Error Message
Method not provisioned Error Code: 4
Error Message: Method not Provisioned
No HTTP status code associated
API call manually cancelled by user Error Code: 9
Error Message: <Exception message>
No HTTP status code associated
No internet connection / Unknown host Error Code: 10
Error Message: <UnknownHost Exception message>
No HTTP status code associated
API failure due to an unexpected issue / Invalid response Error Code: 11
Error Message: <Exception message>
No HTTP status code associated

Map SDK Errors

Condition Exception/Error Message
Config not read properly by Map SDK (improper setup) Error Code: 7
Error Message: Map Config not available
vectorMap object or style base URL missing in config Error Code: 7
Error Message: Map Info is not available
Public key or its expiry missing from vectorMap object in config Error Code: 8
Error Message: Public Key not found

Android – Mappls Plugin Errors

Condition Exception/Error Message
.a.olf file is missing in the project No .a.olf file found. The Mappls Services Plugin cannot function without it.
.conf config file is missing .conf file not found at: <path>

Note

  • These errors are internal SDK exceptions and may not return standard HTTP status codes.
  • Make sure all configuration files are correctly downloaded and integrated from the Mappls Developer Console.
  • Always apply the com.mappls.services.android plugin and include required dependencies in your build.gradle.


For any queries and support, please contact:


Email us at apisupport@mappls.com


Support
Need support? contact us!






@ Copyright 2026 CE Info Systems Ltd. All Rights Reserved.