why does api gateway with http api using api mapping fail with 404?

Question

I have a custom domain name in AWS API gateway. I am using the same domain for 2 separate API stages. One API stage is REST API, and the other HTTP API.

When I test out my setup, everything works for the REST API. However, the mapping path for HTTP API is not working and I get status-code = 404 Not Found, with 0kb body.

references used: https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-mappings.html https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-mappings.html

From my testing in postman, i get the following result when calling the custom domain.

 1. {{api.gateway.custom.domain.url}}/foobar - works
 2. {{api.gateway.custom.domain.url}}/this-no-work/foobar - 404
 3. {{api.gateway.custom.domain.url}}/this-works/foobar - works

does anyone know why (2) gives 404? api-gateway REST API with mapping works while api-gateway HTTP API will return 404 with 0kb body. Is there something I am missing?

note: the (none) path mapping has been added for a sanity check, and I was able to get the expected response.

Answer 1

when default endpoin is created in my case it uses this pattern

https://{api_id}.execute-api.{region}.amazonaws.com/

an answer might be: Disable the default endpoint for an HTTP API

more details here https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-disable-default-endpoint.html

Answer 2

I had the same problem.

The problem is in the configuration of routers of your application.

When you configure one API mapping in AWS API Gateway, the configured path (this-no-work) is passed to your web application as a prefix of routes.

SO ... if you have one route like this:

/api/foobar

you need configure one more route with the prefix point to the same action:

/this-no-work/api/foobar

A good one is to make one global configuration to your web app.

You can note it enabling the cloudwatch logs of your API Gateway stage and looking into the cloudwatch logs the path property passed from API Gateway to the Web application.