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

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


ru:airlay:api:air-lay-v4

Различия

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

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

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
ru:airlay:api:air-lay-v4 [2021/05/29 17:49]
Лев [Comment]
ru:airlay:api:air-lay-v4 [2021/06/20 13: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', 
 +                 'description' => 'label color', 
 +                 'required' => true 
 +             ], 
 +             [ 
 +                 'name' => 'type',
                  'type' => 'string',                  'type' => 'string',
-                 'description' => 'comment text',+                 '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' => [ 
 +              [ 
 +                 'name' => 'id', 
 +                 'type' => 'ObjectId', 
 +                 'description' => 'label id', 
 +                 'required' => true 
 +              ] 
 +         ]
      * ])      * ])
      * response([      * response([
          'status' => 200,          'status' => 200,
-         'message' => LabelsEntity[],+         'message' => 'Ok',
          'code' => 0          'code' => 0
      * ])      * ])
      *      *
-     * @Authorization(['CmsUser', 'User'])+     * @throws AirlayException 
 +     * 
 +     * @Authorization('CmsUser')
      */      */
 </code> </code>
Строка 192: Строка 197:
              ],              ],
              [              [
-                 'name' => 'userIds',+                 'name' => 'assignIds',
                  'type' => 'ObjectId[]',                  'type' => 'ObjectId[]',
                  'description' => 'assigns filter',                  'description' => 'assigns filter',
Строка 244: Строка 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
              ],              ],
Строка 250: Строка 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
              ],              ],
Строка 259: Строка 276:
              ],              ],
              [              [
-                 'name' => 'closeDate',+                 'name' => 'endDate',
                  'type' => 'int'|null,                  'type' => 'int'|null,
                  'description' => 'close date',                  'description' => 'close date',
Строка 277: Строка 294:
              ],              ],
              [              [
-                 'name' => 'ready',+                 'name' => 'progress',
                  'type' => 'int'|null,                  'type' => 'int'|null,
                  'description' => 'percentage of issue completed',                  'description' => 'percentage of issue completed',
Строка 321: Строка 338:
                  'description' => 'issue name',                  'description' => 'issue name',
                  'required' => true                  'required' => true
 +             ],
 +             [
 +                 'name' => 'statusId',
 +                 'type' => 'objectId'|null,
 +                 'description' => 'status id',
 +                 'required' => false
              ],              ],
              [              [
Строка 326: Строка 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
              ],              ],
Строка 341: Строка 370:
              ],              ],
              [              [
-                 'name' => 'closeDate',+                 'name' => 'endDate',
                  'type' => 'int'|null,                  'type' => 'int'|null,
                  'description' => 'close date',                  'description' => 'close date',
Строка 359: Строка 388:
              ],              ],
              [              [
-                 'name' => 'ready',+                 'name' => 'progress',
                  'type' => 'int'|null,                  'type' => 'int'|null,
                  'description' => 'percentage of issue completed',                  'description' => 'percentage of issue completed',
Строка 414: Строка 443:
 === addObserverAction === === addObserverAction ===
 <code php> <code php>
-    /**+   /**
      * Add observer      * Add observer
      * request([      * request([
Строка 464: Строка 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
              ],              ],
Строка 489: Строка 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>
Строка 503: Строка 568:
                  'name' => 'id',                  'name' => 'id',
                  'type' => 'objectId',                  'type' => 'objectId',
-                 'description' => 'issue id',+                 'description' => 'Issue id',
                  'required' => true                  'required' => true
              ],              ],
Строка 516: Строка 581:
      * response([      * response([
          'status' => 200,          'status' => 200,
-         'message' => 'IssueEntity',+         'message' => 'CommentEntity',
          'code' => 0          'code' => 0
      * ])      * ])
Строка 522: Строка 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
              ]              ]
Строка 550: Строка 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
              ]              ]
Строка 582: Строка 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.1622285345.txt.gz · Последнее изменение: 2021/05/29 17:49 — Лев