search

makeplans / makeplans-api

API documentation for MakePlans
https://developer.makeplans.com
16 stars 8 forks source link

Proposal: Describe the API in OpenAPI #4

Open simenandre opened 4 years ago

simenandre commented 4 years ago

Hello!

As Makeplans does not have any officially supported SDKs, and those who are available are either not maintained or unfinished, it would be very good to have OpenAPI files to SDKs with.

You can find some examples of my own SDK-libraries: bjerkio/tripletexjs, bjerkio/unieconomy and bjerkio/crayon-api-js. This would very much simplify implementing integrations with Makeplans.

What do you think?

espen commented 4 years ago

👋 @cobraz

Sorry for the late reply.

Thanks for the suggestion. It has been a while since I have looked at OpenAPI but will check it out again. I can see how it can be useful but I'm a bit sceptical to autogenerated code for production usage.

What are you planning to use the MakePlans API for? Would love to discuss more about your project or if you have any questions about the API just contact us at makeplans@makeplans.net

simenandre commented 4 years ago

I have a customer who'd like to use it, but need the flexibility that an API offer.

I curious as to what makes you sceptical about auto generated code for production use?