Group redirect thing

openapi/components/parameters.yaml

@@ -301,12 +301,12 @@
   in: query
   schema:
     $ref: ./schemas/UserID.yaml
 fuzzy:
   name: fuzzy
   required: false
   in: query
   schema:
     type: boolean
 groupByDuration:
   name: groupByDuration
   description: Time bucket size for economy metrics. Observed values include `days` and `years`.
@@ -364,6 +364,13 @@
   in: path
   schema:
     $ref: ./schemas/GroupRoleID.yaml
+groupShortCodeAndDiscriminator:
+  name: groupShortCodeAndDiscriminator
+  description: Must be a valid group short code and discriminator.
+  required: true
+  in: path
+  schema:
+    $ref: ./schemas/GroupShortCodeAndDiscriminator.yaml
 hydrate:
   name: hydrate
   description: Populates some fields and changes types of others for certain objects.
@@ -471,7 +478,7 @@
     $ref: ./schemas/InventoryItemType.yaml
 inventoryPedestalDuration:
   name: duration
   description: The duration before the sharing pedestal despawns.
   required: true
   in: query
   schema:
@@ -645,12 +652,12 @@
   schema:
     type: string
     format: date-time
 mostRecentFlag:
   name: mostRecent
   required: false
   in: query
   schema:
     type: boolean
 noplatform:
   name: noplatform
   description: The platform the asset does not support.
@@ -834,18 +841,18 @@
   schema:
     type: string
     example: game night
 storeId:
   name: storeId
   required: true
   in: query
   schema:
     $ref: ./schemas/StoreID.yaml
 storeView:
   name: fetch
   required: false
   in: query
   schema:
     $ref: ./schemas/StoreView.yaml
 submitterId:
   name: submitterId
   description: Must be a valid user ID.

openapi/components/paths.yaml

@@ -172,6 +172,8 @@
   $ref: "./paths/files.yaml#/paths/~1gallery"
 /groups:
   $ref: "./paths/groups.yaml#/paths/~1groups"
+/groups/redirect/{groupShortCodeAndDiscriminator}:
+  $ref: "./paths/groups.yaml#/paths/~1groups~1redirect~1{groupShortCodeAndDiscriminator}"
 /groups/roleTemplates:
   $ref: "./paths/groups.yaml#/paths/~1groups~1roleTemplates"
 "/groups/{groupId}":

openapi/components/paths/groups.yaml

@@ -25,7 +25,7 @@
           $ref: ../responses/files/FileNotFoundError.yaml
   /groups:
     get:
       operationId: searchGroups
       summary: Search Group
       description: Searches Groups by name or shortCode
       tags:
@@ -63,6 +63,32 @@
           $ref: ../responses/groups/GroupResponse.yaml
         "401":
           $ref: ../responses/MissingCredentialsError.yaml
+  "/groups/redirect/{groupShortCodeAndDiscriminator}":
+    parameters:
+      - $ref: ../parameters.yaml#/groupShortCodeAndDiscriminator
+    get:
+      operationId: resolveGroupShortCodeAndDiscriminator
+      summary: Resolve Group Short Code and Discriminator
+      description: |-
+        Resolves a group short code and discriminator to a group ID.
+
+        **Only works with the api.vrchat.cloud domain.**
+
+        Other domains respond with a redirect to this endpoint on the api.vrchat.cloud domain.
+        (e.g., to https://api.vrchat.cloud/api/1/groups/redirect/VRCHAT.0000)
+      tags:
+        - groups
+      responses:
+        "302":
+          description: Redirect to the /home/group/{groupId} URL of the group.
+          headers:
+            Location:
+              description: The /home/group/{groupId} URL of the group.
+              schema:
+                type: string
+                example: /home/group/grp_7ccb6ca3-cd36-4dab-9ab1-7bcf08d794e4
+        "404":
+          $ref: ../responses/groups/GroupNotFoundError.yaml
   /groups/roleTemplates:
     get:
       operationId: getGroupRoleTemplates
@@ -96,8 +122,8 @@
       security:
         - authCookie: []
       responses:
         "200":
           $ref: ../responses/groups/GroupResponse.yaml
         "401":
           $ref: ../responses/MissingCredentialsError.yaml
         "404":
@@ -111,13 +137,13 @@
       requestBody:
         content:
           application/json:
             schema:
               $ref: ../requests/UpdateGroupRequest.yaml
       security:
         - authCookie: []
       responses:
         "200":
           $ref: ../responses/groups/GroupResponse.yaml
         "401":
           $ref: ../responses/MissingCredentialsError.yaml
         "404":
@@ -129,11 +155,11 @@
       tags:
         - groups
       parameters:
         - name: hardDelete
           required: false
           in: query
           schema:
             type: boolean
       security:
         - authCookie: []
       responses:
@@ -204,7 +230,7 @@
     parameters:
       - $ref: ../parameters.yaml#/groupId
     get:
       operationId: getGroupAuditLogEntryTypes
       summary: Get Group Audit Log Entry Types
       description: Returns a list of audit log entry types for which the group has entries.
       tags:
@@ -238,8 +264,8 @@
       security:
         - authCookie: []
       responses:
         "200":
           $ref: ../responses/groups/GroupAuditLogListResponse.yaml
         "401":
           $ref: ../responses/MissingCredentialsError.yaml
         "404":
@@ -248,7 +274,7 @@
     parameters:
       - $ref: ../parameters.yaml#/groupId
     get:
       operationId: getGroupBans
       summary: Get Group Bans
       description: Returns a list of banned users for a Group.
       tags:
@@ -297,7 +323,7 @@
     delete:
       operationId: unbanGroupMember
       summary: Unban Group Member
       description: Unbans a user from a Group.
       tags:
         - groups
       security:
@@ -360,7 +386,7 @@
       - $ref: ../parameters.yaml#/groupId
       - $ref: ../parameters.yaml#/groupGalleryId
     get:
       operationId: getGroupGalleryImages
       summary: Get Group Gallery Images
       description: Returns a list of images for a Group gallery.
       tags:
@@ -489,7 +515,7 @@
     parameters:
       - $ref: ../parameters.yaml#/groupId
     get:
       operationId: getGroupInstances
       summary: Get Group Instances
       description: Returns a list of group instances
       tags:
@@ -497,8 +523,8 @@
       security:
         - authCookie: []
       responses:
         "200":
           $ref: ../responses/groups/GroupInstanceListResponse.yaml
         "401":
           $ref: ../responses/MissingCredentialsError.yaml
         "404":
@@ -507,7 +533,7 @@
     parameters:
       - $ref: ../parameters.yaml#/groupId
     get:
       operationId: getGroupInvites
       summary: Get Group Invites Sent
       description: Returns a list of members that have been invited to the Group.
       tags:

openapi/components/schemas/GroupShortCodeAndDiscriminator.yaml

@@ -0,0 +1,3 @@
+title: GroupShortCodeAndDiscriminator
+type: string
+example: VRCHAT.0000