/docs leads to 404

[davidtorosyan]

Describe the bug
The docs link leads to a 404: https://batch.openaddresses.io/docs

To Reproduce
Steps to reproduce the behavior:

1. Go to https://batch.openaddresses.io/data
2. Click on the question mark icon
3. Observe 404 page

Expected behavior
Expected a docs page.

Screenshots

Desktop (please complete the following information):

• OS: Windows 10
• Browser: Chrome
• Version: Version 116.0.5845.142 (Official Build) (64-bit)

Additional context
This was previously filed in a different repo (openaddresses/openaddresses#6669), opening here since this is more applicable.

From my investigation I found that the nginx config specifies that the link should be /docs/

batch/api/nginx.conf

Line 19 in 4af5207

location /docs/ {

And if we go to the route (https://batch.openaddresses.io/docs/) we see a different 404 page, which indicates the nginx filter gets hit:

But I also see that there's a route to /docs, without the slash.

batch/api/index.js

Line 141 in 4af5207

app.use('/docs', SwaggerUI.serve, SwaggerUI.setup(schema.docs.base));

My guess is that the nginx override is messing with the proper path.

Also, I'm thinking this broke with 1967934, which switched to Swagger. cc @ingalls

[ingalls]

Fixed.

[davidtorosyan]

I think this is only partly fixed.

The question mark icon leads to: https://batch.openaddresses.io/docs

This redirects to http://batch.openaddresses.io:5000/docs/ which then fails to load.

On the other hand https://batch.openaddresses.io/docs/ works as expected.

So either the question mark link needs to be updated, or the redirect from /docs to /docs/ needs to fix the port. Or both!

[ingalls]

I'm afraid I can't reproduce this? Can you try clearing your cache? This looks like the behavior I fixed.

I've tried all the permutations and am seeing it correctly direct to the Swagger Docs.

[iandees]

Something about generating the https://batch.openaddresses.io/docs/ page content is taking a very long time. I intermittently get 503s, blank pages after ~50 seconds, and the actual content you shared in the screenshot above.

Also, I see the URL without the slash at the end redirecting to :5000:

$ curl -sv https://batch.openaddresses.io/docs -o /dev/null
< HTTP/2 301
...
< location: http://batch.openaddresses.io:5000/docs/