APIv3.rest: goals tweaked using input colleagues

dmajda and cornelius.
APIv3: Means section expanded a bit
APIv3: added Specifications section
APIv3: added Further Reading section