Apigee documentation enhancements - July 2016

[jonesfloyd]

In addition to many bug fixes, responses to enhancement requests, and other content updates, following are some of the key documentation enhancements over the past few months.

And as always, here’s how to send us doc feedback: https://community.apigee.com/articles/10274/sending-feedback-on-apigee-documentation.html

Edge for Private Cloud

• Private Cloud documentation is now in the cloud, starting with the 4.16.05 release: http://docs.apigee.com/api-services/content/version-41605
• Private Cloud 4.16.01 and 4.16.05 docs include a new streamlined installation process
  

AWS and Pivotal Cloud Foundry integration docs

• http://docs.apigee.com/api-services/content/edge-integration-aws
• http://docs.apigee.com/api-services/content/edge-integration-pivotal-cloud-foundry
  

Tutorials, examples, getting started

• New samples
  http://docs.apigee.com/api-services/samples/samples-reference#sampleapiproxies-new
  
  • Regular expression threat protection
  • OAuth password grant type
  • A proxy to try out conditional pattern matching
• Updated tutorials
  Tutorials have been refactored to replace the Yahoo! Weather API with a new homegrown Apigee target, http://mocktarget.apigee.net.
  • http://docs.apigee.com/tutorials/add-and-configure-your-first-api
  • http://docs.apigee.com/tutorials/add-policies-your-api
  • http://docs.apigee.com/tutorials/secure-calls-your-api-through-api-key-validation
  • http://docs.apigee.com/tutorials/secure-calls-your-api-through-oauth-20-client-credentials
• New tutorials
  • Proxy a SOAP service: http://docs.apigee.com/tutorials/proxy-soap-service
  • Create an API proxy from an OpenAPI spec: http://docs.apigee.com/tutorials/create-api-proxy-openapi-spec
  • Create an API BaaS collection: http://docs.apigee.com/tutorials/create-collection
  • A new “Open tutorial narrow” option a tutorial in a narrow window, letting you follow the tutorial while working side by side with the UI.
• Creating an account
  Enhanced documentation on creating an Apigee account: http://docs.apigee.com/api-services/content/creating-apigee-edge-account
• StreetCarts API
  The StreetCarts API, homegrown on Edge with API BaaS, is a deployable reference implementation that illustrates many traffic management and security features available in Edge: http://docs.apigee.com/api-services/samples/samples-reference#streetcarts
  

API development

• Edge Microgateway 2.0: http://docs.apigee.com/microgateway/content/edge-microgateway-home
• Proxy chaining
  • http://docs.apigee.com/api-services/content/connecting-proxies-other-proxies
  • http://docs.apigee.com/api-services/reference/service-callout-policy#localtargetconnection
• Policy updates
  • Quota: Seconds isn’t supported as a time unit. Removed “seconds” as a time unit option; removed PreciseAtSecondsLevel element from topic.New samples videos (Intro and Dynamic Quota):http://docs.apigee.com/api-services/reference/quota-policy
  • Service Callout: Added info on getting HTTP message properties natively from the Service Callout using variables. This means you don't need to use the Assign Message policy to set/get message variables from the Service Callout portion of an API call.
  • Key Value Maps - Two new examples showing PUT/GET using literal name values
  • Assign Message and Raise Fault: updated info about sending JSON payloads that contain variables. You no longer need an escape backslash before the opening curly brace.
    

Monetization

New content for monetization features, including:

• Testing your monetization setup: http://docs.apigee.com/monetization/content/testing-monetization
• Migrating developers to monetization: http://docs.apigee.com/monetization/content/migrating-developers-monetization
• Limit notifications on rate plans: http://docs.apigee.com/monetization/content/create-limit-notification-rate-plan
• Notifications on combined transaction totals for a company: http://docs.apigee.com/monetization/content/combine-rate-plan-transaction-totals-company-and-its-dev...
• Viewing transaction status: http://docs.apigee.com/monetization/content/testing-monetization#viewingthestatusoftransactions
• Unsuspending developers: http://docs.apigee.com/monetization/content/unsuspend-developers
  

Blogs & community

• Blog post on developing custom plugins for Edge Microgateway: http://apigee.com/about/blog/developer/tutorial-writing-custom-transform-plugin-apigee-edge-microgat...
• StreetCarts API project: https://community.apigee.com/articles/24968/authentication-and-authorization-with-edge-and-api.html