The error response for the Premium Listings API is made up of a custom error code and a human-readable reason. An example of a custom error code is 1011001 and it is made up of the following parts:
- 101 identifies the service (101 - Premium Listings API)
- 1 identifies the severity level, 1 being the default for the time being
- 001 is a custom code that provides further details about the failure
Service codes:
| Code | Service |
|---|---|
| 101 | Premium Listings API |
| 102 | Premium Listings Processor |
List of current error codes and the error they correspond to:
| Code | Error |
|---|---|
| 1011001 | Create Premium Listing - Error parsing request |
| 1011002 | Create Premium Listing - Internal error interpreting JSON data |
| 1011003 | Create Premium Listing - Request body fails JSON schema validation |
| 1011004 | Create Premium Listing - Validation error: pending premium listing already exists for listingId |
| 1011005 | Create Premium Listing - Validation error: activated premium listing already exists for listingId |
| 1011006 | Create Premium Listing - Internal DB error |
| 1011007 | Create Premium Listing - Validation error: Listing doesn’t pass the quality check. To activate Premium Listing product listing’s Full description should be at least 200 characters. |
| 1011008 | Create Premium Listing - Validation error: Listing doesn’t pass the quality check. To activate Premium Listing product listing should have at least 3 images assigned. |
| 1011011 | Get Premium Listing - Premium listing not found |
| 1011012 | Get Premium Listing - Internal error interpreting JSON data |
| 1011016 | Get Premium Listing - Internal DB error |
| 1011076 | Get Premium Listing - Validation error: listingId must be passed when using isPremium param |
| 1011021 | Update Premium Listing - Error parsing request |
| 1011022 | Update Premium Listing - Internal error interpreting JSON data |
| 1011026 | Update Premium Listing - Internal DB error |
| 1011041 | Update Premium Listing highlights - Error parsing request |
| 1011042 | Can't deserialise provided payload |
| 1011043 | Premium Listing can be only updated if it's active. Active means that the date it expires at is in the future and status is ACTIVATED |
| 1011044 |
There's already update pending. Please wait a while and try again. You can't have two updates in a fly. |
| 1011045 |
Internal error during updating. Issue related to the storage. |
| 1011051 | Listing Service - Can't find listingId |
| 1011052 | Listing Service - No owner found for given listingId |
| 1011053 | Listing Service - Internal error connecting to listing service |
| 1011054 | Listing Service - Internal error interpreting JSON data |
| 1011055 | Listing Service - listingId found does not match the one provided |
| 1011061 | Listing Matching Service - Can not customerListingId match to a listingId |
| 1011062 | Listing Matching Service - Internal error interpreting JSON data |
| 1011063 | Listing Matching Service - Could not connect to internal system |
| 1011064 | Listing Matching Service - No sources assigned to the client |
| 1011065 | Listing Matching Service - Internal error : both listingId and customerListingId cannot be set |
| 1011066 | Listing Matching Service - Listing Matching Service URL: has not been specified : invalid configuration |
| 1011900 | Internal Service Error |
| 1011901 | Client does not have access to listing |
| 1011902 | Internal error interpreting JSON data for permissions |
| 1011903 | Internal DB error - Cannot create index |
| 1011904 | Invalid request - request body doesn't meet JSON schema requirements |
| 1011905 | Invalid request - provided highlight are not valid |
| 1021000 | Premium Listings Processor - Cannot decode error from legacy-products |
| 1021001 | Premium Listings Processor - Product already activated for this listing |
| 1021002 | Premium Listings Processor - Product cannot be activated for this listing |
| 1021003 | Premium Listings Processor - Listing details not available |
| 1021004 | Premium Listings Processor - Listing does not have enough images assigned |
| 1021005 | Premium Listings Processor - Listing does not have long enough Full description |
| 1021006 | Premium Listings Processor - Contract does not have premium features activated |
| 1021007 | Premium Listings Processor - Unable to assign highlights to listing |
| 1021008 | Premium Listings Processor - Unknown message type |
Ranges for further details. These can be extended as the API is extended.
| Range | Feature |
|---|---|
| 001 - 010 | Create Premium Listing |
| 011 - 020 | Get Premium Listing(s) |
| 021 - 030 | Update Premium Listing |
| 041 - 050 | Premium Listing (highlights) validation |
| 051 - 060 | Listing JSON Service |
| 061 - 070 | Listing Matching Service |
| 900 - 910 | Internal Service / Permission Errors |