From 61e590fa52ee5d256f52f5f27dd0483ff9d6acd9 Mon Sep 17 00:00:00 2001 From: "jan.ricica@dxheroes.io" Date: Wed, 2 Mar 2022 16:11:06 +0100 Subject: [PATCH 1/2] Complete time enteries --- docs/REST API Reference/Reference.yaml | 86 ++++++++++++++++++-------- 1 file changed, 59 insertions(+), 27 deletions(-) diff --git a/docs/REST API Reference/Reference.yaml b/docs/REST API Reference/Reference.yaml index a3e29ad..6880dae 100644 --- a/docs/REST API Reference/Reference.yaml +++ b/docs/REST API Reference/Reference.yaml @@ -11312,13 +11312,17 @@ paths: "$ref": "#/components/schemas/ErrorModel" "/time_entries.{format}": get: - summary: List of TimeEntries - description: For filtering send parameter `set_filter=1` and specify filters + summary: List of time enteries + operationId: ListOfTimeEnteries + description: Use this method to get list of time entries.
+ To successfully call a method, specify the format of response (format) and in the Path and fill all parameters into the Query.
+ An object with all time entries details is returned in the API call response.
+ See the schema below. tags: - Time entry parameters: - name: format - description: specify format of response + description: Specify format of the response. in: path required: true schema: @@ -11327,23 +11331,23 @@ paths: - json - xml - name: easy_query_q - description: free-text filter of current entity + description: Free-text filter of current entity. in: query schema: type: string - name: set_filter - description: enable filter through Easy Query + description: Enable filter through Easy Query. in: query schema: type: boolean - name: limit - description: the number of items to be present in the response (default is - 25, maximum is 100) + description: The number of items to be present in the response. Fefault is + 25, maximum is 100. in: query schema: type: integer - name: offset - description: the offset of the first object to retrieve + description: The offset of the first object to retrieve. in: query schema: type: integer @@ -11360,16 +11364,19 @@ paths: properties: total_count: type: number + description: Total count of time enteries. example: 75 xml: attribute: true offset: type: number + description: Time enteries offset. example: 0 xml: attribute: true limit: type: number + description: Limit of list time enteries. example: 25 xml: attribute: true @@ -11386,16 +11393,19 @@ paths: properties: total_count: type: number + description: Total count of time enteries. example: 75 xml: attribute: true offset: type: number + description: Time enteries offset. example: 0 xml: attribute: true limit: type: number + description: Limit of list time enteries. example: 25 xml: attribute: true @@ -11406,12 +11416,17 @@ paths: '401': description: not authorized post: - summary: Create TimeEntry + summary: Create time entry + operationId: CreateTimeEntry + description: Use this method to create new time entry.
+ To successfully call a method, specify the format of response (format) and in the Path and fill all parameters into the Body.
+ As a response, you can see the result of your new time entry with all possible parameters..
+ See the schema below. tags: - Time entry parameters: - name: format - description: specify format of response + description: Specify format of the response. in: path required: true schema: @@ -11420,7 +11435,7 @@ paths: - json - xml requestBody: - description: Create TimeEntry + description: Create new time entry. required: true content: application/json: @@ -11434,7 +11449,7 @@ paths: "$ref": "#/components/schemas/TimeEntryApiRequest" responses: '201': - description: created + description: Time entry was created. content: application/json: schema: @@ -11523,12 +11538,17 @@ paths: schema: "$ref": "#/components/schemas/ErrorModel" put: - summary: Update TimeEntry + summary: Update time entry + description: Use this method to update details about time entry.
+ To successfully call a method, specify the format of response (format) and ID of the time entry (id) in the Path.
+ An object with all possible details about time entry is returned in the API call response.
+ See the schema below. + operationId: UpdateTimeEntry tags: - Time entry parameters: - name: format - description: specify format of response + description: Specify format of the response. in: path required: true schema: @@ -11538,12 +11558,12 @@ paths: - xml - name: id in: path - description: ID of TimeEntry + description: ID of the time entry. required: true schema: type: integer requestBody: - description: Update given TimeEntry + description: Parameters to update time entry. required: true content: application/json: @@ -11557,7 +11577,7 @@ paths: "$ref": "#/components/schemas/TimeEntryApiRequest" responses: '200': - description: updated + description: Time entry was updated. content: application/json: schema: @@ -11595,12 +11615,15 @@ paths: schema: "$ref": "#/components/schemas/ErrorModel" delete: - summary: Destroy TimeEntry + summary: Delete time entry + operationId: DeleteTimeEntry + description: Use this method to delete time entry.
+ To successfully call a method, specify the format of response (format) and ID of the time entry (id) in the Path.
tags: - Time entry parameters: - name: format - description: specify format of response + description: Specify format of the response. in: path required: true schema: @@ -11610,13 +11633,13 @@ paths: - xml - name: id in: path - description: ID of TimeEntry + description: ID of the time entry. required: true schema: type: integer responses: '204': - description: ok + description: Time entry was deleted. '401': description: not authorized '403': @@ -12708,10 +12731,11 @@ components: properties: id: type: integer + description: ID of the custom field. example: 1 value: - example: Iron Man - description: value is based on field_format - can be Array, Boolean, Date + example: Your value. + description: Value is based on field_format - can be Array, Boolean or Date. type: string xml: name: custom_field_value @@ -19545,39 +19569,47 @@ components: properties: project_id: type: integer + description: ID of the project. issue_id: type: integer + description: ID of the issue. user_id: type: integer + description: ID of the user. priority_id: type: integer + description: ID of the priority. activity_id: type: integer + description: ID of the activity. easy_external_id: type: string + description: ID of the Easy external. hours: example: '8' - description: Amount of spent hours + description: Amount of spent hours. type: string spent_on: format: date example: '2019-07-09' - description: Date of spent time. It can be limited by global setting + description: Date of spent time. It can be limited by global setting. type: string comments: - example: I work very hard + example: I work mostly at the night. type: string easy_is_billable: type: boolean + description: True/false decision if you want to invoice the work. easy_billed: type: boolean + description: True/false decision if your work was invoiced by Easy. custom_fields: type: array items: "$ref": "#/components/schemas/CustomFieldValueApiRequest" tag_list: type: array - description: List of tags associated with entity + description: List of tags associated with entity. example: - deployment - gantt From fad6dcfa0d2e32911b844e67d336cba1295982d9 Mon Sep 17 00:00:00 2001 From: "jan.ricica@dxheroes.io" Date: Thu, 3 Mar 2022 10:12:57 +0100 Subject: [PATCH 2/2] Modified Test plans --- docs/REST API Reference/Reference.yaml | 80 +++++++++++++++++++------- 1 file changed, 59 insertions(+), 21 deletions(-) diff --git a/docs/REST API Reference/Reference.yaml b/docs/REST API Reference/Reference.yaml index 6880dae..0d47fbb 100644 --- a/docs/REST API Reference/Reference.yaml +++ b/docs/REST API Reference/Reference.yaml @@ -10989,12 +10989,16 @@ paths: "/test_plans.{format}": get: summary: List of TestPlans - description: For filtering send parameter `set_filter=1` and specify filters + operationId: ListOfTestPlans + description: Use this method to get list of test plans.
+ To successfully call a method, specify the format of response (format) in the Path and specific parameters into the Query.
+ As a response, you can see list of test plans. The number of test plans depends on limit parameters.
+ See the schema below. tags: - Test plan parameters: - name: format - description: specify format of response + description: Specify format of the response. in: path required: true schema: @@ -11003,29 +11007,29 @@ paths: - json - xml - name: easy_query_q - description: free-text filter of current entity + description: Free-text filter of current entity. in: query schema: type: string - name: set_filter - description: enable filter through Easy Query + description: Enable filter through Easy Query. in: query schema: type: boolean - name: limit - description: the number of items to be present in the response (default is - 25, maximum is 100) + description: The number of items to be present in the response Default is + 25, maximum is 100. in: query schema: type: integer - name: offset - description: the offset of the first object to retrieve + description: The offset of the first object to retrieve. in: query schema: type: integer responses: '200': - description: ok + description: OK content: application/json: schema: @@ -11036,16 +11040,19 @@ paths: properties: total_count: type: number + description: Total count of the test plans. example: 75 xml: attribute: true offset: type: number + description: Test plans offset. example: 0 xml: attribute: true limit: type: number + description: Current limit of test plans. example: 25 xml: attribute: true @@ -11083,11 +11090,16 @@ paths: description: not authorized post: summary: Create TestPlan + operationId: CreateTestPlan + description: Use this method to create new test plan.
+ To successfully call a method, specify the format of response (format) in the Path and fill all possible parameters to the Body.
+ As a response, you can see your created test plan.
+ See the schema below. tags: - Test plan parameters: - name: format - description: specify format of response + description: Specify format of the response. in: path required: true schema: @@ -11096,7 +11108,7 @@ paths: - json - xml requestBody: - description: Create TestPlan + description: Test plan parameters required: true content: application/json: @@ -11110,7 +11122,7 @@ paths: "$ref": "#/components/schemas/TestPlanApiRequest" responses: '201': - description: created + description: Test plan was created. content: application/json: schema: @@ -11150,17 +11162,22 @@ paths: "/test_plans/{id}.{format}": get: summary: Get TestPlan + operationId: GetTestPlan + description: Use this method to get details about test plan.
+ To successfully call a method, specify the format of response (format) and ID of the test plan in the Path.
+ As a response, you can see the details of your current test plan.
+ See the schema below. tags: - Test plan parameters: - name: id in: path - description: ID of TestPlan + description: ID of the test plan. required: true schema: type: integer - name: format - description: specify format of response + description: Specify format of the response. in: path required: true schema: @@ -11170,7 +11187,7 @@ paths: - xml responses: '200': - description: detail of TestPlan + description: Details of the TestPlan. content: application/json: schema: @@ -11200,11 +11217,16 @@ paths: "$ref": "#/components/schemas/ErrorModel" put: summary: Update TestPlan + operationId: UpdatedTestPlan + description: Use this method to update details about the test plan.
+ To successfully call a method, specify the format of response (format), ID of the test plan (id) in the Path and parameters you want to update to the Body.
+ As a response, you can see your updated test plan details.
+ See the schema below. tags: - Test plan parameters: - name: format - description: specify format of response + description: Specify format of the response. in: path required: true schema: @@ -11214,7 +11236,7 @@ paths: - xml - name: id in: path - description: ID of TestPlan + description: ID of the test plan. required: true schema: type: integer @@ -11271,12 +11293,15 @@ paths: schema: "$ref": "#/components/schemas/ErrorModel" delete: - summary: Destroy TestPlan + summary: Delete TestPlan + operationId: DeleteTestPlan + description: Use this method to delete test plan.
+ To successfully call a method, specify the format of response (format), ID of the test plan in the Path.
tags: - Test plan parameters: - name: format - description: specify format of response + description: Specify format of the response. in: path required: true schema: @@ -11286,13 +11311,13 @@ paths: - xml - name: id in: path - description: ID of TestPlan + description: ID of the test plan. required: true schema: type: integer responses: '204': - description: ok + description: Test plan was deleted. '401': description: not authorized '403': @@ -12743,18 +12768,22 @@ components: properties: id: type: integer + description: ID of the custom field value. readOnly: true example: 1 name: example: Hero list + description: Name of the custom field value. readOnly: true type: string internal_name: example: easy_hero_list + description: Internal name of the custom field. readOnly: true type: string field_format: readOnly: true + description: Specific format of the field. Choose one of the allowed values. enum: - string - text @@ -12784,7 +12813,7 @@ components: - flag type: string value: - description: value is based on field_format - can be Array, Boolean, Date + description: Value is based on field_format. It can be Array, Boolean or Date. type: string xml: name: custom_field_value @@ -19496,10 +19525,13 @@ components: properties: project_id: type: integer + description: ID of the project. author_id: type: integer + description: ID of the author. name: type: string + description: Name of the test plan. issue_ids: type: array items: @@ -19521,6 +19553,7 @@ components: properties: id: type: integer + description: ID of the test plan. readOnly: true example: 1 project: @@ -19529,10 +19562,12 @@ components: properties: id: type: integer + description: ID of the project. xml: attribute: true name: type: string + description: Name of the project. xml: attribute: true author: @@ -19541,14 +19576,17 @@ components: properties: id: type: integer + description: ID of the author. xml: attribute: true name: type: string + description: Name of the author. xml: attribute: true name: type: string + description: Name of the test plan. issue_ids: type: array items: