Good afernoon! After group discussion, we have solved most of the specification problems of API design. But, there is still a problem about path prefix, which needs to be discussed and unified by the community. There are now three options for path prefixes: 1. /dolphinscheduler (This is the original scheme.) 2. /api/dolphinscheduler (This scheme can distinguish between API interfaces and static resources.) 3. /api/dolphinscheduler/v1 (This scheme adds version identification, but the path length is too long.)
Refer to the API of Baidu, Tencent and wechat, as shown below, their domain names are identified by api, such as api.baidubce.com. But in terms of version, some reflect in path, some do not. In my opinion, I choose the second option. After discussion, we all agree that the path should not be too long. But I think it is necessary to identify the api on the URL. I hope you can give more opinions and ideas. Thanks!
