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! > > > > > > > -- > > > 来自 琚致远 > > > > > >
