API設計スキルを次のレベルに引き上げるベストプラクティス22選 - Qiita
本記事は、Mohammad Faisal氏による「22 Best Practices to Take Your API Design Skills to the Next Level」（2021年4月15日公開）の和訳を、著者の許可を得て掲載しているものです。 REST API設計のための実践的アドバイス Photo by Andrea Piacquadio from Pexels はじめに すべてが分かりにくく、ひどいAPIに不満を感じたことはありませんか？私はそうです。 マイクロサービスの世界では、バックエンドAPIの一貫した設計が不可欠です。 今日は、知っておくべきベストプラクティスについて、簡潔に説明します。さあ始めましょう！ 用語 API設計は、リソース指向設計というものに従います。3つの重要な概念で構成されています。 リソース：データの一部（例：ユーザー） コレクション：リソー
エンジニア・プログラマにしか使えないSNSを作ってみた話 - Qiita
はじめに 通常のSNSで胡散臭い人が多いと感じてしまいました プログラミングスクールが流行り、エンジニアになって億稼いでます！みたいな・・・ そこで、本当のエンジニア・プログラマしか使えないSNSを作ってみました！ つまり、WebApi提供のみのSNSです 一般ピープルが使うようなフロントエンドなんてありません！！ Postmanなり、なんなりを使って叩いてください エンジニア・プログラマしかWebApiが叩けないであろうという考えなので、 エンジニア・プログラマにしか使えないSNS！ということです この記事を見ている、プログラマ・エンジニアの方であれば使えますよね？😁 実際、WebApiが叩くことが出来れば誰でも使えてしまうわけですが・・・。 2021/07/20 更新 このWebApiを作ったシステムについて書きました ソースコード公開しました CRUDのWebApi開発は不要！Js
[FastAPI] Python製のASGI Web フレームワーク FastAPIに入門する - Qiita
PythonのWeb frameworkで、Flaskのようなマイクロフレームワークにあたります。 パフォーマンスの高さ、書きやすさ、本番運用を強く意識した設計、モダンな機能などが強みです。 FastAPIはStarletteの肩に乗る形で書かれており、非同期処理が扱いやすいです。 特に、以下の様な特徴があります。 ASGI websocketのサポート GraphQLのサポート バックグラウンドプロセスが扱いやすい python type hintによる自動ドキュメント生成 (Swagger UI) pydanticをベースとしたdata validation 率直に言って、responderに非常に似ています。(でた時期も近いですし、responderもStarletteがベースなので) ですが、下の2つはFastAPIの方がよっぽど使いやすく設計されています。 以下の観点から総合的に
![[FastAPI] Python製のASGI Web フレームワーク FastAPIに入門する - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/d013e1977441113d06dd0aef1cf98cfbecd57336/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-412672c5f0600ab9a64263b751f1bc81.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk3MiZoPTM3OCZ0eHQ9JTVCRmFzdEFQSSU1RCUyMFB5dGhvbiVFOCVBMyVCRCVFMyU4MSVBRUFTR0klMjBXZWIlMjAlRTMlODMlOTUlRTMlODMlQUMlRTMlODMlQkMlRTMlODMlQTAlRTMlODMlQUYlRTMlODMlQkMlRTMlODIlQUYlMjBGYXN0QVBJJUUzJTgxJUFCJUU1JTg1JUE1JUU5JTk2JTgwJUUzJTgxJTk5JUUzJTgyJThCJnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnR4dC1jb2xvcj0lMjMyMTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9NTYmcz0wYmM4MmFjM2VlNmE2NDMzZGU1ODlmOGE4NTA5OWZmNw%26mark-x%3D142%26mark-y%3D57%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZoPTc2Jnc9NzcwJnR4dD0lNDBiZWUyJnR4dC1jb2xvcj0lMjMyMTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9MzYmdHh0LWFsaWduPWxlZnQlMkN0b3Amcz1lMjMzMGZlMmI0YWE0NGQyZDQ5YjRlZGQzNTFkMmU1Mw%26blend-x%3D142%26blend-y%3D486%26blend-mode%3Dnormal%26s%3D9efbb9f717aa9ad6aad0e5ba4894ec3c)
気象情報API比較してみた - Qiita
※OpenWeatherMapの取得可能情報種類は5 day / 3 hour forecast APIでの情報 ※Weather Undergroundの取得可能情報種類はconditions APIでの情報 OpenWeatherMap http://openweathermap.org/ ・APIは数種類公開されていますが、無料で利用可能なものは現在の気象情報が取得できるもの、3時間毎/5日間の予報が取得できるものの2種類です。 ・空港や都市部に設置されているものから個人観測所も含め40,000以上の観測所からデータを収集しています。データソースとして日本気象庁、アメリカ国立気象局、カナダ気象庁、ヨーロッパ中期予報センター等が挙げられています。 Weather Underground https://www.wunderground.com/ ・アメリカ国内外合わせ60,000以上の
Clean ArchitectureでAPI Serverを構築してみる - Qiita
この記事では、アーキテクチャを採用する理由、次にClean Architectureの概要、最後にアプリケーションの構築をしていきます。 この後詳しく見ていきますが、Clean architectureの概念は比較的シンプルでわかりやすいものだと思います。しかし実際コードに落とし込んだ時、これってどう実装すればいいのかな？と迷うことがあったので、自分の理解も深めるために実際にAPI Serverを構築していきたいと思います。 また、サーバーサイドでの採用事例をあまりみないので誰かの参考になればいいかなと思います。 サンプルコードは、Go言語です。 アーキテクチャを採用する理由 アーキテクチャに期待することは、関心の分離です。 関心の分離を正しく行うことで、次のようなメリットがあると思います。 再利用性の高い設計になり生産性が向上する コードの可読性が上がり、メンテナンスが容易になる 変化に
GraphQLとPersisted Query - Qiita
最近、GraphQL APIをインターネット上に晒す上で何を考慮したらいいのだろうか、的なことを考える機会が多く、空いた時間でチマチマと素振りしています。 今日はGraphQLのクライアント - サーバー間に挟むリバプロ的な機能について書いてみようと思います。 やりたいこと 1. 想定しないクエリの排除 例えばECやメディアサイトのような、未ログインでも情報の閲覧が可能なサービスのWeb API層をGrahpQLで実装したとします。ECにしろメディアにしろ、詳細ページでの回遊率を上げるため、詳細同士を関連付けるようなスキーマ設計となるのは自然なことでしょう。 GrahpQLのスキーマ定義で書くと、下記のようなイメージです。 type Product { id: ID! name: String! relatedProducts: [Product] } type Query { produ
Golang(ECHO+GORM)でJWTとGraphQLの環境を構築 - Qiita
package main import ( "github.com/labstack/echo" "github.com/labstack/echo/middleware" "./handler" ) func main() { e := echo.New() e.Use(middleware.Logger()) e.Use(middleware.Recover()) e.GET("/hello", handler.Hello()) e.POST("/login", handler.Login()) r := e.Group("/restricted") r.Use(middleware.JWT([]byte("secret"))) r.POST("", handler.Restricted()) e.Start(":3000") } package handler import ( "n
OASGraphって何? - Qiita
はじめに（おことわり） 筆者はGraphQLについては、先週こちらに参加してようやく学習を開始したという入門者です。この記事を書く前に本来ならGraphQLを触って理解を深めてから、というのが筋とは思ってます。とはいえスピード感も重要でパラレルで理解を深めて行くのも一つの手と考えているため、OASGraphについて発表された内容を、浅い理解なりに、むしろ読みながら書きながら理解する感じで、まとめてみようと思います。誤訳・誤解・理解が浅い部分を含む可能性および、あくまで私自身の見解である点ご了承ください。間違いなどありましたらコメント頂けますと幸いです。実際に試した内容などについては別途まとめようと考えており、本記事は文章オンリーです。 StrongLoopが発表したOASGraph 以下の内容はStrongLoopの発表レターを内容に私の理解を加えて書いています。 多くのAPI系の方々が日
Ionic3でpush通知ができる構成について - Qiita
きっかけ 私のローカルでプッシュ通知が出来てるビルドが作れて、他の開発環境でビルドするとデバッグすらできないという事態が発生。 行きつくところ、phonegap-plugin-push（プッシュ通知のためのプラグイン）のバージョンの問題だった。 前提 基本の構成は以下の通り。 ionic3系のプロジェクト cordovaもそれに付随したバージョン Androidのビルドしかしてない（ああ、browserもあるけどここでは関係ない） LoopbackというものでAPIサーバを作っている プッシュ通知はFirebaseのMessagingを使用 LoopbackのPushの使い方をベースにプッシュ通知を実装している。 https://github.com/strongloop/loopback-component-push https://github.com/strongloop/loopb
Thrift 0.9.1のインストールではまった件 - Qiita
MacOSX上へのthrift 0.9.1のインストールに難儀したのでメモしておきます。 PHP用のファイルが足りないことが原因だったので、PHPを使わない人は除外すれば起きないかと思います。 CPPでもエラーが起きましたが僕は使わないので見なかったことにします。 なお、ThriftはHomebrewにも上がっていました。brewで試して上手く行けばおめでとうございます。 さて、Thriftのソースはここからダウンロードできます。 wget https://dist.apache.org/repos/dist/release/thrift/0.9.1/thrift-0.9.1.tar.gz tar zxf thrift-0.9.1.tar.gz cd thrift-0.9.1 ./configure make && make install 本来ならこれでインストールできるはずです。 しか
phpのThriftクライアントひな形生成の際のオプション - Qiita
:inlined :server :autoload :oop :rest このなかでも自分が使った「inlined」と「oop」についてメモ。 使用したバージョンはApache Thrift v0.9.3。 :inlined Thriftライブラリに依存しないファイルを生成してくれる。 このオプションを使うと、gen-phpiフォルダが作られてそのなかに生成されたファイルが入れられる。(このオプションのない場合は、gen-phpフォルダが作られる。) このオプションを使って生成すると、クライアントの呼び出し方が変わるので注意が必要。 $socket = new TSocket(); $transport = new TBufferedTransport($socket, 1024, 1024); $protocol = TBinaryProtocol($transport); $clie
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
【Rails】 API開発で『Can't verify CSRF token authenticity』といわれたときの対応 - Qiita
GraphQLを検討中のあなたに送る、19の疑問と回答 - Qiita
API Blueprintでアクション毎にURI parameterを定義する
thrift の C (GLib) library のビルド - Qiita
OS X MavericksでThriftのgemを入れる - Qiita
Debian Wheezyにthriftをインストール - Qiita
ThriftのC++版を使うときに”pthread_rwlock_trywrlock”がないとエラーが出たときは - Qiita
Thriftで"Connection refused"と表示されて接続できないときは (C++ - Erlang/OTP) - Qiita
Thrift+Erlang/OTPで、「Bad value on output port 'tcp_inet'」と出るときは - Qiita