"number" is an very ambiguous term. Integral or non-integral?
long should be used, as opposed to a
It would be helpful if values that can be non-integral were more clearly indicated.
Yes, I understand that you are returning a "number" in JSON, so technically the spec is correct. But what good does that do your audience?
Should I make every object field and database column a float so it doesn't break unexpectedly because I guessed wrong what datatype I should use? Sure, I can guess, and in most cases guess correctly, but is that really the best thing possible?
"number" is of questionable value to all but the most trivial applications of the API, and downgrading the spec because of the limitations of transport is a mistake in my opinion.