From @irl feedback and other issues:

Endpoints that can be dropped:

  • /summary was only ever used by Tor Atlas
  • One of the keys lets you look up history of historical relays to verify the first_seen and uptime, and was only ever used by the t-shirt awarding Python script.

Endpoints that should stay:

  • /search exists to facilitate Relay Search with human typing on a keyboard queries.
    • improve it by specifying what to spect from some characters (#25)
    • improve it by searching with fp and nickname (#24)
  • key/value parameters exist for easier scripting use, eg. OrNetStats pulling data about relay families or the Bypass Censorship dashboard pulling data about the bridges it runs.
  • The aggregated search feature is widely used. To be implemented server-side

New endpoints:

  • ?: expose the directory authorities shipped with tor (#41)
  • ?: measured bandwidths from votes, bandwidth scanner data (#30)
  • ?: proxy vm queries (#50, metrics exposed to vm) or something similar to vmgateway

New params:

  • pagination (can be implemented with actix-web-pagination)
  • allow parameters and search terms to be specified more than once (#43)
  • additional_flag: currently computed by Relay Search client-side. To be implemented server-side (see also #39)
  • fallback_directory? (#39#note_2985815)
  • ?: search bridges: search by distributor and transport. There's a new 'transport-info' field in the cached-extrainfo: transport-info version=0.1.0 implementation=lyrebird (#55)
  • ed25519 fps? (#40)

New properties in response:

  • ed25519 fps (#40)

advanced relay search:

  • "Not Recommended"

Current Onionoo API:

(uncomplete docs) https://gitlab.torproject.org/juga/networkstatusapi/-/blob/issue56_apistos_doc/docs/src/openapi_onionoo.yaml?ref_type=heads&plain=1

https://networkstatusapi-72c5c5.pages.torproject.net/onionoo.html, https://gitlab.torproject.org/juga/networkstatusapi/-/blob/issue56_apistos_doc/docs/src/onionoo.md?ref_type=heads

Metrics Website list:

https://gitlab.torproject.org/juga/networkstatusapi/-/blob/issue56_apistos_doc/docs/src/metrics_website1.txt?ref_type=heads