feat(api) Add ability for endpoint specific domains (#12168)

Some of our endpoints require customers to use region domains in order
to have APIs work correctly across DE and US regions. I've already
updated those endpoints in getsentry/sentry#82159.

Refs getsentry/sentry#81232

Author: markstory

src/build/open-api/types.ts

@@ -36,6 +36,11 @@ type Tag = {
   'x-sidebar-name': string;
 };
 
+type ServerMeta = {
+  description: string;
+  url: string;
+};
+
 export type DeRefedOpenAPI = {
   paths: {
     [key: string]: {
@@ -66,6 +71,7 @@ export type DeRefedOpenAPI = {
         tags: string[];
         description?: string;
         security?: any;
+        servers?: ServerMeta[];
       };
     };
   };

src/build/resolveOpenAPI.ts

@@ -70,6 +70,7 @@ export type API = {
   pathParameters: APIParameter[];
   queryParameters: APIParameter[];
   responses: APIResponse[];
+  server: string;
   slug: string;
   bodyContentType?: string;
   descriptionMarkdown?: string;
@@ -120,11 +121,16 @@ async function apiCategoriesUncached(): Promise<APICategory[]> {
 
   Object.entries(data.paths).forEach(([apiPath, methods]) => {
     Object.entries(methods).forEach(([method, apiData]) => {
+      let server = 'https://sentry.io';
+      if (apiData.servers && apiData.servers[0]) {
+        server = apiData.servers[0].url;
+      }
       apiData.tags.forEach(tag => {
         categoryMap[tag].apis.push({
           apiPath,
           method,
           name: apiData.operationId,
+          server,
           slug: slugify(apiData.operationId),
           summary: apiData.summary,
           descriptionMarkdown: apiData.description,

src/components/apiExamples/apiExamples.tsx

@@ -38,7 +38,7 @@ const codeToJsx = (code: string, lang = 'json') => {
 
 export function ApiExamples({api}: Props) {
   const apiExample = [
-    `curl https://sentry.io${api.apiPath}`,
+    `curl ${api.server}${api.apiPath}`,
     ` -H 'Authorization: Bearer <auth_token>'`,
   ];
   if (['put', 'options', 'delete'].includes(api.method.toLowerCase())) {