René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Document `peps.json` and move it to the root","articleBody":"We currently have https://peps.python.org/api/peps.json, an undocumented file.\r\n\r\nIt seems that people have usecases for the file, even without official support (see #2567, #2583). I suggest moving the file to the root[^1] for consistency with `peps.rss` and easier discoverability, and simultaneously documenting the file, and the minimum guarantees we provide about it.\r\n\r\n[^1]: i.e. to https://peps.python.org/peps.json\r\n\r\nIn the issue that created it, Cam [noted](https://github.com/python/peps/pull/2475#pullrequestreview-922494118):\r\n\r\n\u003e Maybe put this under an `/api/peps` endpoint (at least once we're ready to more publicly expose it)? Then if there was need/desire in the future, we could have an `authors` endpoint, sub-endpoints `api/peps/N` to get a single PEP's metadata, etc.\r\n\r\nI think the `api/` is uneeded here -- to those use cases, we could instead generate `peps.python.org/pep-NNNN.json`, and `peps.python.org/authors.json`.\r\n\r\nI'd be interested in views.\r\n\r\nA","author":{"url":"https://github.com/AA-Turner","@type":"Person","name":"AA-Turner"},"datePublished":"2022-05-07T10:45:20.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":9},"url":"https://github.com/2584/peps/issues/2584"}