API: Make Swagger specification more consistent (#50576)

* Fix swagger generation targer using mac

Validate using the swagger binarry instead of the docker container

* API: Make swagger specification more consistent

Fix operation parameter ordering

pkg/api/docs/definitions/admin_ldap.go

@@ -61,8 +61,15 @@ package definitions
 // 500: internalServerError
 
 // swagger:parameters getLDAPUser
-type UserNameParam struct {
+type GetLDAPUserParams struct {
 	// in:path
 	// required:true
-	UserID string `json:"user_name"`
+	UserName string `json:"user_name"`
+}
+
+// swagger:parameters syncLDAPUser
+type SyncLDAPUserParams struct {
+	// in:path
+	// required:true
+	UserID int64 `json:"user_id"`
 }