Skip to content

Commit

Permalink
fix author name
Browse files Browse the repository at this point in the history
  • Loading branch information
ma91n committed May 17, 2024
1 parent 44d2da0 commit 441df16
Show file tree
Hide file tree
Showing 9 changed files with 25 additions and 25 deletions.
6 changes: 3 additions & 3 deletions articles/20240517a/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@
<meta property="og:locale" content="ja_JP">
<meta property="og:image" content="https://future-architect.github.io/images/20240517a/OpenAPI_Logo_Pantone-1.png">
<meta property="article:published_time" content="2024-05-16T15:00:00.000Z">
<meta property="article:modified_time" content="2024-05-17T00:41:03.540Z">
<meta property="article:modified_time" content="2024-05-17T00:53:52.957Z">
<meta property="article:tag" content="Swagger">
<meta property="article:tag" content="OpenAPI">
<meta name="twitter:card" content="summary">
Expand All @@ -53,7 +53,7 @@
<link rel="apple-touch-icon" sizes='57x57' href="/apple-touch-icon-57x57.png">
<link rel="canonical" href="https://future-architect.github.io/articles/20240517a/">
<meta content="Swagger,OpenAPI" name="keywords">
<meta content="Yutaro22" name="author">
<meta content="大寺祐太郎" name="author">
<link rel="preload" as="image" href="/banner.jpg" />
<link rel='manifest' href='/manifest.webmanifest'/>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.1/dist/css/bootstrap.min.css" integrity="sha384-F3w7mX95PdgyTmZZMECAngseQB83DfGTowi0iMjiWaeVhAn4FJkqJByhZMI3AhiU" crossorigin="anonymous">
Expand Down Expand Up @@ -101,7 +101,7 @@ <h2 itemprop="name" class="article-title">OpenAPI 3.0.3 と 3.1.0 どっち使
<ul class="blog-info">
<li class="blog-info-item"><a href="/articles/2024/" class="publish-date"><time datetime="2024-05-16T15:00:00.000Z" itemprop="datePublished">2024.05.17</time></a>
</li>
<li class="blog-info-item"><li><a href="/authors/Yutaro22" title="Yutaro22さんの記事一覧へ" class="post-author">Yutaro22</a></li></li>
<li class="blog-info-item"><li><a href="/authors/%E5%A4%A7%E5%AF%BA%E7%A5%90%E5%A4%AA%E9%83%8E" title="大寺祐太郎さんの記事一覧へ" class="post-author">大寺祐太郎</a></li></li>
<li class="blog-info-item">


Expand Down
4 changes: 2 additions & 2 deletions atom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<link href="https://future-architect.github.io/atom.xml" rel="self"/>

<link href="https://future-architect.github.io/"/>
<updated>2024-05-17T00:41:03.540Z</updated>
<updated>2024-05-17T00:53:52.957Z</updated>
<id>https://future-architect.github.io/</id>

<generator uri="https://hexo.io/">Hexo</generator>
Expand All @@ -16,7 +16,7 @@
<link href="https://future-architect.github.io/articles/20240517a/"/>
<id>https://future-architect.github.io/articles/20240517a/</id>
<published>2024-05-16T15:00:00.000Z</published>
<updated>2024-05-17T00:41:03.540Z</updated>
<updated>2024-05-17T00:53:52.957Z</updated>

<content type="html"><![CDATA[<img src="/images/20240517a/OpenAPI_Logo_Pantone-1.png" alt="" width="800" height="241"><p>Swaggerを使う事になり OpenAPIを触ってみると <code>3.0.3</code> と <code>3.1.0</code> が存在します。どちらを使うべきが悩んだので調べて整理してみました。<br><code>3.0.3</code> から <code>3.1.0</code> への変更点は過去のポストを参照ください。</p><ul><li>参考: <a href="https://future-architect.github.io/articles/20220622b/#v3-0%E3%80%81v3-1">Open API Specification 3.1と気になる仕様策定 </a></li></ul><h2 id="結論"><a href="#結論" class="headerlink" title="結論"></a>結論</h2><p>Amazon API Gateway を使い、<a href="https://docs.aws.amazon.com/ja_jp/apigateway/latest/developerguide/api-gateway-import-api.html">OpenAPIで定義されたAPI仕様書のインポート機能</a> を利用する場合は 3.0系( <code>3.0.3</code> )一択です。理由は単純に執筆時点では Amazon API Gateway が 3.1系 に対応してないからです。</p><p>また、VSCodeの拡張機能の中には <code>3.0.3</code> に対応しているものの <code>3.1.0</code> には未対応のものも多いようです。(決して <code>3.1.0</code> で書けないわけではないありません)</p><p><a href="https://github.com/42Crunch/vscode-openapi/issues/110">https://github.com/42Crunch/vscode-openapi/issues/110</a></p><p><a href="https://github.com/arjun-g/vs-swagger-viewer/issues/118">https://github.com/arjun-g/vs-swagger-viewer/issues/118</a></p><p>それ以外であれば <code>3.1.0</code> がオススメです。</p><h2 id="何が違うのか"><a href="#何が違うのか" class="headerlink" title="何が違うのか"></a>何が違うのか</h2><p>OpenAPI 3.0系は JSON Schemaの定義に一部従っていません。<code>nullable</code> が有名ですね。<code>nullable:true</code> って何だ?<sup id="fnref:1"><a href="#fn:1" rel="footnote">1</a></sup></p><blockquote><ul><li>OpenAPIv2.0: JSONスキーマの拡張サブセット。JSONスキーマDraft 4との互換性が約80%になる分岐があった</li><li>OpenAPIv3.0: JSONスキーマDraft 5との互換性が90%</li><li>OpenAPIv3.1: JSONスキーマDraft 2019-09と互換性が100%</li></ul></blockquote><p>※ 引用元:<a href="https://future-architect.github.io/articles/20220622b/#v3-0%E3%80%81v3-1">Open API Specification 3.1と気になる仕様策定#v3.0、v3.1</a></p><p>OpenAPI <code>3.1.0</code> では webhooksが追加され、typeで配列が使えるようになり nullを表現できるようになりました。この他にも exampleが廃止され examplesに変更となり書き方が違います。<sup id="fnref:2"><a href="#fn:2" rel="footnote">2</a></sup></p><h2 id="ちなみに-Amazon-API-Gateway-と-OpenAPI-3-0系でもまた違う"><a href="#ちなみに-Amazon-API-Gateway-と-OpenAPI-3-0系でもまた違う" class="headerlink" title="ちなみに Amazon API Gateway と OpenAPI 3.0系でもまた違う"></a>ちなみに Amazon API Gateway と OpenAPI 3.0系でもまた違う</h2><p>結論の補足として Amazon API Gateway は <a href="https://docs.aws.amazon.com/ja_jp/apigateway/latest/developerguide/models-mappings-models.html">JSONスキーマDraft 4</a>を使用してモデルを定義します。OpenAPI 3.0系とも違う仕様です。この違いにより OpenAPI 3.0系のAPI定義書で <code>nullable:true</code> と定義しても Amazon API Gatewayへ喰わせることは出来ないようです。</p><h2 id="さいごに"><a href="#さいごに" class="headerlink" title="さいごに"></a>さいごに</h2><p>OpenAPIを利用する際にそもそも何が問題なんだろう?と疑問を持ったのが記事を書くきっかけでした。<code>3.1.0</code> がオススメですがもし <code>3.0.3</code> を利用する場合には、前提として <code>nullable</code> を利用しないで <code>undefined</code> で統一する方針とした方が良いと思います。</p><ul><li>参考: <a href="https://future-architect.github.io/articles/20211028b/">OpenAPIにおけるundefinedとnullの設計 </a></li></ul><div id="footnotes"><hr><div id="footnotelist"><ol style="list-style:none; padding-left: 0;"><li id="fn:1"><span style="vertical-align: top; padding-right: 10px;">1.</span><span style="vertical-align: top;"><a href="https://github.com/OAI/OpenAPI-Specification/blob/main/proposals/2019-10-31-Clarify-Nullable.md">Clarify Semantics of nullable in OpenAPI 3.0</a></span><a href="#fnref:1" rev="footnote"> ↩</a></li><li id="fn:2"><span style="vertical-align: top; padding-right: 10px;">2.</span><span style="vertical-align: top;"><a href="https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0">Migrating from OpenAPI 3.0 to 3.1.0</a></span><a href="#fnref:2" rev="footnote"> ↩</a></li></ol></div></div>]]></content>

Expand Down
4 changes: 2 additions & 2 deletions authors/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -264,7 +264,7 @@ <h2 class="list-page">2024年の執筆者</h2>
<span class="author-list-count">1 件</span>
</li>
<li class="author-list-item">
<a class="author-list-link" href="/authors/Yutaro22">Yutaro22</a>
<a class="author-list-link" href="/authors/大寺祐太郎">大寺祐太郎</a>
<span class="author-list-count">1 件</span>
</li></ul>

Expand Down Expand Up @@ -2280,7 +2280,7 @@ <h2 class="list-page margin-top-50">全期間の執筆者</h2>
<span class="author-list-count">1 件</span>
</li>
<li class="author-list-item">
<a class="author-list-link" href="/authors/Yutaro22">Yutaro22</a>
<a class="author-list-link" href="/authors/大寺祐太郎">大寺祐太郎</a>
<span class="author-list-count">1 件</span>
</li>
<li class="author-list-item">
Expand Down
20 changes: 10 additions & 10 deletions authors/Yutaro22/index.html → authors/大寺祐太郎/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -25,16 +25,16 @@
https://www.future.co.jp/recruit/
-->

<title>Yutaro22 | フューチャー技術ブログ</title>
<title>大寺祐太郎 | フューチャー技術ブログ</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta content="width=device-width, initial-scale=1.0" name="viewport">

<meta name="description" content="Yutaro22 が執筆した記事一覧 | フューチャーの開発者による公式技術ブログです。業務で利用している技術を幅広く紹介します。">
<meta name="description" content="大寺祐太郎 が執筆した記事一覧 | フューチャーの開発者による公式技術ブログです。業務で利用している技術を幅広く紹介します。">
<meta property="og:type" content="website">
<meta property="og:title" content="Yutaro22 | フューチャー技術ブログ">
<meta property="og:url" content="https://future-architect.github.io/authors/Yutaro22/index.html">
<meta property="og:title" content="大寺祐太郎 | フューチャー技術ブログ">
<meta property="og:url" content="https://future-architect.github.io/authors/%E5%A4%A7%E5%AF%BA%E7%A5%90%E5%A4%AA%E9%83%8E/index.html">
<meta property="og:site_name" content="フューチャー技術ブログ">
<meta property="og:description" content="Yutaro22 が執筆した記事一覧 | フューチャーの開発者による公式技術ブログです。業務で利用している技術を幅広く紹介します。">
<meta property="og:description" content="大寺祐太郎 が執筆した記事一覧 | フューチャーの開発者による公式技術ブログです。業務で利用している技術を幅広く紹介します。">
<meta property="og:locale" content="ja_JP">
<meta property="og:image" content="https://future-architect.github.io/images/20240517a/thumbnail.png">
<meta name="twitter:card" content="summary">
Expand All @@ -47,9 +47,9 @@
<link rel="icon alternate" href="/favicon.ico">
<link rel="apple-touch-icon" sizes='180x180' href="/apple-touch-icon.png">
<link rel="apple-touch-icon" sizes='57x57' href="/apple-touch-icon-57x57.png">
<link rel="canonical" href="https://future-architect.github.io/authors/Yutaro22/">
<meta content="フューチャーアーキテクト,技術ブログ,ITコンサル,Yutaro22" name="keywords">
<meta content="Yutaro22" name="author">
<link rel="canonical" href="https://future-architect.github.io/authors/%E5%A4%A7%E5%AF%BA%E7%A5%90%E5%A4%AA%E9%83%8E/">
<meta content="フューチャーアーキテクト,技術ブログ,ITコンサル,大寺祐太郎" name="keywords">
<meta content="大寺祐太郎" name="author">
<link rel="preload" as="image" href="/banner.jpg" />
<link rel='manifest' href='/manifest.webmanifest'/>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.1/dist/css/bootstrap.min.css" integrity="sha384-F3w7mX95PdgyTmZZMECAngseQB83DfGTowi0iMjiWaeVhAn4FJkqJByhZMI3AhiU" crossorigin="anonymous">
Expand All @@ -73,10 +73,10 @@
<ul class="breadcrumb">
<li><a href="/">Home</a></li>
<li><a href="/authors">Authors</a></li>
<li class="active">Yutaro22</li>
<li class="active">大寺祐太郎</li>
</ul>
<section id="main" class="margin-top-30">
<h1 class="list-page">Yutaro22<span class="list-sub-text">さんのページ</span></h1>
<h1 class="list-page">大寺祐太郎<span class="list-sub-text">さんのページ</span></h1>
<ul class="summary">
<li><span class="summary-count">1</span><br><span class="summary-label">投稿</span></li>
<li><span class="summary-count">0</span><br><span class="summary-label">総シェア数</span></li>
Expand Down
2 changes: 1 addition & 1 deletion category-sitemap.xml
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@

<url>
<loc>https://future-architect.github.io/categories/Programming/</loc>
<lastmod>2024-05-17T00:41:03.540Z</lastmod>
<lastmod>2024-05-17T00:53:52.957Z</lastmod>
<changefreq>weekly</changefreq>
<priority>0.2</priority>
</url>
Expand Down
2 changes: 1 addition & 1 deletion post-sitemap.xml
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@

<url>
<loc>https://future-architect.github.io/articles/20240517a/</loc>
<lastmod>2024-05-17T00:41:03.540Z</lastmod>
<lastmod>2024-05-17T00:53:52.957Z</lastmod>
<changefreq>weekly</changefreq>
<priority>0.6</priority>

Expand Down
2 changes: 1 addition & 1 deletion rss2.xml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
<atom:link href="https://future-architect.github.io/rss2.xml" rel="self" type="application/rss+xml"/>

<description>フューチャーの開発者による公式技術ブログです。業務で利用している技術を幅広く紹介します。</description>
<pubDate>Fri, 17 May 2024 00:41:03 GMT</pubDate>
<pubDate>Fri, 17 May 2024 00:53:52 GMT</pubDate>
<generator>http://hexo.io/</generator>

<item>
Expand Down
6 changes: 3 additions & 3 deletions sitemap.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

<sitemap>
<loc>https://future-architect.github.io/post-sitemap.xml</loc>
<lastmod>2024-05-17T00:41:03.540Z</lastmod>
<lastmod>2024-05-17T00:53:52.957Z</lastmod>
</sitemap>

<sitemap>
Expand All @@ -14,12 +14,12 @@

<sitemap>
<loc>https://future-architect.github.io/category-sitemap.xml</loc>
<lastmod>2024-05-17T00:41:03.540Z</lastmod>
<lastmod>2024-05-17T00:53:52.957Z</lastmod>
</sitemap>

<sitemap>
<loc>https://future-architect.github.io/tag-sitemap.xml</loc>
<lastmod>2024-05-17T00:41:03.540Z</lastmod>
<lastmod>2024-05-17T00:53:52.957Z</lastmod>
</sitemap>

</sitemapindex>
Expand Down
4 changes: 2 additions & 2 deletions tag-sitemap.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,14 @@

<url>
<loc>https://future-architect.github.io/tags/OpenAPI/</loc>
<lastmod>2024-05-17T00:41:03.540Z</lastmod>
<lastmod>2024-05-17T00:53:52.957Z</lastmod>
<changefreq>weekly</changefreq>
<priority>0.2</priority>
</url>

<url>
<loc>https://future-architect.github.io/tags/Swagger/</loc>
<lastmod>2024-05-17T00:41:03.540Z</lastmod>
<lastmod>2024-05-17T00:53:52.957Z</lastmod>
<changefreq>weekly</changefreq>
<priority>0.2</priority>
</url>
Expand Down

0 comments on commit 441df16

Please sign in to comment.