tokenserver url and doc refs

Author: taddes

docs/src/open-api-docs.md

@@ -4,8 +4,17 @@
 
 This project uses [utoipa](https://crates.io/crates/utoipa) and [utoipa-swagger-ui](https://crates.io/crates/utoipa-swagger-ui) to provide interactive API documentation.
 
-### Accessing the Documentation
+### Accessing and Working With the Documentation
+It is suggested to use the stage instance of Sync and/or Tokenserver when playing with the API,
+though you may also interact with your data in the production instance.
+
+Please take care to select the URL for Tokenserver for Tokenserver requests and the Syncstorage URL for Syncstorage requests.
 
+The Prod and Stage environments below will be available as a drop-down in the SwaggerUI:
+- **Sync Stage**: `https://sync-us-west1-g.sync.services.allizom.org`.
+- **Sync Prod**: `https://sync-1-us-west1-g.sync.services.mozilla.com`.
+- **Tokenserver Stage**: `https://stage-tokenserver.sync.nonprod.webservices.mozgcp.net`.
+- **Tokenserver Prod**: `https://prod-tokenserver.sync.prod.webservices.mozgcp.net`.
 #### On GitHub Pages (Static Documentation):
 
 The project automatically publishes API documentation to GitHub Pages:
@@ -15,13 +24,6 @@ The project automatically publishes API documentation to GitHub Pages:
 - **OpenAPI/Swagger UI**: https://mozilla-services.github.io/syncstorage-rs/swagger-ui/
 
 #### When the service is running (live deployment):
-It is suggested to use the stage instance of Sync when playing with the API,
-though you may also interact with your data in the production instance.
-
-The Prod and Stage environments below will be available as a drop-down in the SwaggerUI:
-- **Stage**: `https://sync-us-west1-g.sync.services.allizom.org`.
-- **Prod**: `https://sync-1-us-west1-g.sync.services.mozilla.com`.
-
 URLs for Swagger and OpenAPI Spec:
 - **Swagger UI (Interactive)**: `https://<your-deployment-url>/swagger-ui/`
 - **OpenAPI Spec (JSON)**: `https://<your-deployment-url>/api-doc/openapi.json`

syncserver/src/server/mod.rs

@@ -87,8 +87,10 @@ pub fn cfg_path(path: &str) -> String {
         description = "OpenAPI documentation for Syncstorage and Tokenserver endpoints."
     ),
     servers(
-        (url = "https://sync-us-west1-g.sync.services.allizom.org", description = "US West Stage"),
-        (url = "https://sync-1-us-west1-g.sync.services.mozilla.com", description = "US West Production"),
+        (url = "https://stage-tokenserver.sync.nonprod.webservices.mozgcp.net", description = "Tokenserver Stage"),
+        (url = "https://prod-tokenserver.sync.prod.webservices.mozgcp.net", description = "Tokenserver Production"),
+        (url = "https://sync-us-west1-g.sync.services.allizom.org", description = "Syncstorage - US West Stage"),
+        (url = "https://sync-1-us-west1-g.sync.services.mozilla.com", description = "Syncstorage - US West Prod"),
     ),
     paths(
         // Syncstorage general info endpoints.