documents json format in README, and handler now enforces an array constraint