Validate frontend app response

doc the actual arguments too, like here:
https://github.com/openshift/origin/blob/master/hack/util.sh#L11

(we've been bitten before by people not understanding the args a function took, so i've gotten picky about this)