Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

404 Not Found responses are well known to just about every web surfer. It simply means that the target resource of the URI URL is not found. However, there are different reasons and different sources for the 404 error.

...

However, it is still possible to get a 404 response even if your resource has been defined. This can happen if the URI URL includes query params that are not defined as a part of the resource:

...

Code Block
languagejs
{
    "type": "about:blank",
    "title": "Not Found",
    "status": 404,
    "detail": "color is not valid for this web API endpoint.",
    "instance": "http://www.examples.org/api/parts?color=red"
}

Here are a few reasons and symptoms.

Resource endpoint is not defined in the Resource Manager.

This most likely means you forgot to select at least one HTTP method:

Image Removed

...

By default, the HTTP Framework treats query params as a part of the URL. Thus, if an unexpected query param appears in the URL it will consider it to be an unavailable resource. If one or more query params need to be supported, these should be defined in the Resource Manager for the specific resource:

Image Added

On the other hand, if unspecified query params need to be supported or if you never want query params to be the source of a 404 error, then you can configure the resource with a wildcard query param:

Image Added