1 Download and Upgrade to 15.0+ Series
2 New Features of ZenTao 15 Series
3 Interface Changes of 15 Series
4 Update to the Latest Version
5 Quick Start of 15 Series
6. Basic Application of Version 15
6.1 Beginner
6.2 Add Integrally
6.3 API Library
7. Base On The Roles
7.1. Admin
7.1.1 Edit Departments and Team Members
7.1.2 Edit Users
7.1.3 Edit Privilege
7.2. Program Leader
7.2.1 Create a Program
7.2.2 Link to Products
7.2.3 Create a Project
7.2.4 Manage Staffs
7.2.5 Add a Program Stakeholder
7.3. Product Owner
7.3.1 Create a Product
7.3.2 Edit Modules
7.3.3 Product Multi-branch/Platform Management
7.3.4 Edit Plans
7.3.5 Edit Stories
7.3.6 Review a Story
7.3.7 Create a Release
7.3.8 Tracking Progress
7.4. Project Manager
7.4.1 Edit Projects and Execution
7.4.2 Edit Teams
7.4.3 Link to Stories
7.4.4 Split Tasks
7.4.5 Tracking Progress
7.4.6 Waterfall Project
7.4.7 Kanban Project
7.5. Development Team
7.5.1 Apply for Tasks and Bugs
7.5.2 Update Status
7.5.3 Complete Tasks and Bugs
7.5.4 Submit Codes
7.5.5 The General Kanban, Story Kanban, Bug Kanban, and Task Kanban
7.6. Test Team
7.6.1 Edit Users' Case
7.6.2 Execute Users' Case
7.6.3 Submit a Bug
7.6.4 Test and Close a Bug
8. DevOps Features
8.1 Git/SVN Repository Management and Viewing Code
8.2. Integrate GitLab
8.2.1 Integrate GitLab, Bind Users, Link to Issues and Create a Build
8.2.2 Integrate GitLab and Submit the Merge Requests
8.2.3 GitLab Privilege in ZenTao
8.3 Integrate Jenkins and Create a Build
8.4 Integrate SonarQube
9 General Kanban
10. Backstage Settings of Version 15
10.1 Desktop
10.2 Model
10.3 Custom
10.4. Message
10.4.1 Mail
10.4.2 Webhook
10.4.3 Browser
10.4.4 Settings
10.5 Extension
10.6 Secondary Development
10.7 System
10.8 Import Jira Data
10.9 Registration Menu and Privilege
11. Privileges Management and Access Control of Version 15
11.1 Privileges Management and Access Control for Programs
11.2 Privileges Management and Access Control for Products
11.3 Privileges Management and Access Control for Projects
11.4 Privileges Management and Access Control for Executions
11.5 Access Control and Data Relationships for Projects and Executions

API Library

2022-01-20 18:19:02
Hongyan
818
Last edited by philip on 2022-01-24 13:49:10
Share links
Summary : API Library

API Library

ZenTao Open Source Version 15.7, the API library document function has been added in the document view.API documents, data structures can be managed here.
Next, we will introduce the use of the API library in detail.


First, Allocating authority

First, you need to assign the relevant operation permissions of the API library.
Go to the Admin--member--privilage, and assign the permissions of the following screenshots.




Permission assignment can be flexibly assigned according to actual work needs.

Second, maintain the API library

1. Create an API library
Click the Create button in the upper right corner of the API Library - Documentation page to enter the API library creation page.


 The API library creation page can set the request base path and the access control of the API library.

After the API library is created successfully, you can view it in the API library drop-down component in the upper left corner.
After the API library is created successfully, we can perform directory, version management, editing, and deletion operations on the API library.

2. Maintain the API library directory
Click the maintenance directory of the more icon in the upper right corner of the directory to enter the maintenance directory of the maintenance API library.

After adding the directory of the API library as needed, click Save.


Enter the maintenance directory page again, you can sort the directory, edit and delete, and add sub-directories.


3. Edit and delete API library


Also click the More icon in the upper right corner of the directory, and click the Edit API Library and Delete API Library buttons in the drop-down to operate.

Edit API library page:

Third,Maintenance API

After maintaining the directory of the API library, we can add the API library document.

1. Create an interface

Click the Create API button in the middle of the page, or the Create button in the upper right corner, to enter the API document creation page.



To create an API page, you need to fill in a little more content.


API Library: You can select the interface library you belong to in the drop-down list
Directory: The directory of the interface library to which it belongs, or you can select it from the drop-down list
Request Path: currently supports HTTP and HTTPS, GET, POST, PUT, DELETE, PACTH, OPTIONS, HEAD
Type: application/json , application/x-www-form-urluncoded , multipart/form-data
Status: development completed, in development, not displayed
Owner: The person responsible for the interface
Request header: The request header field of the interface
Parameters: The request parameter field of the interface


Request Body: There are 4 types: FormData, JSON, Array, Object
After selecting the type, you can fill in the field name, field type, whether it is required, and description according to the type.

And add subfields to fields, add and delete fields and subfields.

Request example: According to the request body, give a request example.

Request response: fill in the response fields of the API, field type, whether it is required, description, adding subfields, etc.


Response example: According to the request response field of the API, write a response example.
Description: A brief introduction to the API.


After filling in the  information, click Save to view the successfully added API in the list.
You can view the  status of the API and request the path.


2. Edit interface

Click the name of the API document in the interface list to enter the interface details page.
Click the Edit button in the upper right corner to enter the API editing page.




Edit API page:
It should be noted that editing an API cannot change the API library it belongs to.


3. Publish 

Publishing an API enables version management of API documents.
Click the publish button in the upper right corner to enter the version creation page of the publish.



After the API is published successfully, you can switch versions to view the API documentation.



5. Version management
After the API is published, you can also use the More button in the upper right corner of the directory to perform version management.
Here you can view published versions and delete unwanted versions.



Fourth, maintain the data structure

Next we introduce the data structure function.

Click the Create Data Structure button in the upper right corner of the page to enter the Add Data Structure page.





The successfully created data structure can be viewed in the list.
Edit and delete operations can also be performed via the action buttons.







Write a Comment
Comment will be posted after it is reviewed.