parent
  • jmcs
    +4

    Use something like Swagger to hold the docs. It's lovely.

    +1 to this swagger. There are several tools built around it.

    REST not SOAP. JSON not XML

    Just to add to this do proper REST. This is not proper REST, think resources/nouns not verbs, if you think your resources right the API will be easier to future proof. Consider using HATEOAS (with JSON) because it may make well implemented clients more resilient to changes.