Github/nhlapi
1
0
Fork 0
mirror of https://gitlab.com/dword4/nhlapi synced 2024-12-23 09:37:34 +00:00
Code Issues Projects Releases Wiki Activity
Documenting the publicly accessible portions of the NHL API
123 Commits 6 Branches 0 Tags 1.7 MiB
Python 100%
91c6d20cb2
Go to file
Drew Hynes 91c6d20cb2 updated openapi.yaml to new API
2024-11-07 16:10:21 +00:00
scripts updated a bunch of things and cleaned up script output file 2024-11-03 01:10:49 +00:00
swagger updated openapi.yaml to new API 2024-11-07 16:10:21 +00:00
.gitlab-ci.yml switched to using npx 2023-11-09 14:53:21 +00:00
LICENSE Add LICENSE 2019-06-24 17:28:48 +00:00
made-with.md update made-with.md to include rotorink 2023-11-08 00:09:26 +00:00
misc.md made-with cleanup, added misc and updated README 2021-06-18 22:29:04 -04:00
new-api.md Merge branch 'master' into 'master' 2024-10-17 18:56:28 +00:00
README.md updated a bunch of things and cleaned up script output file 2024-11-03 01:10:49 +00:00
records-api.md Added list of team logos as "infinite res" SVGs for all teams and franchises going back to 1917...Yes, it includes the Montreal Wanderers. 2019-09-29 12:06:54 +00:00
stats-api.md various stylistic changes 2023-08-17 17:34:44 -06:00

README.md

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