Notes
A note about proposed endpoints: we’re no longer including proposed endpoints in the specification you see on the Developer Portal. We used to include these (suitably marked and labeled) as a way to communicate the details of proposed changes outside sprint reviews. Our new standard is that the OpenAPI specification will only reflect what’s currently available in the API.
A reminder that we changed naming conventions last sprint, so if you haven’t updated your endpoint and attribute names yet, have a look at our migration guide to get started.
This sprint we completed some behind the scenes work that will let us partially restrict access to different parts of the API, so that we can have users in the future who can use some endpoints but not others. This won’t affect any current API users, but will come into play with some future endpoints.
We made more progress toward the journals endpoint, but it’s still not ready for use yet. We’ll continue this into next sprint and hope to have a demo for you next time.
We’ve started work on two new endpoints: Awards and Award Lines. One Award can have one or more Award Lines, and each Award Line corresponds to one Grant. We’ll elaborate on this in future sprint reviews. For now, we’ve taken care of the incoming data part, and we’ll be working on presenting that data through the API for both of those endpoints in the next sprint.
You can now filter sales items by the groupItem field. Different campuses use this field in different ways, but if you’re familiar with the system your campus uses, you can use this filter to get just the sales items you’re interested in.
We published a new page on our website explaining the difference between cost centers and cost center hierarchies, which is a common confusion but an important difference for developers who interact with the API. We expect to update this in the future as more official guidance from ATP becomes available.
API changes
- Sales items can be filtered by groupItem
- Old deprecated journals endpoint (api.wisc.edu/finance/journals) removed