Generate openAPI documentation for segments APIs

• Type: Task
• Status: Closed
• Priority: Minor
• Resolution: Completed
• Affects Version/s: None
• Fix Version/s: None
• Component/s: Headless Delivery API, Segments Editor
• Labels:
  • Apr_'19
  • headless-opt-out
• Epic/Theme:
  • Segmentation
• Epic Link: tango-sp-dev-exp-using-headless-apis
• Sprint: SP | Sprint 9 | Mar6 - Mar15, SP | Sprint 11 | Apr1 - Apr12
• Git Pull Request: https://github.com/brianchandotcom/liferay-portal/pull/71532

Segment
SegmentUser

Related: --LPS-91104--

To generate documentation:

1. Deploy portal-tools-rest-builder
2. Deploy portal-vulcan
3. Deploy headless-foundation-impl
4. Access to: http://localhost:8080/o/<package-name>/v1.0/openapi.yaml to create the output API.
5. Copy the content to Swagger Editor

Note: This task is on hold until the new headless API naming has been defined.