api/identifiers: Add /known/ endpoint documentation

First draft of new /known/ endpoint documentation (will need some updates once !246 (closed) gets landed).

Depends on !253 (closed)

---

Migrated from D2668 (view on Phabricator)