I went into documenter.getpostman.com today and saw immediately that the ChangeLog for the API has been removed. Does anyone know if this has been moved somewhere else? If this has been removed, why? How are we supposed to know about updates to the API, particularly new endpoints without this log?
Yes, that link gets me what I want. Thanks!
I agree, that was lame. Made sense to have that information along with the API documentation and code samples.
The Postman collection documented here, had become stale since our migration to Open API generated docs.
The Meraki API docs has an Export option, that allows you to get the latest generated Postman2 Collection based on the docs you are currently looking at.
You can also just use this link, which directly gives you the generated collection. You can then use that link or JSON to import into Postman as usual.
Yesterday, we used that exported collection to update the hand built version you are familiar with. The change log link has now been included at the top of that version, which points to the "What's new". These changes are now synchronized to the given API version, which is currently at 0.3.0.
(we were making so many enhancements to the API that writing them in the description became silly)
A few tips and tricks using the new collection:
The Collection folder, has environment variables pre-staged for you. These can be set at the Collection level or still be inherited from your Global Environment.
The API Key authorization is globally applied to all endpoint headers.
The endpoints now have all of the available options and descriptions pre-populated.
(NOTE: all of the options are currently on by default and may contain bogus values. Simply uncheck the param to clear it. In a near-term update we will set the params to be un-checked by default) -- FIXED when using https://postman.meraki.com
If you find any issues or have ways this can be improved, please let us know. The goal is to provide an up to date collection as often and accurately as possible.
I am all for improvements and for making things easier for users to use the API. However, for me these changes to the documentation on documenter.getpostman.com have removed my primary reference for the endpoint syntax. Yes, I am sure I can puzzle out what the endpoints do now that the nice descriptive names are gone and what is part of the endpoint path and what is a variable, but it shouldn't be that hard.
Now, I realize I am probably in the minority here, but updating things to make them easier to use in Postman does me no good because I don't use it. I looked at it when I started working with the API and couldn't figure out how to make it do what I needed, so I went back to basics and started writing code in a Python IDE. BTW, I also do not use the SDK, since I don't think it existed when I started with the API and I am not going to convert my 25+ scripts over to it without a really good reason.
Is there any site/page that simply has the endpoint syntax, data that will be returned, the parameters that can/need to be sent, and won't be disappearing in the next update?
@CBurkhead and all,
There was a bug with Postman Documentation that caused the parameter details and code examples to not render. A fix has been applied to the collection so that it shows properly.
Note, that the syntax examples will show values from your currently selected environment. This may be blank or you can choose to use your own environment if logged in or using the desktop application.