はてなブックマークアプリ

サクサク読めて、
アプリ限定の機能も多数!

アプリで開く

はてなブックマーク

  • はてなブックマークって?
  • アプリ・拡張の紹介
  • ユーザー登録
  • ログイン
  • Hatena

はてなブックマーク

トップへ戻る

  • 総合
    • 人気
    • 新着
    • IT
    • 最新ガジェット
    • 自然科学
    • 経済・金融
    • おもしろ
    • マンガ
    • ゲーム
    • はてなブログ(総合)
  • 一般
    • 人気
    • 新着
    • 社会ニュース
    • 地域
    • 国際
    • 天気
    • グルメ
    • 映画・音楽
    • スポーツ
    • はてな匿名ダイアリー
    • はてなブログ(一般)
  • 世の中
    • 人気
    • 新着
    • 新型コロナウイルス
    • 働き方
    • 生き方
    • 地域
    • 医療・ヘルス
    • 教育
    • はてな匿名ダイアリー
    • はてなブログ(世の中)
  • 政治と経済
    • 人気
    • 新着
    • 政治
    • 経済・金融
    • 企業
    • 仕事・就職
    • マーケット
    • 国際
    • はてなブログ(政治と経済)
  • 暮らし
    • 人気
    • 新着
    • カルチャー・ライフスタイル
    • ファッション
    • 運動・エクササイズ
    • 結婚・子育て
    • 住まい
    • グルメ
    • 相続
    • はてなブログ(暮らし)
    • 掃除・整理整頓
    • 雑貨
    • 買ってよかったもの
    • 旅行
    • アウトドア
    • 趣味
  • 学び
    • 人気
    • 新着
    • 人文科学
    • 社会科学
    • 自然科学
    • 語学
    • ビジネス・経営学
    • デザイン
    • 法律
    • 本・書評
    • 将棋・囲碁
    • はてなブログ(学び)
  • テクノロジー
    • 人気
    • 新着
    • IT
    • セキュリティ技術
    • はてなブログ(テクノロジー)
    • AI・機械学習
    • プログラミング
    • エンジニア
  • おもしろ
    • 人気
    • 新着
    • まとめ
    • ネタ
    • おもしろ
    • これはすごい
    • かわいい
    • 雑学
    • 癒やし
    • はてなブログ(おもしろ)
  • エンタメ
    • 人気
    • 新着
    • スポーツ
    • 映画
    • 音楽
    • アイドル
    • 芸能
    • お笑い
    • サッカー
    • 話題の動画
    • はてなブログ(エンタメ)
  • アニメとゲーム
    • 人気
    • 新着
    • マンガ
    • Webマンガ
    • ゲーム
    • 任天堂
    • PlayStation
    • アニメ
    • バーチャルYouTuber
    • オタクカルチャー
    • はてなブログ(アニメとゲーム)
    • はてなブログ(ゲーム)
  • おすすめ

    猛暑に注意を

『API Documentation & Design Tools for Teams | Swagger』

  • 人気
  • 新着
  • すべて
  • Components Section

    3 users

    swagger.io

    Often, multiple API operations have some common parameters or return the same response structure. To avoid code duplication, you can place the common definitions in the global components section and reference them using $ref. In the example below, duplicate definitions of a User object are replaced with a single component and references to that component. Before: paths: /users/{userId}: get: summa

    • 暮らし
    • 2021/06/25 10:17
    • Links

      3 users

      swagger.io

      Links are one of the new features of OpenAPI 3.0. Using links, you can describe how various values returned by one operation can be used as input for other operations. This way, links provide a known relationship and traversal mechanism between the operations. The concept of links is somewhat similar to hypermedia, but OpenAPI links do not require the link information present in the actual respons

      • 学び
      • 2019/08/12 22:54
      • Describing Responses

        3 users

        swagger.io

        An API specification needs to specify the responses for all API operations. Each operation must have at least one response defined, usually a successful response. A response is defined by its HTTP status code and the data returned in the response body and/or headers. Here is a minimal example:

        • 学び
        • 2019/08/12 22:45
        • Data Types

          8 users

          swagger.io

          The data type of a schema is defined by the type keyword, for example, type: string. OpenAPI defines the following basic types: string (this includes dates and files) number integer boolean array object These types exist in most programming languages, though they may go by different names. Using these types, you can describe any data structures. Note that there is no null type; instead, the nullab

          • テクノロジー
          • 2019/01/25 13:31
          • swagger
          • Adding Examples | Swagger

            4 users

            swagger.io

            You can add examples to parameters, properties and objects to make OpenAPI specification of your web service clearer. Examples can be read by tools and libraries that process your API in some way. For example, an API mocking tool can use sample values to generate mock requests. You can specify examples for objects, individual properties and operation parameters. To specify an example, you use the

            • テクノロジー
            • 2018/12/09 17:51
            • Describing Parameters

              3 users

              swagger.io

              Note that parameters is an array, so, in YAML, each parameter definition must be listed with a dash (-) in front of it. Parameter Types Swagger distinguishes between the following parameter types based on the parameter location. The location is determined by the parameter’s in key, for example, in: query or in: path. query parameters, such as /users?role=admin path parameters, such as /users/{id}

              • テクノロジー
              • 2018/05/21 19:18
              • Adding Examples

                3 users

                swagger.io

                An API specification can include examples for: response MIME types, schemas (data models), individual properties in schemas. Examples can be used by tools and libraries, for instance, Swagger UI auto-populates request bodies based on input schema examples, and some API mocking tools use examples to generate mock responses. Note: Do not confuse example values with the default values. An example is

                • テクノロジー
                • 2018/04/06 13:36
                • oneOf, anyOf, allOf, not

                  4 users

                  swagger.io

                  OpenAPI 3.0 provides several keywords which you can use to combine schemas. You can use these keywords to create a complex schema, or validate a value against multiple criteria. oneOf – validates the value against exactly one of the subschemas allOf – validates the value against all the subschemas anyOf – validates the value against any (one or more) of the subschemas Besides these, there is a not

                  • テクノロジー
                  • 2018/03/23 20:33
                  • Authentication

                    4 users

                    swagger.io

                    OpenAPI uses the term security scheme for authentication and authorization schemes. OpenAPI 3.0 lets you describe APIs protected using the following security schemes: HTTP authentication schemes (they use the Authorization header): Basic Bearer other HTTP schemes as defined by RFC 7235 and HTTP Authentication Scheme Registry API keys in headers, query string or cookies Cookie authentication OAuth

                    • テクノロジー
                    • 2018/03/14 19:20
                    • Bearer Authentication

                      4 users

                      swagger.io

                      Bearer authentication (also called token authentication) is an HTTP authentication scheme that involves security tokens called bearer tokens. The name “Bearer authentication” can be understood as “give access to the bearer of this token.” The bearer token is a cryptic string, usually generated by the server in response to a login request. The client must send this token in the Authorization header

                      • テクノロジー
                      • 2018/03/02 11:43
                      • API Exploration with API Hub - Formerly SwaggerHub Explore

                        4 users

                        swagger.io

                        Explore Every API Has a Story. Find Yours. Seamlessly explore, validate, and integrate multi-protocol APIs to accelerate development, enhance collaboration, and ensure reliable delivery. API Exploration Effortlessly discover and evaluate APIsEasily connect to multi-protocol APIs through a user-friendly interface integrated with API Hub for seamless API exploration and reliable integrations. Simpli

                        • テクノロジー
                        • 2018/01/10 21:24
                        • What Is OpenAPI?

                          6 users

                          swagger.io

                          OpenAPI Specification (formerly Swagger Specification) is an API description format for REST APIs. An OpenAPI file allows you to describe your entire API, including: Available endpoints (/users) and operations on each endpoint (GET /users, POST /users) Operation parameters Input and output for each operation Authentication methods Contact information, license, terms of use, and other information.

                          • テクノロジー
                          • 2017/11/02 19:58
                          • あとで読む
                          • Describing Parameters

                            4 users

                            swagger.io

                            Note that parameters is an array, so, in YAML, each parameter definition must be listed with a dash (-) in front of it. Parameter Types OpenAPI 3.0 distinguishes between the following parameter types based on the parameter location. The location is determined by the parameter’s in key, for example, in: query or in: path. path parameters, such as /users/{id} query parameters, such as /users?role=ad

                            • テクノロジー
                            • 2017/11/02 19:34
                            • API Code & Client Generator | Swagger Codegen

                              4 users

                              swagger.io

                              Swagger Codegen Swagger Codegen can simplify your build process by generating server stubs and client SDKs for any API, defined with the OpenAPI (formerly known as Swagger) specification, so your team can focus better on your API’s implementation and adoption. Download SmartBear Named a Leader by Gartner® in the 2024 Magic Quadrant™ for API Management Generate Servers Remove tedious plumbing and c

                              • テクノロジー
                              • 2017/11/01 14:01
                              • open api
                              • swagger
                              • documentation
                              • api
                              • development
                              • Using $ref

                                4 users

                                swagger.io

                                When you document an API, it is common to have some features which you use across several of API resources. In that case, you can create a snippet for such elements in order to use them multiple times when you need it. With OpenAPI 3.0, you can reference a definition hosted on any location. It can be the same server, or another one – for example, GitHub, SwaggerHub, and so on. To reference a defin

                                • テクノロジー
                                • 2017/09/15 12:21
                                • The New Swagger Editor and UI Are Finally Here!

                                  5 users

                                  swagger.io

                                  The Swagger framework changed the software landscape forever, allowing APIs to be described in a common language (the OpenAPI Specification) that every human and machine involved in the lifecycle can understand, work and integrate with. While the specification is the core of the framework, there is an entire toolchain around it to enhance the API development process. The most popular and fundament

                                  • テクノロジー
                                  • 2017/03/24 14:49
                                  • swagger
                                  • Getting Started with OpenAPI Tools | Swagger Open Source

                                    3 users

                                    swagger.io

                                    What is Swagger? If you’ve ever worked with APIs, chances are, you’ve heard of Swagger. Swagger is the most widely used tooling ecosystem for developing APIs with the OpenAPI Specification (OAS). Swagger consists of both open source as well as professional tools, catering to almost every need and use case. A Brief History Lesson Swagger used to consist of the specification and a large ecosystem of

                                    • テクノロジー
                                    • 2016/06/12 23:43
                                    • tutorial
                                    • SwaggerHub | API Design & Documentation Tool

                                      11 users

                                      swagger.io

                                      NEWSwaggerHub for Teams - New low price! The Single Source of Truth for API Development Accelerating API delivery and quality through standards and collaboration with OpenAPI and AsyncAPI. Create Free Account Join thousands of teams who depend on SwaggerHub to get their products to market, faster

                                      • テクノロジー
                                      • 2016/05/27 08:30
                                      • Swagger
                                      • api
                                      • design
                                      • swaggerhub
                                      • API Editor - Download or Try it in the Cloud

                                        4 users

                                        swagger.io

                                        Swagger Editor Design, describe, and document your API on the first open source editor supporting multiple API specifications and serialization formats. The Swagger Editor offers an easy way to get started with the OpenAPI Specification (formerly known as Swagger) as well as the AsyncAPI specification, with support for Swagger 2.0, OpenAPI 3.*, and AsyncAPI 2.* versions.

                                        • テクノロジー
                                        • 2015/12/21 11:39
                                        • Java Integration | Swagger Open Source

                                          8 users

                                          swagger.io

                                          Tools and Integrations Here you can find a list of libraries and frameworks serving the Swagger ecosystem. The main list consists of tools that provide support for the latest Swagger 2.0. Below, you can find a list of tools that have not yet been updated. Swagger-Group Projects These are the projects that were created by the same people who authored the Swagger Specification: Name Main Purpose Des

                                          • テクノロジー
                                          • 2015/11/24 17:23
                                          • REST API Documentation Tool | Swagger UI

                                            8 users

                                            swagger.io

                                            Swagger UI Swagger UI allows anyone — be it your development team or your end consumers — to visualize and interact with the API’s resources without having any of the implementation logic in place. It’s automatically generated from your OpenAPI (formerly known as Swagger) Specification, with the visual documentation making it easy for back end implementation and client side consumption. Live Demo

                                            • テクノロジー
                                            • 2015/11/10 20:33
                                            • OpenAPI Specification | Swagger

                                              42 users

                                              swagger.io

                                              OpenAPI Specification Version 3.1.1 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 RFC2119 RFC8174 when, and only when, they appear in all capitals, as shown here. This document is licensed under The Apache License, Version 2.0. Introduc

                                              • テクノロジー
                                              • 2015/09/02 19:27
                                              • swagger
                                              • OpenAPI
                                              • API
                                              • web制作
                                              • *OpenAPI
                                              • API Documentation & Design Tools for Teams | Swagger

                                                290 users

                                                swagger.io

                                                Swagger places API specifications such as OpenAPI, AsyncAPI, and JSON Schema at the core of its architecture, which are crucial for guiding teams through the entire lifecycle of API design and documentation. This strategic focus ensures that our suite, including open source tools and API Hub, delivers unparalleled efficiency and a seamless user experience. Explore the API Specifications Discover t

                                                • テクノロジー
                                                • 2014/09/22 12:42
                                                • api
                                                • swagger
                                                • REST
                                                • documentation
                                                • RESTful
                                                • document
                                                • development
                                                • framework
                                                • webservice
                                                • Service

                                                このページはまだ
                                                ブックマークされていません

                                                このページを最初にブックマークしてみませんか?

                                                『API Documentation & Design Tools for Teams | Swagger』の新着エントリーを見る

                                                キーボードショートカット一覧

                                                j次のブックマーク

                                                k前のブックマーク

                                                lあとで読む

                                                eコメント一覧を開く

                                                oページを開く

                                                はてなブックマーク

                                                • 総合
                                                • 一般
                                                • 世の中
                                                • 政治と経済
                                                • 暮らし
                                                • 学び
                                                • テクノロジー
                                                • エンタメ
                                                • アニメとゲーム
                                                • おもしろ
                                                • アプリ・拡張機能
                                                • 開発ブログ
                                                • ヘルプ
                                                • お問い合わせ
                                                • ガイドライン
                                                • 利用規約
                                                • プライバシーポリシー
                                                • 利用者情報の外部送信について
                                                • ガイドライン
                                                • 利用規約
                                                • プライバシーポリシー
                                                • 利用者情報の外部送信について

                                                公式Twitter

                                                • 公式アカウント
                                                • ホットエントリー

                                                はてなのサービス

                                                • はてなブログ
                                                • はてなブログPro
                                                • 人力検索はてな
                                                • はてなブログ タグ
                                                • はてなニュース
                                                • ソレドコ
                                                • App Storeからダウンロード
                                                • Google Playで手に入れよう
                                                Copyright © 2005-2025 Hatena. All Rights Reserved.
                                                設定を変更しましたx