groups redirect

Author: VinyarionHyarmendacil

openapi/components/parameters.yaml

@@ -315,6 +315,13 @@ groupByDuration:
   schema:
     type: string
     example: days
+groupShortCodeAndDiscriminator:
+  name: groupShortCodeAndDiscriminator
+  description: Must be a valid group short code and discriminator.
+  required: true
+  in: path
+  schema:
+    $ref: ./schemas/GroupShortCodeAndDiscriminator.yaml
 groupGalleryId:
   name: groupGalleryId
   description: Must be a valid group gallery 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

@@ -63,6 +63,30 @@ paths:
           $ref: ../responses/groups/GroupResponse.yaml
         "401":
           $ref: ../responses/MissingCredentialsError.yaml
+  "/groups/redirect/{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: 
+          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

openapi/components/schemas/GroupShortCodeAndDiscriminator.yaml

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