search

seemethere / nba_py

Python client for NBA statistics located at stats.nba.com
BSD 3-Clause "New" or "Revised" License
1.05k stars 256 forks source link

Curious where the endpoint docs game from? #18

Closed bttmly closed 8 years ago

bttmly commented 8 years ago

This is fantastic https://github.com/seemethere/nba_py/wiki/stats.nba.com-Endpoint-Documentation

I'm developing an equivalent node package https://github.com/nickb1080/nba and I'm curious how you found the acceptable parameters for each endpoint. Given the highly dynamic nature of both Python and JavaScript, it would be a cool idea to put these endpoint docs in a simple machine-readable format (JSON?) and generate the API client and some documentation from it programmatically. This would really lower the barrier to developing NBA API clients in other languages, as well as decrease the ongoing cost of providing documentation. I may take a stab at that sometime soon, do you have any interest in taking a similar approach for this package? Thanks for the hard work!

bttmly commented 8 years ago

Something like this script, for example, could parse the markdown file into JSON https://gist.github.com/nickb1080/605c487ae72781ed17a6