sorry for reply late,  please paste the picture url in the mail, apache
mail can't show the picture
is the usage(like api.baidubce.com) a better choice?


Best Regards



---------------
Apache DolphinScheduler PMC Chair
David Dai
[email protected]
Linkedin: https://www.linkedin.com/in/dailidong
Twitter: @WorkflowEasy <https://twitter.com/WorkflowEasy>
---------------


On Thu, Aug 12, 2021 at 1:00 PM 马浚杰 <[email protected]> wrote:

> 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!
>
>
>
>
>
>

Reply via email to