こんにちは、ティアフォーで認証認可基盤を開発している澤田です。 最近取り入れたProtobufで、素晴らしいREST APIの開発体験をしたのでご紹介します。 なお、ティアフォーではマイクロサービスを支える認証認可基盤を一緒に開発いただけるメンバーを募集しています。ご興味のある方は下記ページからご応募ください。 herp.careers 実現したかったこと マイクロサービス間連携のAPI開発において、以下の条件を満たすやり方を探していました。 スキーマを最初に定義してリクエストとレスポンスの型が自動で生成される ドキュメント（openapi.yaml）が生成される バリデーションが定義できて、その実装が自動で生成される 実現方法 Go言語で開発する場合はgo-swaggerでも実現できますが、本記事では、Protobufで実現できるgRPC Gatewayとprotoc-gen-valid
銀の弾丸ではないので良し悪しあるのは当然として、それを差し引いても以下の2つの要素があるのではと思った。 なんとなく使ってもメリットが十分得られない RESTでできてたことができなくなる（※ちゃんと調べればできる） なんとなく使ってもメリットが十分得られないWeb界隈は良くも悪くも新しい技術をとりあえず使ってみるところがあると思っていて、そこがGraphQLは十分に事前知識を持って導入しないとメリットが薄いところとミスマッチを起こしてネガティブな意見が出るのかなと思う。 GraphQLはもともとFacebookがReact, Relayとの組み合わせで使い始めたもので、クライアントライブラリとしてのRelayと、IDやページネーションについての追加仕様を公開している。ライブラリとしてのRelayは使わなくても仕様に乗っかることはできるのでそれをRelayスタイルと言ったりする。出典を忘れた
Move Fast and Break Nothing. End-to-end typesafe APIs made easy.Experience the full power of TypeScript inference to boost productivity for your full-stack application.
HTML+JavaScriptでこれから始める、REST APIを利用したアプリ開発 第3回目／Webサービスとブラウザをつなぐ機能「Fetch API」 - MdN Design Interactive
HTML+JavaScriptでこれから始める、REST APIを利用したアプリ開発 第3回目／Webサービスとブラウザをつなぐ機能「Fetch API」 新規会員登録 ログイン管理 Twitter facebook はてなブックマーク RSS 2024.5.17 FRI
Before there was GraphQL, there was REST. In recent years, REST has become the dominant API style for building backend web services. With REST, you could signal the type of request we want to make (ex: GET, POST, PUT, or DELETE) and the resource we’d like to fetch or interact with (ex: /api/pets/1) using an HTTP method and a URL. It’s a great approach (and one we initially used at StockX for sever
ReactJS: Keep Simple. Everything can be a component!
OpenAPI Specification ドリブンな開発事例とそれを支えるツール - NTT Communications Engineers' Blog
これは NTT Communications Advent Calendar 2021 3日目の記事です。 こんにちは、イノベーションセンターの松田 (@take4mats) です。 当社の Smart Data Platform (SDPF) のサービスラインナップの多くは、お客さまがサービスご利用に必要な操作を統一的に行うための Web UI に加え、同等の Web API を提供しています。 API 仕様は Knowledge Center にてサービスごとに一般公開されているのをご存知でしょうか？ (Knowledge Center で各サービス内の APIリファレンス のページをご覧ください。例えば こちらのリンク) この一般公開されている API 仕様はサービス開発初期に作成され、開発期間にも重要な役割を果たしています。 本記事では、その中で私が携わったサービスから、 API
mozaic.fm第7話のRESTの話で、RESTが日本で広く受け入れられていった頃、というか、その端緒の頃の話が出ていて懐かしかったのだし、細部にやや不正確なところがあるのが気になったりもしたので、補足を書いておきますね。 まず、いわずとしれた@yoheiさんがRESTをまず知ったのが2003年とかそれぐらいの時期とおっしゃっていて、それから数年経ち、RESTがWebエンジニアに広く受け入れられていったのは、2007年末にリリースされ、resourcesという機能を取り入れたRails2からというのは、@t_wadaさんがおっしゃっている通り、事実だろうと思います。 また、Podcastの中では、主催のJxckさんが、それはそれと認めた上で、彼自身にとってはAjaxの登場が大きかったということを述べた上で、@yoheiさんの主催された第八回XML開発者の日での高橋征義さんとid:seco
API Improvement Proposals
Welcome AIPs are design documents that summarize Google's API design decisions. They also provide a framework and system for others to document their own API design rules and practices. AIPs are a combination of design guidance and a system we use to manage and track that guidance. Learn more about how the AIP program works in the first AIP!
HTML+JavaScriptでこれから始める、REST APIを利用したアプリ開発 - MdN Design Interactive
2020年1月22日 TEXT：ニック はじめまして。freee株式会社でDevRelというロールを担当している、ニックと言います。 ネット上でWebサービスを開発する際に、欠かせない技術の一つが「RESTful API」です。 （以下、本稿では便宜上、REST APIと呼称します） GoogleやAmazonをはじめ、プラットフォームサービスを提供している様々な企業が、APIを通じてデータの提供を行なっています。 しかし、REST API に慣れていない方は、どこから手をつけて良いかわからないことでしょう。 これから数回にわたり、初めてAPIを触る方向けに、覚えておきたい基本的な用語や技術について解説をしていきます。
.NET において REST API を呼び出す際、多くの方が HttpClient を使用すると思いますが、その時の注意点が帝国兵さんの Qiita で書かれています。 qiita.com この記事に書いてある通りで、 HTTP Client インスタンスをいちいち破棄して作成を繰り返していると、CLOSE_WAIT または TIME_WAIT 状態の SNAT ポートが増えてしまい、ポートが枯渇して通信ができなくなります。 具体的には hping3 で繰り返しリクエストを行っているのと同じ状態であると思います。 hping3 の使い方の具体例は宇田さんのサイトをご覧ください。 www.syuheiuda.com さて、 private static readonly HttpClient HttpClient; を使うのも良いと思いますが、 .NET Core 2.1 以降 であれば
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.
March 23, 2020 Please don't write your documentation in Markdown Please don't write your documentation in Markdown. Please. I'm begging you. Markdown is tolerable for short documentation, like a readme.md. Past that, it's the wrong tool for the job. Markdown is about formatting, not information Markdown is just a way to write simpler, nice looking HTML. There is direct mapping between _foo_ and <e
Hono とは？ Hono は TypeScript/JavaScript のシンプルな Web フレームワークです。Hono という名前は日本語の「炎」に由来します。 Hono の特徴としては以下の点が挙げられています。 ウルトラファスト 依存関係ゼロ ミドルウェア TypeScript マルチプラットフォーム ウルトラファスト Benchmarks の示すとおり、Hono はその他のライブラリに比べて早い結果がでています。Hono が早い理由として、内部で使うルーターに秘密があります。Hono では以下の 2 種類のルーターどちらを使用するか選択できます。 TrieRouter RegExpRouter 「TrieRouter」URL のパスマッチングは URL のパスマッチングにTrie 木という構造を使っています。「RegExpRouter」は登録されたルーティングをあらかじめひと
SQLBoiler（とoapi-codegen）でつくるREST APIサーバ | フューチャー技術ブログ
ライブリッツの筒井です。 GoのORマッパー連載、折り返して5日目です。 SQLBoilerを使用したDBスキーマ駆動なREST APIサーバの開発ワークフローを紹介します。 なぜSQLBoilerを選ぶのか?自分たちのチームでは、REST APIサーバを開発する際にはまずデータベースのテーブル設計から始めることが多いです。その次にAPI定義の設計へ入るのですが、既にテーブル定義は出来上がっているため、なんとなくSQL文が頭に思い浮かんだ状態でAPIのRequest / Responseを考えることになります。 ゆえにORMに一番に求めるのは、「いかにストレスなく思い描いていたSQL文を実行し、Goの文脈に持ち込めるか」ということです。 この基準を元に、次のような観点からSQLBoilerを選定しています。 複雑なSELECT文でDSLに苦悩したくない前述の通り、我々の頭の中にはなんとなく
LINE Developer MeetupはLINEが定期的に開催する技術者向けミートアップです。66回目の今回はLINEの新規サービス開発に携わる奥山氏が社内フレームワークArmeriaを使って簡単にgRPCサーバーを実装する方法を共有しました。 gRPCって何だったっけ？ 奥山裕也氏（以下、奥山）：LINEの開発4センター、 Official Account開発室の奥山が、「OA DevにおけるgRPC」についてお話しします。 まず簡単に自己紹介しますと、私は2019年の4月に新卒で入社しました。Official Account開発室というチームで、LINE公式アカウント関連の新規サービスを主に開発しています。コードは、サーバサイドで主にKotlinを書いています。また、line-bot-sdk-pythonというMessaging API SDKのメンテナーもしています。 今日は、最
Django REST framework + Vue.js「SEIYU風のECサイトを作りましょう」全6回（予定） - Qiita
前書き 本記事はまだ連載中、更新頻度は大体週に一回(多分)、忙しさ次第 コンテンツ紹介 バックエンドはDjango (Django REST framework) + 管理システムはXadmin フロントエンドは Vue.js + Vue Router + Vuex 動作確認リンク 読んで欲しい人 Python大好き Pythonの基礎的な文法を把握しています Pythonでウェブサービスを作りたい Djangoの環境構築をしたことがある Vue.jsに興味がある Vue.js のCLIでプロジェクトを作ったことがある 環境説明 PyCharm
Before I go further, I want to clarify that I love GraphQL as a frontend engineer. It empowers me to create. I also think GraphQL is a great choice for larger engineering organizations. Having a GraphQL server as an API layer over different micro services allows frontend engineers to just build without dealing with the complexity. For new projects, however, I will no longer be using GraphQL. My de
アジア最大級の国際Scalaカンファレンスである「ScalaMatsuri2020」がオンラインで開催されました。そこでTreasure DataのTaro L. Saito 氏がScalaに関するいろいろなテクノロジーを紹介しました。2つ目は、Scalaで直接通信する方法について。前回の記事はこちら。 Scalaは実はRPCを実装するのに適した言語 Taro L. Saito氏：もともと何をしたかったかというと、「Scalaでクライアントもサーバーも実装できるんだったら、Scalaでそのまま通信できないのか？」というところが出発点になって、今新しいフレームワークを整えているところです。 ScalaはFunctional（関数型）で、かつstatically typed（静的型付き）、というobject orientedな言語になっているのがいいところです。 これよく考えてみると、Scal
Official Docs | Try TypeSpec Online | Getting Started | Language Overview TypeSpec is a language for defining cloud service APIs and shapes. TypeSpec is a highly extensible language with primitives that can describe API shapes common among REST, OpenAPI, gRPC, and other protocols. TypeSpec is excellent for generating many different API description formats, client and service code, documentation, a
はじめに マイクロサービスの文脈などでときどき登場するスキーマ駆動開発、さらにその文脈のなかで目にすることのある GraphQL をご存知でしょうか？ （スキーマ駆動開発については Studyplus さんの以下の記事がとても参考になりました！） ぼくは聞いたことはある、くらいのレベルだったので、GraphQL チョットワカル 程度のレベルに到達することを目標に、概念の理解から簡単な実装まで試してみました。 今回の記事はテーマとしてはわりと技術寄りなものになっていますが、愛すべきポケモンたちに登場してもらうことで、できる限りわかりやすい内容になるよう心がけたつもりです！ 肩の力を抜いてお読みいただけるとさいわいです！ 前提 以下の情報はすべて GraphQL どころか REST 初学者が書いたものです。 記載内容の誤りや、より良い実装などありましたらご指摘いただけますとうれしいです！ また
夕食後は一切研究をしないようになって、そろそろ2年が経つ。 多くの院生と同様、もともと私は昼夜の別なく、勉強や研究をやってしまう性質だった。考えてみれば中学受験の塾からして、学校が終わった後に始まり、夕食を挟んで夜まで授業が行われていたのだから、こうした習慣はかれこれ10年以上も続いていたことになる。もっとも、小学校から大学まで、学校というシステムは日中のほとんどの時間を拘束するものだから、宿題や予復習を考えれば、夜も勉強することが前提になっている。 その延長で、いわゆる研究者の卵として大学院に入り、毎日授業を受けるという意味での「勉強」から解放され、「仕事」としての研究に従事し始めてからも、私は昼夜を問わず研究活動に勤しんでいた。もちろん、四六時中研究をしていたわけではなく、休みも取っていたのだが、特に就業時間を決めずに、休みたい時に休んでいたのである。 やりたいときにやりたいことをやる
アジア最大級の国際Scalaカンファレンスである「ScalaMatsuri2020」がオンラインで開催されました。そこでTreasure DataのTaro L. Saito 氏がScalaに関するいろいろなテクノロジーを紹介しました。まずは、バックエンドとフロントエンドの両方で使えるScalaについて。 趣味はオープンソースのプロジェクトを作ること Taro L. Saito氏：「Scala For Everything」というタイトルで発表します。簡単な自己紹介を。Treasure DataのSaitoといいます。Principal Software Engineerをしていて、今、カリフォルニア、アメリカの西海岸から発表しています。タイムゾーンの都合上、今こちらは夜の20時なんですけれども、ScalaMatsuriの運営の麻植さんが、タイムゾーンに配慮してくださったので、非常に感謝し
Horizontal SaaS 647種類のAPI提供状況を調査：そこから見えてきた国産 SaaS APIの今 - CData Software Blog
こんにちは！ CData Software Japan で API Horic 担当の 杉本@sugimomoto です。 みなさんは SaaS比較サイト BOXIL が公開している「Horizontal SaaS カオスマップ」というものを見たことはありますか？ ボクシル運営のスマートキャンプ、最新SaaSカオスマップ制作 - SaaS業界レポート2019市場規模など先行公開 より 国内SaaSサービス最大手の比較サイトを運営しているだけあって、600種類以上のSaaSがカテゴリ毎にわかりやすくまとまっているカオスマップです。SaaS導入を検討している方であれば見ておいて損は無い資料ですね。 私も大好きな資料なんですが、どうしても物足りなかった要素が1つあります。それは「APIが提供されているかどうかわからない！」という点です。 以下の記事でもある通り現在の SaaS にとって「API」
知れば納得！HTTP API と REST API の VPC リンクは違うんやで。 | DevelopersIO
次に、HTTP API の場合ですが、VPC リンクの実態は ENI です。 ENI は作成しても追加費用はありませんし、データ処理料金の発生もありません！(AZ 間通信などの通常料金は発生します) REST API の構成図（例） REST API の場合、Private Link による接続ですので、API Gateway 側の ENI は VPC 外ということになります。 HTTP API の構成図（例） HTTP API の場合、API Gateway の基盤ネットワークからターゲットの VPC 内に ENI で延伸することになります。 図を見て解るとおり、HTTP API の各ターゲットリソースとして許可するのは VPC 内に伸びてきた ENI からの通信になります。よって、VPC リンクにアタッチされているセキュリティグループや、サブネットの CIDR を許可すると良いでしょう
Relay-style GraphQL
🇰🇷 한국인 (Korean) translation available (courtesy of Yujin Lim) “The future Relay-style GraphQL is already here – it’s just not evenly distributed.” – William Gibson, probably ”Relay-style GraphQL” is an opinionated way of consuming GraphQL in a React application, and probably better than whatever you’re currently doing. It follows the ideas pioneered by Meta’s open-source GraphQL library, Relay.
GitHub - thevahidal/soul: 🕉 A SQLite REST and realtime server
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert
Have you heard about algebraic effects? My first attempts to figure out what they are or why I should care about them were unsuccessful. I found a few pdfs but they only confused me more. (There’s something about academic pdfs that makes me sleepy.) But my colleague Sebastian kept referring to them as a mental model for some things we do inside of React. (Sebastian works on the React team and came
GraphQL で REST API を作る - 技術的な挑戦と、それを支える文化の話 - LayerX エンジニアブログ
バクラク事業部の Product Enabling Team でソフトウェアエンジニアをしている @izumin5210 です。 この記事は LayerXアドベントカレンダー(概念) の54日目の記事です。 バクラクのリソースを提供する REST API を開発するにあたり、その基盤を GraphQL をベースに実装する、ということをしました。 なかなかにチャレンジングな選定であり、これを入社してすぐ作っているという背景も含めておもしろい話だと思うので、技術的な話と文化的な話をあわせて紹介させてください。 「GraphQL で REST API を作る」とは？ まず「GraphQL で REST API を作る」というのが見慣れない文字列なのではないでしょうか？ 前提を揃えるために目指す形を明確にしておくと、だいたい以下のようなものです。 外から見た API は REST に従っており、H
GitHub - mswjs/msw: Seamless REST/GraphQL API mocking library for browser and Node.js.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert
EngineeringOpen SourceIntroducing GitHub’s OpenAPI DescriptionThe GitHub REST API has been through three major revisions since it was first released, only a month after the site was launched. We often receive feedback that our REST… The GitHub REST API has been through three major revisions since it was first released, only a month after the site was launched. We often receive feedback that our RE
Hanabi.REST AIにHonoJSのバックエンドを書かせて遊ぶ、Hanabi.RESTというサービスを一般公開します。それに際して、この記事では、Hanabiの紹介と簡単に技術スタックを解説していきます。 皆さんは、AIがプロンプトからUIを生成する、V0というサービスをご存じですか？僕はあれを見たときに、ある妄想が膨らみました。 「V0のAPI版があれば、プロンプトからWebアプリケーションを作れるやん！！」と。 当初はハッカソン用の小プロジェクトとして始めましたが、想定以上に面白い結果が得られたため、開発を継続することにしました。技術的な制約、様々な黒魔術による不安定な挙動、LLMの劣化など、数多くの壁を乗り越えながら、約半年をかけてようやくリリースに至りました！！ 次のリンクから実際にAIが生成したTwitter風のAPIを試すことが出来ます！ また、会員登録すれば誰でもAP
FastAPI
FastAPI framework, high performance, easy to learn, fast to code, ready for production ドキュメント: https://fastapi.tiangolo.com ソースコード: https://github.com/tiangolo/fastapi FastAPI は、Pythonの標準である型ヒントに基づいてPython 以降でAPI を構築するための、モダンで、高速(高パフォーマンス)な、Web フレームワークです。 主な特徴: 高速: NodeJS や Go 並みのとても高いパフォーマンス (Starlette と Pydantic のおかげです)。 最も高速な Python フレームワークの一つです. 高速なコーディング: 開発速度を約 200%~300%向上させます。 * 少ないバグ: 開発者起
Thunder Client - Rest API Client Extension for VS Code
Thunder Client for VS Code Hand-crafted lightweight Rest Client for testing APIs. Supports collections, environments, git collaboration and local storage. Get VS Code Extension Thunder Client CLI Trusted by Customers Preferred by Fortune 500 companies, banks, financial services, tech firms, and retail giants.
Spring BootのREST APIをAWS Fargateにデプロイしてみた | DevelopersIO
はじめに おはようございます、もきゅりんです。 皆さん、フレームワーク使ってますか？ 自分は特にジャバーではないのですが、本稿ではお勉強も兼ねて Spring Boot を使って Fargate に APIをデプロイしてみました。 なお、Spring Boot に詳しいわけでは全然ないので、淡々と公式ドキュメントに沿ってAPIを作り、Dockerイメージに仕上げます。 Fargate はちゃんと動くかだけを確認しておきます。 そのため、Spring Boot および Fargate がどんなものでどんな特徴があるのか、といったコンテンツはございません。あしからず。 そういった方には下記 Fargate ブログは適切です。 基礎から応用までじっくり学ぶECS Fargateを利用したコンテナ環境構築 #Fargate | Developers.IO やること Spring Boot でRES
[VSCode] REST Client は変数を使うとAPIの環境やパラメータ変更が楽になる！ | DevelopersIO
API Gatewayで作成したAPIの動作を確認するとき、何らかのRESTクライアントを使うと思います。 curlコマンド Postman Insomnia REST Client Chromeの拡張機能 など 今回は、私が使っているVisual Studio Codeの拡張機能を紹介します。特に変数が使えるため、APIの環境（開発・本番など）やリクエストパラメータの変更がとても楽に行えます。 REST Client - Visual Studio Marketplace おすすめポイント たくさんあるので、抜粋してご紹介します。 テキストファイルで管理できる 複数のリクエストを同じファイルに書ける 変数が使える curlコマンドを作れる コードスニペットを作成できる など この中でも、「変数が使える」がとても便利です！ 「GETしたResponseのパラメータを参照してPOSTする」や
![[VSCode] REST Client は変数を使うとAPIの環境やパラメータ変更が楽になる！ | DevelopersIO](https://cdn-ak-scissors.b.st-hatena.com/image/square/b3a3cd126b780dcd4cdffcaa7d018424e8c697cb/height=288;version=1;width=512/https%3A%2F%2Fdevio2023-media.developers.io%2Fwp-content%2Fuploads%2F2019%2F06%2Fvscode-2019-eyecatch-1200x630.png)
GitHub - flawiddsouza/Restfox: Offline-First Minimalistic HTTP & Socket Testing Client for the Web & Desktop
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert
Azure OpenAI Service の REST API リファレンス - Azure OpenAI
この記事では、Azure OpenAI の推論 REST API エンドポイントについて詳しく説明します。 認証 Azure OpenAI には、2 つの認証方法が用意されています。 API キーまたは Microsoft Entra ID を使用できます。 API キー認証: この種類の認証の場合、すべての API 要求で、api-key HTTP ヘッダーに API キーを含める必要があります。 クイック スタートに、この種類の認証を使用して呼び出しを行う方法に関するガイダンスが用意されています。 Microsoft Entra ID 認証: Microsoft Entra トークンを使用して API 呼び出しを認証できます。 認証トークンは、Authorization ヘッダーとして要求に含まれます。 指定するトークンの前に Bearer を付ける必要があります (例: Bearer
GraphQLとは何か？ イメージを掴む
はじめに 今回の記事ではGraphQLについて、公式などを参考にしながら基本的なことをまとめてみました。 自分自身GraphQLのキャッチアップを始めるときに こんなこと知っときたかったなあ、ということをまとめたので これからGraphQLの勉強を始める方や興味のある方はよかったら読んでみてください。 大枠を掴むことをイメージして書いており、深い部分の説明を省いている箇所もあるので その点はご了承ください。 そもそもGraphQLとは？ GraphQLはAPIのクエリ言語です。 クエリ言語というとSQLが有名ですが、SQLがデータベースに対してクエリを実行するのに対し、 GraphQLはAPIに対してクエリを実行します。 ちなみに、プログラミングにおけるクエリとは データに対する問い合わせや要求などを一定の形式で文字に表現すること、 要は所定の形式で対象のデータにやりたいことを伝えること、
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
ProtobufでREST APIを快適に開発する方法のご紹介 - TIER IV Tech Blog
https://twitter.com/iwashi86/status/1547051699503857667
GraphQLのよくないところ｜adwd
tRPC - Move Fast and Break Nothing. End-to-end typesafe APIs made easy. | tRPC
Why use GraphQL? | Apollo GraphQL Blog
OpenAPI? What Is That? Is That Tasty?
RESTが日本で受け入れられていった頃の話( #mozaicfm の補足) | 栗林健太郎
HttpClient よりも HttpClientFactory を利用したほうが良いかも - 世界のやまさ
-design-REST-APIs)
How to (and how not to) design REST APIs
Please don't write your documentation in Markdown
Hono + Cloudflare Workers で REST API を作ってみよう
LINE開発担当が語るプロダクションレディなgRPCサーバをArmeriaで簡単に作る方法
Why I no longer use GraphQL for new projects
REST・Protocol Bufferは必要ない RPCフレームワークにそのまま使えるScalaの魅力
GitHub - microsoft/typespec
ポケットモンスター 【REST / GraphQL】 - okadato の雑記帳
夜研究をしないということ - 紅茶の味噌煮込み
Scalaはバックエンドでもフロントエンドでも動く Treasure Dataのエンジニアが語るScalaの応用力の高さ
Algebraic Effects for the Rest of Us
Introducing GitHub's OpenAPI Description
プロンプトからREST APIを作るサービス『Hanabi.REST』の技術構成