Add API spec for change to /v2/services

[finishes #65704580]
Separate specs that generate api docs from the ones that do not

Signed-off-by: Abhijit Hiremagalur <abhi@pivotallabs.com>
Move rspec api docs templates into api/documentation as well

Signed-off-by: Abhijit Hiremagalur <abhi@pivotallabs.com>
API spec to exercise common functionality

Start with a simple example of pagination

Signed-off-by: Abhijit Hiremagalur <abhi@pivotallabs.com>
Add api spec that exercises sort order

Signed-off-by: Abhijit Hiremagalur <abhi@pivotallabs.com>
Remove extraneous line in spec

Signed-off-by: Eric Malm <emalm@pivotallabs.com>