このコンテンツは選択した言語では利用できません。

Chapter 1. Add Your Spec To 3scale


By the end of the section, you will have ActiveDocs set up for your API.

3scale offers a framework to create interactive documentation for your API.

With Swagger 2.0 (based on the Swagger Spec) you will have functional, attractive documentation for your API, which will help your developers to explore, to test and integrate with your API.

Every minute spent making your developers happy is a minute well invested on your API.

1.1. Step 1: Navigate to service specs in ActiveDocs

Navigate to the API ActiveDocs tab in your Admin Portal. This will lead you to the list of your service specs (initially empty).

List of Service Specs in ActiveDocs

You can add as many service specs as you want. Typically, each service spec corresponds to one of your APIs. For instance, at 3scale we have four different specs, one for each API of 3scale: Service Management, Account Management, Analytics, and Billing.

1.2. Step 2: Create a service spec

When you add a new service spec, you will have to provide:

  • Name
  • System name (required to reference the Servcie Spec from the Developer Portal)
  • Whether you want the spec to be public or not
  • A description that is only meant for your own consumption
  • API JSON spec, which you can see in the figure below.

The API JSON spec is the "secret ingredient" of ActiveDocs.

You must generate the specification of your API according to the spec proposed by Swagger. In this tutorial we assume that you already have a valid Swagger 2.0-compliant specification of your API.

Create a Service Spec for ActiveDocs

1.3. Step 3: You got your first Swagger 2.0!

Once you’ve added your first API on ActiveDocs by adding a service spec, you can see it listed in the API ActiveDocs tab. You can edit it as necessary, delete it, or switch it from public to private.

List of Service Specs for ActiveDocs

You can also preview what your ActiveDocs looks like by clicking on the name you gave the service spec (in the example it was called it Pet Store). You can do this even if the spec is not public yet.

This is what your ActiveDoc will look like:

ActiveDocs New Spec View
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.