2.4 KiB
NHL API Documentation
Latest News
2024-11-02
The NHL has kindly provided us with a very handy (but ugly) file called application.wadl which documents their entire API. I have taken some time and written a python script (scripts/wadl-map.py) that automatically querries the endpoint that provides the file, converst the XML to JSON and parses it out in a simple but understandable format. The markdown file in the scripts folder provides an example of the output.
This is a work in progress - use it at your own discretion, eventually it will be updated to create a much nicer output, possibly even with markdown formatting and will eventually be setup on a website to auto-update every so often and provide browsable documentation that requires less maintenance than the hand-written documentation that exists now.
About this Project
This effort is purely to make it easier for stats nerds and the like to make use of the wonderful trove of information the NHL provides to us but in a much more digestible form.
Roadmap
Eventually build documentation on features such as cayenneExp which allows for retrieval of very complex documentation and perhaps even a more thorough set of documentation including examples in multiple common langages (such as using Swagger)
Files
| file | description |
|---|---|
| made-with.md | Collection of things made using the NHL API documentation, by no means exhaustive and zero affiliation with these projects. |
| misc.md | Random things the NHL API uses or is somehow related to |
| records-api.md | Documentation on the API for records.nhl.com |
| stats-api.md | The one, the only NHL API (stats) documentation! |
| new-api.md | New 2023 NHL API (stats) documentation |
Contributing
I am only one person so if you see something I have missed please feel free to open up a MR/PR and I will get it merged. Generally speaking I get things done in a few days as time permits between work and other obligations.
Contact
Generally I am reached via Twitter @dw0rd4
Acknowledgements
Kevin Sidwar - First real source of documentation I found on the API and gave me a nice starting point for a project that eventually evolved into this repository
Jon Ursenbach - Built out an OpenAPI 3 spec for the NHL API