Инструменты пользователя

Инструменты сайта


ru:airlay:api:air-lay-v4

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слеваПредыдущая версия
Следующая версия
Предыдущая версия
ru:airlay:api:air-lay-v4 [2021/05/29 15:05] – [Label] Левru:airlay:api:air-lay-v4 [2021/06/20 08:49] (текущий) – [Label] Лев
Строка 41: Строка 41:
 =====Контроллеры===== =====Контроллеры=====
  
-==== Status ====+ 
 + 
 + 
 +==== Label====
 === getAction === === getAction ===
 <code php> <code php>
     /**     /**
-     * Get statuses by ids +     * Get labels 
-     * request(+     * request([
      *     'method' => 'GET',      *     'method' => 'GET',
-     *     'url' => '/api/v4/status/getByIds' +     *     'url' => '/api/v4/label/get' 
-     * ) +     *     'params' => [ 
-     * response( +     *         [ 
-     *     '200' => [ +     *             'name' => 'type', 
-     *          'status' => 200, +     *             'type' => 'string', 
-     *          'message' => StatusEntity[] +     *             'description' => 'label type', 
-     *          'code' => 0+     *             'required' => true 
 +     *         ]
      *     ]      *     ]
-     * )+     * ]) 
 +     * response([ 
 +     *     'status' => 200, 
 +     *     'message' => LabelsEntity[], 
 +     *     'code' => 0 
 +     * ])
      *      *
      * @Authorization(['CmsUser', 'User'])      * @Authorization(['CmsUser', 'User'])
 +     *
 +     * @throws AirlayException
      */      */
 </code> </code>
  
-==== Comment ==== +=== createAction ===
-=== getByIdsAction === +
-<code php> +
-    /** +
-     * Get comments by ids +
-     * request( +
-     *     'method' => 'GET', +
-     *     'url' => '/api/v4/comment/getByIds', +
-     *     'params' => [ +
-     *          [ +
-     *              'name' => 'ids', +
-     *              'type' => 'ObjectId', +
-     *              'required' => true, +
-     *              'description' => 'comment ids from issue' +
-     *          ] +
-     *     ] +
-     * ) +
-     * response( +
-     *     '200' => [ +
-     *          'status' => 200, +
-     *          'message' => CommentEntity[] +
-     *          'code' => 0 +
-     *     ] +
-     * ) +
-     * +
-     * @Authorization(['CmsUser', 'User']) +
-     */ +
-</code> +
-=== updateAction ===+
 <code php> <code php>
     /**     /**
-     * Update comment+     * Create label
      * request([      * request([
      *     'method' => 'POST',      *     'method' => 'POST',
-     *     'url' => '/api/v4/comment/update'+     *     'url' => '/api/v4/label/create'
      *     'params' => [      *     'params' => [
      *          [      *          [
-     *             'name' => 'id', +     *             'name' => 'name', 
-     *             'type' => 'objectId', +     *             'type' => 'string', 
-     *             'description' => 'comment id',+     *             'description' => 'label name',
      *             'required' => true      *             'required' => true
      *         ],      *         ],
      *         [      *         [
-     *             'name' => 'text',+     *             'name' => 'color',
      *             'type' => 'string',      *             'type' => 'string',
-     *             'description' => 'comment text',+     *             'description' => 'label color', 
 +     *             'required' => true 
 +     *         ], 
 +     *         [ 
 +     *             'name' => 'type', 
 +     *             'type' => 'string', 
 +     *             'description' => 'label type',
      *             'required' => true      *             'required' => true
      *         ]      *         ]
Строка 114: Строка 103:
      * response([      * response([
      *     'status' => 200,      *     'status' => 200,
-     *     'message' => "ok",+     *     'message' => LabelEntity,
      *     'code' => 0      *     'code' => 0
      * ])      * ])
Строка 123: Строка 112:
      */      */
 </code> </code>
-=== deleteAction ===+ 
 +=== updateAction ===
 <code php> <code php>
     /**     /**
-     * Delete comment+     * Update label
      * request([      * request([
      *     'method' => 'POST',      *     'method' => 'POST',
-     *     'url' => '/api/v4/comment/delete'+     *     'url' => '/api/v4/label/update'
      *     'params' => [      *     'params' => [
      *          [      *          [
-     *             'name' => 'commentId', +     *             'name' => 'id', 
-     *             'type' => 'objectId', +     *             'type' => 'ObjectId', 
-     *             'description' => 'comment id',+     *             'description' => 'label id',
      *             'required' => true      *             'required' => true
 +     *          ],
 +     *          [
 +     *             'name' => 'name',
 +     *             'type' => 'string'|null,
 +     *             'description' => 'label name',
 +     *             'required' => false
      *         ],      *         ],
      *         [      *         [
-     *             'name' => 'issueId', +     *             'name' => 'color', 
-     *             'type' => 'objectId', +     *             'type' => 'string'|null, 
-     *             'description' => 'issue id', +     *             'description' => 'label color', 
-     *             'required' => true+     *             'required' => false
      *         ]      *         ]
      *     ]      *     ]
Строка 147: Строка 143:
      * response([      * response([
      *     'status' => 200,      *     'status' => 200,
-     *     'message' => "ok",+     *     'message' => LabelEntity,
      *     'code' => 0      *     'code' => 0
      * ])      * ])
Строка 157: Строка 153:
 </code> </code>
  
-==== Label==== +=== deleteAction ===
-=== getAction ===+
 <code php> <code php>
     /**     /**
-     * Get labels+     * Delete label
      * request([      * request([
-     *     'method' => 'GET', +     *     'method' => 'POST', 
-     *     'url' => '/api/v4/label/get'+     *     'url' => '/api/v4/label/delete'
      *     'params' => [      *     'params' => [
-     *         [ +     *          [ 
-     *             'name' => 'type', +     *             'name' => 'id', 
-     *             'type' => 'string', +     *             'type' => 'ObjectId', 
-     *             'description' => 'label type', +     *             'description' => 'label id', 
-     *             'required' => false +     *             'required' => true 
-     *         ]+     *          ]
      *     ]      *     ]
      * ])      * ])
      * response([      * response([
      *     'status' => 200,      *     'status' => 200,
-     *     'message' => LabelsEntity[],+     *     'message' => 'Ok',
      *     'code' => 0      *     'code' => 0
      * ])      * ])
      *      *
-     * @Authorization(['CmsUser', 'User'])+     * @throws AirlayException
      *      *
-     * @throws AirlayException+     * @Authorization('CmsUser')
      */      */
 </code> </code>
Строка 202: Строка 197:
      *         ],      *         ],
      *         [      *         [
-     *             'name' => 'userIds',+     *             'name' => 'assignIds',
      *             'type' => 'ObjectId[]',      *             'type' => 'ObjectId[]',
      *             'description' => 'assigns filter',      *             'description' => 'assigns filter',
Строка 254: Строка 249:
      *             'type' => 'string',      *             'type' => 'string',
      *             'description' => 'issue description',      *             'description' => 'issue description',
 +     *             'required' => false
 +     *         ],
 +     *         [
 +     *             'name' => 'assignId',
 +     *             'type' => 'objectId|null',
 +     *             'description' => 'issue assign user id',
      *             'required' => false      *             'required' => false
      *         ],      *         ],
Строка 260: Строка 261:
      *             'type' => 'objectId'|null,      *             'type' => 'objectId'|null,
      *             'description' => 'priority id',      *             'description' => 'priority id',
 +     *             'required' => false
 +     *         ],,
 +     *         [
 +     *             'name' => 'statusId',
 +     *             'type' => 'objectId'|null,
 +     *             'description' => 'status id',
      *             'required' => false      *             'required' => false
      *         ],      *         ],
Строка 269: Строка 276:
      *         ],      *         ],
      *         [      *         [
-     *             'name' => 'closeDate',+     *             'name' => 'endDate',
      *             'type' => 'int'|null,      *             'type' => 'int'|null,
      *             'description' => 'close date',      *             'description' => 'close date',
Строка 331: Строка 338:
      *             'description' => 'issue name',      *             'description' => 'issue name',
      *             'required' => true      *             'required' => true
 +     *         ],
 +     *         [
 +     *             'name' => 'statusId',
 +     *             'type' => 'objectId'|null,
 +     *             'description' => 'status id',
 +     *             'required' => false
      *         ],      *         ],
      *         [      *         [
Строка 336: Строка 349:
      *             'type' => 'string',      *             'type' => 'string',
      *             'description' => 'issue description',      *             'description' => 'issue description',
 +     *             'required' => false
 +     *         ],
 +     *         [
 +     *             'name' => 'assignId',
 +     *             'type' => 'objectId|null',
 +     *             'description' => 'issue assign user id',
      *             'required' => false      *             'required' => false
      *         ],      *         ],
Строка 351: Строка 370:
      *         ],      *         ],
      *         [      *         [
-     *             'name' => 'closeDate',+     *             'name' => 'endDate',
      *             'type' => 'int'|null,      *             'type' => 'int'|null,
      *             'description' => 'close date',      *             'description' => 'close date',
Строка 424: Строка 443:
 === addObserverAction === === addObserverAction ===
 <code php> <code php>
-    /**+   /**
      * Add observer      * Add observer
      * request([      * request([
Строка 474: Строка 493:
      *             'type' => 'objectId',      *             'type' => 'objectId',
      *             'description' => 'issue id',      *             'description' => 'issue id',
-     *             'required' => true 
-     *         ], 
-     *         [ 
-     *             'name' => 'type', 
-     *             'type' => 'string' ('user' | 'organization' | 'group' | 'department'), 
-     *             'description' => 'type of observer', 
      *             'required' => true      *             'required' => true
      *         ],      *         ],
Строка 499: Строка 512:
      *      *
      * @Authorization('CmsUser')      * @Authorization('CmsUser')
 +     */
 +</code>
 +
 +=== getCommentsAction ===
 +<code php>
 +    /**
 +     * Get issue comments
 +     * request(
 +     *     'method' => 'GET',
 +     *     'url' => '/api/v4/issue/getComments',
 +     *     'params' => [
 +     *          [
 +     *              'name' => 'issueId',
 +     *              'type' => 'ObjectId',
 +     *              'required' => true,
 +     *              'description' => 'Issue id'
 +     *          ],
 +     *          [
 +     *              'name' => 'skip',
 +     *              'type' => 'int',
 +     *              'required' => false,
 +     *              'description' => 'Skip comments in result'
 +     *          ],
 +     *          [
 +     *              'name' => 'limit',
 +     *              'type' => 'int',
 +     *              'required' => false,
 +     *              'description' => 'Limit comments in result'
 +     *          ]
 +     *     ]
 +     * )
 +     * response(
 +     *     '200' => [
 +     *          'status' => 200,
 +     *          'message' => CommentEntity[]
 +     *          'code' => 0
 +     *     ]
 +     * )
 +     *
 +     * @throws AirlayException
 +     *
 +     * @Authorization
      */      */
 </code> </code>
Строка 513: Строка 568:
      *             'name' => 'id',      *             'name' => 'id',
      *             'type' => 'objectId',      *             'type' => 'objectId',
-     *             'description' => 'issue id',+     *             'description' => 'Issue id',
      *             'required' => true      *             'required' => true
      *         ],      *         ],
Строка 526: Строка 581:
      * response([      * response([
      *     'status' => 200,      *     'status' => 200,
-     *     'message' => 'IssueEntity',+     *     'message' => 'CommentEntity',
      *     'code' => 0      *     'code' => 0
      * ])      * ])
Строка 532: Строка 587:
      * @throws AirlayException      * @throws AirlayException
      *      *
-     * @Authorization('CmsUser')+     * @Authorization
      */      */
 </code> </code>
  
-=== setPriorityAction ===+=== updateCommentAction ===
 <code php> <code php>
     /**     /**
-     * Set priority+     * Update comment.
      * request([      * request([
      *     'method' => 'POST',      *     'method' => 'POST',
-     *     'url' => '/api/v4/issue/setPriority'+     *     'url' => '/api/v4/issue/updateComment'
      *     'params' => [      *     'params' => [
      *          [      *          [
      *             'name' => 'id',      *             'name' => 'id',
      *             'type' => 'objectId',      *             'type' => 'objectId',
-     *             'description' => 'issue id',+     *             'description' => 'Comment id',
      *             'required' => true      *             'required' => true
      *         ],      *         ],
      *         [      *         [
-     *             'name' => 'priorityId', +     *             'name' => 'text', 
-     *             'type' => 'objectId', +     *             'type' => 'string', 
-     *             'description' => 'priority id for field',+     *             'description' => 'Comment text',
      *             'required' => true      *             'required' => true
      *         ]      *         ]
Строка 560: Строка 615:
      * response([      * response([
      *     'status' => 200,      *     'status' => 200,
-     *     'message' => IssueEntity,+     *     'message' => 'CommentEntity',
      *     'code' => 0      *     'code' => 0
      * ])      * ])
 +     *
      * @throws AirlayException      * @throws AirlayException
 +     *
      * @Authorization      * @Authorization
      */      */
 </code> </code>
  
-=== changeStatusAction ===+=== removeCommentAction ===
 <code php> <code php>
     /**     /**
-     * Change status+     * Remove comment from issue.
      * request([      * request([
      *     'method' => 'POST',      *     'method' => 'POST',
-     *     'url' => '/api/v4/issue/changeStatus'+     *     'url' => '/api/v4/issue/removeComment'
      *     'params' => [      *     'params' => [
-     *          [+     *         [
      *             'name' => 'id',      *             'name' => 'id',
      *             'type' => 'objectId',      *             'type' => 'objectId',
-     *             'description' => 'issue id', +     *             'description' => 'Comment id',
-     *             'required' => true +
-     *         ], +
-     *         [ +
-     *             'name' => 'statusId', +
-     *             'type' => 'objectId', +
-     *             'description' => 'status id for field',+
      *             'required' => true      *             'required' => true
      *         ]      *         ]
Строка 592: Строка 643:
      * response([      * response([
      *     'status' => 200,      *     'status' => 200,
-     *     'message' => IssueEntity,+     *     'message' => 'Ok',
      *     'code' => 0      *     'code' => 0
      * ])      * ])
 +     *
      * @throws AirlayException      * @throws AirlayException
 +     *
      * @Authorization      * @Authorization
      */      */
ru/airlay/api/air-lay-v4.1622293523.txt.gz · Последнее изменение: (внешнее изменение)