GideonZ / 1541u-documentation

Documentation sources for 1541 Ultimate-II(+) and Ultimate-64 products
36 stars 14 forks source link

Can I have OpenAPI please? #12

Open enver-haase opened 7 months ago

enver-haase commented 7 months ago

It would help a lot if you could provide a file according to

https://www.openapis.org/

that descibes the API?

So that I can write a Java application using the API rather than spending ages implementing the Java service layer on top of your API. These days, the Java binding should be auto-generated.

Cheers + Thanks for the Ultimate, --Enver

GideonZ commented 7 months ago

Hi Enver. Your request is understood. But well, it would require specifing the API once again and maintain it alongside the current implementation and keeping everything in sync until the end of days. I think this is asking for trouble.

Compared to the effort of implementing these API calls on my side in "C", I think the effort in Java in peanuts in comparison. It will take much more time on my side than it will take on yours, so I incline to not grant your request. You could easily just grab a library that can do URL calls and specify a simple function around these calls. What I understood from the creator of Assembly 64, he found it pleasantly easy to do. On my side I had to implement everything, including the parsing of the headers and multipart attachments, which has literally taken me days to do.