Merge pull request #60 from calcom/fix/add-servers-openapi-spec

calcom · Apr 26, 2022 · bceeeeb · bceeeeb
2 parents 944e9b1 + fa30b52
commit bceeeeb
Show file tree

Hide file tree

Showing 29 changed files with 52 additions and 29 deletions.
diff --git a/pages/api/attendees/[id].ts b/pages/api/attendees/[id].ts
@@ -12,7 +12,7 @@ import {
 
 /**
  * @swagger
- * /v1/attendees/{id}:
+ * /attendees/{id}:
  *   get:
  *     summary: Get an attendee by ID
  *     parameters:

diff --git a/pages/api/attendees/index.ts b/pages/api/attendees/index.ts
@@ -8,7 +8,7 @@ import { schemaAttendeeBodyParams, schemaAttendeePublic, withValidAttendee } fro
 
 /**
  * @swagger
- * /v1/attendees:
+ * /attendees:
  *   get:
  *     summary: Get all attendees
  *     security:

diff --git a/pages/api/availabilities/[id].ts b/pages/api/availabilities/[id].ts
@@ -12,7 +12,7 @@ import {
 
 /**
  * @swagger
- * /v1/availabilities/{id}:
+ * /availabilities/{id}:
  *   get:
  *     summary: Get an availability by ID
  *     parameters:

diff --git a/pages/api/availabilities/index.ts b/pages/api/availabilities/index.ts
@@ -8,7 +8,7 @@ import { schemaAvailabilityBodyParams, schemaAvailabilityPublic } from "@lib/val
 
 /**
  * @swagger
- * /v1/availabilities:
+ * /availabilities:
  *   get:
  *     summary: Get all availabilities
  *     security:

diff --git a/pages/api/booking-references/[id].ts b/pages/api/booking-references/[id].ts
@@ -16,7 +16,7 @@ import {
 
 /**
  * @swagger
- * /v1/booking-references/{id}:
+ * /booking-references/{id}:
  *   get:
  *     summary: Get a daily event reference by ID
  *     parameters:

diff --git a/pages/api/booking-references/index.ts b/pages/api/booking-references/index.ts
@@ -11,7 +11,7 @@ import {
 
 /**
  * @swagger
- * /v1/booking-references:
+ * /booking-references:
  *   get:
  *     summary: Get all booking references
  *     security:

diff --git a/pages/api/bookings/[id].ts b/pages/api/bookings/[id].ts
@@ -12,7 +12,7 @@ import {
 
 /**
  * @swagger
- * /v1/bookings/{id}:
+ * /bookings/{id}:
  *   get:
  *     summary: Get a booking by ID
  *     parameters:

diff --git a/pages/api/bookings/index.ts b/pages/api/bookings/index.ts
@@ -8,7 +8,7 @@ import { schemaBookingBodyParams, schemaBookingPublic, withValidBooking } from "
 
 /**
  * @swagger
- * /v1/bookings:
+ * /bookings:
  *   get:
  *     summary: Get all bookings
  *     security:

diff --git a/pages/api/daily-event-references/[id].ts b/pages/api/daily-event-references/[id].ts
@@ -15,7 +15,7 @@ import {
 
 /**
  * @swagger
- * /v1/daily-event-references/{id}:
+ * /daily-event-references/{id}:
  *   get:
  *     summary: Get a daily event reference by ID
  *     parameters:

diff --git a/pages/api/daily-event-references/index.ts b/pages/api/daily-event-references/index.ts
@@ -11,7 +11,7 @@ import {
 
 /**
  * @swagger
- * /v1/daily-event-references:
+ * /daily-event-references:
  *   get:
  *     summary: Get all daily event reference
  *     security:

diff --git a/pages/api/destination-calendars/[id].ts b/pages/api/destination-calendars/[id].ts
@@ -15,7 +15,7 @@ import {
 
 /**
  * @swagger
- * /v1/destination-calendars/{id}:
+ * /destination-calendars/{id}:
  *   get:
  *     summary: Get a destination calendar by ID
  *     parameters:

diff --git a/pages/api/destination-calendars/index.ts b/pages/api/destination-calendars/index.ts
@@ -11,7 +11,7 @@ import {
 
 /**
  * @swagger
- * /v1/destination-calendars:
+ * /destination-calendars:
  *   get:
  *     summary: Get all destination calendars
  *     security:

diff --git a/pages/api/docs.ts b/pages/api/docs.ts
@@ -5,6 +5,15 @@ import { withSwagger } from "next-swagger-doc";
 const swaggerHandler = withSwagger({
   definition: {
     openapi: "3.0.0",
+    servers: [
+      { url: "https://api.cal.com/v1" },
+      { url: "https://api.cal.dev/v1" },
+      { url: "http://localhost:3002/v1" },
+    ],
+    externalDocs: {
+      url: "https://docs.cal.com",
+      description: "Find more info at our main docs: https://docs.cal.com/",
+    },
     info: {
       title: `${pjson.name}: ${pjson.description}`,
       version: pjson.version,
@@ -15,7 +24,21 @@ const swaggerHandler = withSwagger({
     },
   },
   apiFolder: "pages/api",
-  tags: ["users", "teams", "memeberships"],
+  tags: [
+    "users",
+    "teams",
+    "memeberships",
+    "selected-calendars",
+    "schedules",
+    "payments",
+    "event-types",
+    "event-type-custom-inputs",
+    "destination-calendars",
+    "daily-event-references",
+    "booking-references",
+    "availabilities",
+    "attendees",
+  ],
   sort: true,
 });
 export default swaggerHandler();
diff --git a/pages/api/event-type-custom-inputs/[id].ts b/pages/api/event-type-custom-inputs/[id].ts
@@ -15,7 +15,7 @@ import {
 
 /**
  * @swagger
- * /v1/event-type-custom-inputs/{id}:
+ * /event-type-custom-inputs/{id}:
  *   get:
  *     summary: Get a eventTypeCustomInput by ID
  *     parameters:

diff --git a/pages/api/event-type-custom-inputs/index.ts b/pages/api/event-type-custom-inputs/index.ts
@@ -11,7 +11,7 @@ import {
 
 /**
  * @swagger
- * /v1/event-type-custom-inputs:
+ * /event-type-custom-inputs:
  *   get:
  *     summary: Get all eventTypeCustomInputs
  *     security:

diff --git a/pages/api/event-types/[id].ts b/pages/api/event-types/[id].ts
@@ -12,7 +12,7 @@ import {
 
 /**
  * @swagger
- * /v1/event-types/{id}:
+ * /event-types/{id}:
  *   get:
  *     summary: Get a eventType by ID
  *     parameters:

diff --git a/pages/api/event-types/index.ts b/pages/api/event-types/index.ts
@@ -8,7 +8,7 @@ import { schemaEventTypeBodyParams, schemaEventTypePublic } from "@lib/validatio
 
 /**
  * @swagger
- * /v1/event-types:
+ * /event-types:
  *   get:
  *     summary: Get all event types
  *     security:

diff --git a/pages/api/memberships/[id].ts b/pages/api/memberships/[id].ts
@@ -9,7 +9,7 @@ import { schemaQueryIdAsString, withValidQueryIdString } from "@lib/validations/
 
 /**
  * @swagger
- * /v1/memberships/{userId}_{teamId}:
+ * /memberships/{userId}_{teamId}:
  *   get:
  *     summary: Get a membership by userID and teamID
  *     parameters:

diff --git a/pages/api/memberships/index.ts b/pages/api/memberships/index.ts
@@ -8,7 +8,7 @@ import { schemaMembershipBodyParams, schemaMembershipPublic } from "@lib/validat
 
 /**
  * @swagger
- * /v1/memberships:
+ * /memberships:
  *   get:
  *     summary: Get all memberships
  *     security:

diff --git a/pages/api/payments/[id].ts b/pages/api/payments/[id].ts
@@ -12,7 +12,7 @@ import {
 
 /**
  * @swagger
- * /v1/payments/{id}:
+ * /payments/{id}:
  *   get:
  *     summary: Get one of your own payments by ID
  *     parameters:

diff --git a/pages/api/payments/index.ts b/pages/api/payments/index.ts
@@ -8,7 +8,7 @@ import { schemaPaymentPublic } from "@lib/validations/payment";
 
 /**
  * @swagger
- * /v1/payments:
+ * /payments:
  *   get:
  *     summary: Get all payments
  *     security:

diff --git a/pages/api/schedules/[id].ts b/pages/api/schedules/[id].ts
@@ -12,7 +12,7 @@ import {
 
 /**
  * @swagger
- * /v1/schedules/{id}:
+ * /schedules/{id}:
  *   get:
  *     summary: Get a schedule by ID
  *     parameters:

diff --git a/pages/api/schedules/index.ts b/pages/api/schedules/index.ts
@@ -8,7 +8,7 @@ import { schemaScheduleBodyParams, schemaSchedulePublic, withValidSchedule } fro
 
 /**
  * @swagger
- * /v1/schedules:
+ * /schedules:
  *   get:
  *     summary: Get all schedules
  *     security:

diff --git a/pages/api/selected-calendars/[id].ts b/pages/api/selected-calendars/[id].ts
@@ -12,7 +12,7 @@ import { schemaQueryIdAsString, withValidQueryIdString } from "@lib/validations/
 
 /**
  * @swagger
- * /v1/selected-calendars/{userId}_{integration}_{externalId}:
+ * /selected-calendars/{userId}_{integration}_{externalId}:
  *   get:
  *     summary: Get a selected-calendar by userID and teamID
  *     parameters:

diff --git a/pages/api/selected-calendars/index.ts b/pages/api/selected-calendars/index.ts
@@ -11,7 +11,7 @@ import {
 
 /**
  * @swagger
- * /v1/selected-calendars:
+ * /selected-calendars:
  *   get:
  *     summary: Get all selected calendars
  *     security:

diff --git a/pages/api/teams/[id].ts b/pages/api/teams/[id].ts
@@ -12,7 +12,7 @@ import { schemaTeamBodyParams, schemaTeamPublic } from "@lib/validations/team";
 
 /**
  * @swagger
- * /v1/teams/{id}:
+ * /teams/{id}:
  *   get:
  *     summary: Get a team by ID
  *     parameters:

diff --git a/pages/api/teams/index.ts b/pages/api/teams/index.ts
@@ -9,7 +9,7 @@ import { schemaTeamBodyParams, schemaTeamPublic, withValidTeam } from "@lib/vali
 
 /**
  * @swagger
- * /v1/teams:
+ * /teams:
  *   get:
  *     summary: Get all teams
  *     security:

diff --git a/pages/api/users/[id].ts b/pages/api/users/[id].ts
@@ -12,7 +12,7 @@ import { schemaUserEditBodyParams, schemaUserReadPublic, withValidUser } from "@
 
 /**
  * @swagger
- * /v1/users/{id}:
+ * /users/{id}:
  *   get:
  *     summary: Get a user by ID, returns your user if regular user.
  *     parameters:

diff --git a/pages/api/users/index.ts b/pages/api/users/index.ts
@@ -8,7 +8,7 @@ import { schemaUserReadPublic } from "@lib/validations/user";
 
 /**
  * @swagger
- * /v1/users:
+ * /users:
  *   get:
  *     summary: Get all users (admin only), returns your user if regular user.
  *     security: