Improve the API changes

Author: lunny

routers/api/v1/admin/runners.go

@@ -18,6 +18,11 @@ func GetRegistrationToken(ctx *context.APIContext) {
 	// produces:
 	// - application/json
 	// parameters:
+	// - name: set-token
+	//   in: body
+	//   description: set a runner register token instead of generating one.
+	//   type: string
+	//   required: false
 	// responses:
 	//   "200":
 	//     "$ref": "#/responses/RegistrationToken"

routers/api/v1/org/action.go

@@ -182,6 +182,11 @@ func (Action) GetRegistrationToken(ctx *context.APIContext) {
 	//   description: name of the organization
 	//   type: string
 	//   required: true
+	// - name: set-token
+	//   in: body
+	//   description: set a runner register token instead of generating one.
+	//   type: string
+	//   required: false
 	// responses:
 	//   "200":
 	//     "$ref": "#/responses/RegistrationToken"

routers/api/v1/repo/action.go

@@ -500,6 +500,11 @@ func (Action) GetRegistrationToken(ctx *context.APIContext) {
 	//   description: name of the repo
 	//   type: string
 	//   required: true
+	// - name: set-token
+	//   in: body
+	//   description: set a runner register token instead of generating one.
+	//   type: string
+	//   required: false
 	// responses:
 	//   "200":
 	//     "$ref": "#/responses/RegistrationToken"

routers/api/v1/shared/runners.go

@@ -19,14 +19,14 @@ type RegistrationToken struct {
 }
 
 func GetRegistrationToken(ctx *context.APIContext, ownerID, repoID int64) {
-	putToken := ctx.FormString("put-token")
+	setToken := ctx.FormString("set-token")
 	var token *actions_model.ActionRunnerToken
 	var err error
-	if putToken == "" {
+	if setToken == "" {
 		token, err = actions_model.GetLatestRunnerToken(ctx, ownerID, repoID)
 	}
-	if putToken != "" || errors.Is(err, util.ErrNotExist) || (token != nil && !token.IsActive) {
-		token, err = actions_model.NewRunnerToken(ctx, ownerID, repoID, putToken)
+	if setToken != "" || errors.Is(err, util.ErrNotExist) || (token != nil && !token.IsActive) {
+		token, err = actions_model.NewRunnerToken(ctx, ownerID, repoID, setToken)
 	}
 	if err != nil {
 		ctx.InternalServerError(err)