api icon indicating copy to clipboard operation
api copied to clipboard

What useful information can we put on the API root path?

Open orangejulius opened this issue 6 years ago • 2 comments

The Pelias API root path has long included some simple static content from a Markdown file: Screenshot_2020-05-05_07-23-49

While the link to the docs is nice, the version is not especially useful or high signal.

What information would be more useful here?

I'll just list a bunch of ideas and people can add to it:

  • Example queries
  • A link to the compare app after #1416 is merged
  • Config information from pelias.json
  • Links to demo URLs for other Pelias services
  • Debug info about the server: IP address, name, etc
  • Code information: git commit, actual release version, etc

orangejulius avatar May 05 '20 14:05 orangejulius

some of the ES query counts seem nice, they're a good sanity check on the server's data health

git commit, release version, super into those

blackmad avatar Jun 29 '20 14:06 blackmad

That's a good point. If we ever wanted to re-write the Pelias Dashboard as something a bit more similar to the rest of the project (It's written in ruby and no one who has contributed significantly to its code is still involved in the project), the API would be a good place to put it.

orangejulius avatar Jun 29 '20 15:06 orangejulius