The SmartDocs Install and Usage Page page provides tutorial that explans how to
The REST API services module for key functionality to enable CI/CD for OpenAPI-based DevPortal workflow.
The project is a distributed hackaton amongst YL, DC, and GK to come up with a PoC for OpenAPI-based CI set of processes.
Right now we are dealing with a mix of problems that deny smooth out-of-the-box experince.
Amongst them couple of minor nuisances:
bugs in OpenAPI (a.k.a. swagger) import process (default number type values is not passed to a smartdocs json model, Edge java code)
This problem can be alleviated using Management API to access and manipulate SmartDocs model.json.
For additonal details, see http://docs.apigee.com/developer-services/content/using-smartdocs-document-apis.
bugs in SmartDocs rendered theme (model.js; default values are not rendered in a sample datagram, /v6/model.js in drupal theme)
See here on how to patch it.
Current DevPortal/SmartDoc solution is powerful and flexible.
The principle and components are right and all the correct moving parts are in place. It's just there is a learning curve to to be able to harness this power.
As the ultimate goal is a Look & Feel, we can augment current process to overcome its implementation limitations.
Deliverables:
Features of an alternative Apigee out-of-the-box Theme:
api page: amadeus left side https://sandbox.amadeus.com/travel-innovation-sandbox/apis/get/location/%7Bcode%7D
api page: payeasy center and right sides http://dev-payeezy.devportal.apigee.com/payeezy-api/apis/post/transactions-11
more options for advanced branding customization; http://docs.apigee.com/developer-services/content/using-smartdocs-document-apis
[x] post action/drupal services module
[x] form file field
[x] form actions
[x] support of swagger yaml and json file formats
[ ] create model
[x] import swagger file
[x] render and publish
[x] REFACTOR: into model/controller, functions
[ ] REFACTOR: pipe file object from import to render function
[x] add 'import OpenAPI specification' permission
[ ] _install hook. do we need it?
[x] wrap it up as an drupal module
[x] Developer quick start doc
[x] User access documentation
[x] Test against pantheon devportal instance
Install and enable Services drupal module and REST server\ drush dl services\ drush en services\ drush en rest_server\
copy smartdocs_service folder into /var/www/html/sites/all/modules
Refresh and switch on SmartDocs service module.
Configure endpoint
Run request \ http://192.168.56.102/devportal/smartdocs/render?name=yyy
Look at the Report/Recent Log Messages for the watchdog() output
Look at the /var/log/httpd for server and devportal errors (including php syntax errors)
NOTE: make sure your Endpoint Authenticated User can connect (Configuration/DevPortal)
https://community.apigee.com/articles/26982/smartdocs-default-values-from-request-body-schema.html
https://www.dinochiesa.net/?p=1297\ https://www.dinochiesa.net/?p=1331\ https://www.dinochiesa.net/?p=1345\