use star as swagger model

modules/forgefed/star.go

@@ -25,7 +25,10 @@ var KnownSourceTypes = SourceTypes{
 	ForgejoSourceType,
 }
 
+// Star activity for adding a star to an repository
+// swagger:model
 type Star struct {
+	// swagger: ignore
 	ap.Activity
 	// Source identifies the system generated this Activity. Exact one value has to be specified.
 	Source SourceType `jsonld:"source,omitempty"`

routers/api/v1/activitypub/repository.go

@@ -34,7 +34,6 @@ func Repository(ctx *context.APIContext) {
 	//   "200":
 	//     "$ref": "#/responses/ActivityPub"
 
-	// TODO: Mabe we should use F3 Repo instead?
 	link := fmt.Sprintf("%s/api/v1/activitypub/repoistory-id/%d", strings.TrimSuffix(setting.AppURL, "/"), ctx.Repo.Repository.ID)
 	repo := forgefed.RepositoryNew(ap.IRI(link))
 
@@ -61,6 +60,10 @@ func RepositoryInbox(ctx *context.APIContext) {
 	//   description: repository ID of the repo
 	//   type: integer
 	//   required: true
+	// - name: body
+	//   in: body
+	//   schema:
+	//     "$ref": "#/definitions/Star"
 	// responses:
 	//   "204":
 	//     "$ref": "#/responses/empty"

routers/api/v1/swagger/options.go

@@ -1,9 +1,10 @@
-// Copyright 2017 The Gitea Authors. All rights reserved.
+// Copyright 2023 The Gitea & forgejo Authors. All rights reserved.
 // SPDX-License-Identifier: MIT
 
 package swagger
 
 import (
+	ffed "code.gitea.io/gitea/modules/forgefed"
 	api "code.gitea.io/gitea/modules/structs"
 	"code.gitea.io/gitea/services/forms"
 )
@@ -14,6 +15,9 @@ import (
 // parameterBodies
 // swagger:response parameterBodies
 type swaggerParameterBodies struct {
+	// in:body
+	Star ffed.Star
+
 	// in:body
 	AddCollaboratorOption api.AddCollaboratorOption
 

templates/swagger/v1_json.tmpl

@@ -66,6 +66,13 @@
             "name": "repository-id",
             "in": "path",
             "required": true
+          },
+          {
+            "name": "body",
+            "in": "body",
+            "schema": {
+              "$ref": "#/definitions/Star"
+            }
           }
         ],
         "responses": {