はじめに フロントエンド開発において、効率的かつ一貫性のあるモック生成は非常に重要です。本記事では TypeSpec、Orval、Storybook の 3 つのツールを使用して自動生成でモックを実現する方法を紹介します。 TypeSpec は、大規模な API を提供するために Microsoft が開発し、使用している新しい API 記述言語です。 Orval は、OpenAPI 仕様から TypeScript のクライアントコードを生成するツールです。これにより、最新の API 仕様に基づいたクライアントコードを常に保持し、API との通信がスムーズに行えるようになります。 Storybook は、コンポーネントを独立して開発・テストするためのインタラクティブなツールです。コンポーネントの見た目や動作を個別に確認できるため、UI の一貫性を保ちながら効率的に開発を進めることができます
JX通信社の CTO の小笠原(@yamitzky)です。本日は、最近社内で検証している API クライアントの「Insomnia」や、Insomnia を活用したチームでの API 開発の効率化についてご紹介します。 Insomnia とは Insomnia は、オープンソースの API クライアントです。API 通信を GUI で直感的に検証・保存できる、というのが最も基本的な機能です。似たようなツールだと Postman などが有名だと思います。 insomnia.rest Insomnia は一般的な REST API だけでなく、GraphQL や gRPC の API にも対応したツールです。JX通信社では、NewsDigest や FASTALERT などのサービスで GraphQL を活用しているため、GraphQL にネイティブ対応しているのは非常に便利です。 Insom
この課題に取り組んだ背景 現在、弊社の自社開発でよく多様しているのが、フロントエンドはReact、バックエンドはnodejsを使用しREST API + SPAの構成でシステムを開発しています。 その際、フロントエンドとバックエンドでエンジニアがそれぞれいるのですが、同時に開発を進めようとすると、API仕様の認識のずれや、サーバーが開発途中だとフロント側のデータ取得・表示部分をどうしようかなどで悩むことがあります。 そこで今回はAPIの仕様書を簡単に作成できるSwaggerを使用し、そこから更にモックサーバーまで建てて、開発効率を上げていきたいと思います。 今回使用した技術・ツールたちの紹介 名前 用途
Xamarin.Forms で漢字交じりの文字列からふりがなを取得する為に Yahoo API を使用していますが、その API のバージョンが上がり、アプリ側の実装方法も変更しなければいけませんでした。今回はバージョン２での実装方法についてご紹介いたします。Android と iOS で共通して使用ができます。 尚、ふりがなの取得に Yahoo API を採用した経緯や、API v1 の実装方法につきましては、前回の記事「漢字のふりがなを取得する方法 -Yahoo REST API v1-」をご参考ください。 前提条件 ・Windows10 Pro 64Bit 1903 ・Visual Studio 2019 Community v16.11.7 ・Xamarin 16.11.000.197 (NuGet Xamarin.Forms 4.6.0.1141) ・macOS Monterey
deviseでトークン認証を実装する機会があり、その時にdevise-token-authを読みながら翻訳したものです。 以下翻訳↓ インストール Gemfileに以下を追加してください： gem 'devise_token_auth' そしたら、bundleを使ってgemをインストールします bundle install 次は設定... 設定 userモデルを作成し、ルーティングを定義し、concernsをincludeする必要があるでしょう、そしてこのgemのデフォルトのいくつかの設定を変更することができます。 rails g devise_token_auth:install [USER_CLASS] [MOUNT_PATH] 例： rails g devise_token_auth:install User auth このジェネレーターは次の任意のオプションを許可します： 引数 デ
Moya is a Swift Network Abstraction Library. It provides us with an abstraction to make network calls without directly communicating with Alamofire. With this tutorial we will learn how to get started with the framework, discover some tips & tricks and learn all basics from code examples. Why Moya?Let’s firstly discuss why NOT Moya: It introduces a dependency to your project. Your project’s succes
関連記事 WebTransport over QUICのサンプルサーバを試してみる - ASnoKaze blog WebTransport over HTTP/2 の仕様について - ASnoKaze blog WebTransport over QUIC について - ASnoKaze blog WebTransportという新しい双方向通信フレームワークの議論が始まっている。 GoogleのPeter Thatcher氏らによって、W3C WICGにプロポーザルが投げられています。 discourse.wicg.io WebTransportは、WebSocketのようなAPIをもち、QUICやHTTP/3上で多重化されたストリームを利用し、ヘッドオブラインブロックのない通信を行えるようにするというのがモチベーションのようです。（実際に使用する"トランスポート"はプラガブルな設計にな
License: CC-BY-SA 3.0 © Zalando SE 2020 & CC-BY-SA 3.0 © kawasima 2020 Zalandoのソフトウェアアーキテクチャは、疎結合なマイクロサービスを中心としており、 それらはJSONペイロードをもつRESTful API群によって、機能が提供されています。 小さなエンジニアのチームは、自分たちでAWSアカウントにこれらのマイクロサービスを デプロイしたり運用したりしています。 私たちのAPIは、その多くが私たちのシステムが何をするのかを完全に表現しており、 それゆえに貴重なビジネス資産となっています。 Zalandoがとあるオンラインショップから価値あるファッションプラットフォームへと変貌を とげるために、私たちは新しいオープンプラットフォーム戦略の展開をはじめました。 なので、高品質で長持ちするAPIの設計は、私たちにとっ
111222は製品のIDです。 ここまでは割と一般的だと思うのですが、実際にWeb APIを設計していると、もう少し複雑なものも出てきます。 自分のリソース、他人のリソース 例えばarticles（記事）というリソースがあったとき、 GET /articles/333444 とすると、その記事が取得できるAPIになりそうですが、333444の部分を他人の記事のIDにした場合、それは取得できてよいのでしょうか。「自分の記事は取得できるが、他人の記事は権限がある場合のみ取得できるようにしたい」とするケースもあるとでしょう。 その場合、まず「GET /articles/333444」の方は自分の記事のみを取得するAPIとします。 そして、他人の記事を取得するAPIを以下のように別途用意します。 GET /users/999888/articles/555666 このように/users/99988
今日では HTTP(s) で API が公開されることは当たり前の時代ですが、エラーをアプリケーションにどう伝えるかは、個々の API の設計に依存していました。特に、HTTP ステータスコードは有限であり、元々持っている意味があるので、自由に使うことはできません。API はそのドメインごとにもっと複雑で細かなエラー情報があるはずで、それらはレスポンスボディに載せてアプリケーションに伝えることになりますが、その書式に規定は今までありませんでした。 HTTP API にて、アプリケーションにエラー情報を伝達するための（レスポンスボディに載せられる）標準的な形式が、RFC7807 Problem Details for HTTP APIs で定められています。適用例としては、以下のようになります。 HTTP/1.1 403 Forbidden Content-Type: application
仕事の関係で楽天市場関連の作業をしています。 楽天市場には、店舗が自分の出品している商品情報などを取得するAPI（RMS WEB SERVICE）があるのですが、ものがものだけに情報が少なく楽天のドキュメントも最低限しかない（その上、一般ユーザー向けの「楽天ウェブサービス API」と混同しやすい）んですよね。ちゃんと理解してるのは在庫連動ソフトを作ってる会社のエンジニアくらいなのかな。ま、仕方ない。 というわけで、楽天市場RMS APIの動作サンプル 特定の商品を取得する簡単なサンプルはこんな感じ。「serviceSecret」と「licenseKey」は「基本設定 > 利用設定 > 利用情報」に表示されています。それらを結合しBase64エンコードして、接頭辞「ESA 」を付加してAuthorizationとして渡します。そんだけ。簡単。 取得出来るデータはドキュメント（要RMSアカウン
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
