Yes, I very much agree with you, the coexistence of the two is the best way. You can choose which way to use according to your wishes, OpenApi or SDK. If we do this, we must ensure a high degree of consistency between SDK and OpenAPI, as well as SDK standard annotations.
Sheng Wu <[email protected]> 于2021年9月25日周六 下午8:46写道： > I am not using this API manually but considering mentioned OpenAPI V.S. > SDK. > Take a good reference from k8s APIs, it has very clear OpenAPI definitions, > meanwhile, the SDK projects are continuously being set up. > I am using k8s-api-java-client daily. > My point is, these two are both meaningful, we should consider both. > > Sheng Wu 吴晟 > Twitter, wusheng1108 > > > Zeping Bai <[email protected]> 于2021年9月25日周六 下午8:29写道： > > > Hi, > > I very much agree to provide the Admin API SDK, but I see that you > > only mentioned the Java language. In fact, I think if we can provide an > > OpenAPI (Swagger) [1] specification file, we can generate normal API > > documents and multi language SDKs with the help of OpenAPI generator > > tool [2]. > > > > What do you think? > > > > [1] OpenAPI Specification <https://swagger.io/resources/open-api/> > > [2] OpenAPITools/openapi-generator > > <https://github.com/OpenAPITools/openapi-generator> > > > > 孙昊 <[email protected]> 于2021年9月25日周六 下午6:45写道： > > > > > Hi: > > > If your team thinks my suggestion is reasonable, I am very happy to > > > assist you in this matter. I have used Java as the main development > > > language for 10 years. > > > About the "mustake": > > > 1. When I want to use an API, I have to go to the official website > of > > > apisix to find documentation. If we have a perfect javadoc, we can > solve > > > this problem greatly. > > > 2. It may be due to carelessness, wrong parameter names and wrong > > > types. This will cause a lot of trouble. But Java is strongly typed, > and > > > this type of problem can be avoided. > > > > > > Zhiyuan Ju <[email protected]> 于2021年9月25日周六 下午6:37写道： > > > > > > > Good suggestion! Does anyone else also like this kind of SDK? If so, > > > would > > > > you like to take this project? > > > > > > > > BTW, may I know the details information about “mustake” you mean? > > > > > > > > 孙昊 <[email protected]>于2021年9月25日 周六下午6:27写道： > > > > > > > > > Hello, everyone: > > > > > Our company now uses apisix as our api gateway, and our main > > > > > development languages are Java and JavaScript. > > > > > In the process of using apisix, we often use the admin api of > > > apisix. > > > > > We need to create and initiate requests repeatedly, which is very > > > > > cumbersome, and sometimes, the parameter names, parameter types, > etc. > > > are > > > > > mistaken. So, I suggest that the apisix team can release an SDK > > toolkit > > > > for > > > > > Java, Types can be defined inside, because Java is strongly typed. > > > > > Good luck to everyone! > > > > > > > > > -- > > > > 来自 琚致远 > > > > > > > > > >
