AEMP Integration API Error Code

Error Response Structure

 {
    "type": "string",
    "title": "string",
    "status": "string",
    "detail": "string"
 }

Below are the values for title and status

Title	Status
AccessDeniedException	403
ResourceNotFoundException	404
ResourceConflictException	409
UnknownException	500

Error Responses

General

Title	Scenario	ErrorMessage
AccessDeniedException	Access denied to a resource	Not allowed to perform this action

Integrations

ValidationException

Sample Error Message

{
    "type": "https://docs.trimblecloud.com/iot-service/harvester/reference/error-codes/",
    "title": "ValidationException",
    "status": "400",
    "detail": "<CustomMessage>"
}

Scenario	ErrorMessage
Mandatory field FeedUrl is not given	Feed Url is mandatory in OemInfo list or should be last in the sequence
Invalid HTTP Method	HttpMethod is Invalid, allowed HttpMethod are POST , GET
Invalid range for PollInterval	PollIntervalMinutes must be between 15 and 2880

ResourceNotFoundException

Sample Error Message

{
    "type": "https://docs.trimblecloud.com/iot-service/harvester/reference/error-codes/",
    "title": "ResourceNotFoundException",
    "status": "404",
    "detail": "<CustomMessage>"
}

Scenario	ErrorMessage
The given integration id does not exist	Integration not found

FeedRuns

ValidationException

Sample Error Message

{
    "type": "https://docs.trimblecloud.com/iot-service/harvester/reference/error-codes/",
    "title": "ValidationException",
    "status": "400",
    "detail": "<CustomMessage>"
}

Scenario	ErrorMessage
Mandatory field StartUtc is not given	StartUtc is required
Mandatory field EndUtc is not given	EndUtc is required
Invalid format for StartUtc	StartUtc provided is not in valid utc format
Invalid TimeRange	Timestamp Range provided is invalid. Time range between startUtc and endUtc should be less than 24 hours.
StartUtc value is later than the endUtc value	Timestamp Range provided is invalid, startUtc is greater than the endUtc

Raw Feed

ValidationException

Sample Error Message

{
    "type": "https://docs.trimblecloud.com/iot-service/harvester/reference/error-codes/",
    "title": "ValidationException",
    "status": "400",
    "detail": "<CustomMessage>"
}

Scenario	ErrorMessage
The value of page number is not in the valid range	Page number is out of range

ResourceConflictException

Sample Error Message

{
    "type": "https://docs.trimblecloud.com/iot-service/harvester/reference/error-codes/",
    "title": "ResourceConflictException",
    "status": "409",
    "detail": "<CustomMessage>"
}

Scenario	ErrorMessage
Raw Feed is not available for the feed run as download failed or in progress	Unable to fetch RawFeed