How to apply separate SmartDocs models to different Developer Portal environments

The concept of Apigee Edge environments and Apigee Developer Portal environments is not exactly the same. While you can view each Edge environment in a single login to that corresponding Edge organization, in Developer Portal you must log in separately into each environment.

This is by design, but can sometimes lead to confusion, for example when trying to setup HBR templates for SmartDocs.

To apply a model to separate DevPortal environments, here are the steps. Note that the DevPortal environments and the Edge environments are not that same, so there is a bit of a manual process here.

First, get the .hbr files from each Apigee Edge environment You must do this for each environment (the naming conventions may vary if you have custom domains):

https://<ORG>-<ENV>.apigee.net/v1/organizations/<ORG>/apimodels/edge/templates?type=Method&name=smartdocs-hbr" -d @<ORG>-<ENV>-smartdocs-hbr.hbr

After running those in each Edge environment, you will have separate files for each, for example:

<ORG>-<ENV>-smartdocs-hbr.hbr

Next, login separately to each of your Devportal environments (the naming conventions may vary if you have custom domains):

http://dev-<ORG>.devportal.apigee.com/ 
http://test-<ORG>.devportal.apigee.com/ 
http://live-<ORG>.devportal.apigee.com/

For each of the above, follow the same process to apply the model, making sure to apply the one for the respective environment, following these steps:

http://docs.apigee.com/developer-services/content/using-smartdocs-document-apis#editingthesmartdocst...

I hope this helps. Thanks.

Version history
Last update:
‎03-31-2017 04:18 PM
Updated by: