5/9/2014 1:08:57 PM
Apigee SmartDocs Provides Developers Method level API Documentation
App Developer Magazine

Apigee SmartDocs Provides Developers Method level API Documentation

Richard Harris Richard Harris in Enterprise Friday, May 9, 2014

Apigee, which provides API management solutions, has introduced SmartDocs, a method-level API documentation that offers both internal and external SEO benefits. 

API providers can generate docs by leveraging handlebars-driven templates, test the accuracy of their documentation with live requests, and control the layout, interactions, and look of docs. App developers can make API requests without leaving the page, work faster as SmartDocs learns the parameter values developers like to use, and benefit from accurate, model-driven documentation.

SmartDocs features include:

Method-level detail: Every method of an API gets its own page of documentation. This gives space to describe the behavior of that method in detail. Not only does that help provide necessary information to developers, the documentation itself is indexed, which brings SEO benefits to internal (portal) search results as well as external search results.

Interactive requests: Developers can send requests without leaving docs. SmartDocs guides developers to build well-formed requests and to sign them with their credentials. This helps minimize a crucial adoption metric - time to first request. And because writers can test their work in-situ, it should improve the accuracy of documentation.

Docs that learn: SmartDocs remembers the values that each developer uses for subsequent requests. This makes SmartDocs a tool that gets better the more it is used and it helps developers move faster.

Easy to maintain: Developers have complete control over the layout, interactions, and look and feel. Plus, in-line editing allows the ability to change what is see, right from the generated docs.

To learn more, Apigee provides SmartDocs introduction documentation. SmartDocs (in beta) supports OAuth 2.0's webserver flow, custom token authentication (API keys), and HTTP basic authentication. With a developer portal and an existing description of services in Swagger or WADL (as used by Apigee API consoles) format, SmartDocs can be published in as little as 10-15 minutes.

Read more: https://blog.apigee.com/detail/apigee_smartdocs_in...

475 Tax Deductions for Businesses and Self-Employed Individuals

Are you paying more taxes than you have to as a developer or freelancer? The IRS is certainly not going to tell you about a deduction you failed to take, and your accountant is not likely to take the time to ask you about every deduction you’re entitled to. As former IRS Commissioner Mark Everson admitted, “If you don’t claim it, you don’t get it.

A hands-on guide to mastering mobile forensics for iOS and Android

Get hands-on experience in performing simple to complex mobile forensics techniques Retrieve and analyze data stored not only on mobile devices but also through the cloud and other connected mediums A practical guide to leveraging the power of mobile forensics on popular mobile platforms with lots of tips, tricks, and caveats.

Gps tracker for kids

The Chirp GPS app is a top-ranked location sharing app available for Apple and Android that is super easy to use, and most of all, it's reliable.

The Latest Nerd Ranch Guide (3rd Edition) to Android Programming

Write and run code every step of the way, using Android Studio to create apps that integrate with other apps, download and display pictures from the web, play sounds, and more. Each chapter and app has been designed and tested to provide the knowledge and experience you need to get started in Android development.