Add API details section to graduation spec

Add a new section to the graduation spec template based on markmc's
feedback on
https://review.openstack.org/#/c/97315/3/specs/juno/graduate-serialization.rst

Change-Id: I1d92c3237ec43285f74adcf23e3ed87972b7965c
Merge "Add API details section to graduation spec"