タグ

APIに関するcuttoff19のブックマーク (9)

  • RESTful のウェブ API 設計で避けるべき 6 つのよくあるミス | Google Cloud 公式ブログ

    ※この投稿は米国時間 2022 年 12 月 1 日に、Google Cloud blog に投稿されたものの抄訳です。 オンラインで、組み立て式のテーブルを注文したとします。ところが、パッケージを開けてみると、組立説明書が入っていません。完成品がどんなものかはわかっていても、それぞれのパーツをどう組み立てればいいのか、まるでわかりません。設計が不十分な API を使うコンシューマ開発者も、同じような経験をしているといえます。適切に設計された API なら、容易に見つけ、検索してアクセスし、使用することができます。高品質の API は、コンシューマ開発者がアイデアをひらめき、新しいユースケースを作り上げる手助けになってさえくれます。 もちろん、API 設計を改善する方法はあります。たとえば、RESTful のプラクティスに従うなどです。しかし、お客様が知らず知らずのうちに、ちょっとした不便

    RESTful のウェブ API 設計で避けるべき 6 つのよくあるミス | Google Cloud 公式ブログ
  • Platform

    cuttoff19
    cuttoff19 2021/12/29
    stoplight.ioのAPI設計ガイド
  • GraphQLが解決する問題とその先のユースケース

    サーバーサイドからみたGraphQL Serverlss Meetup#19 2021/03/31 に行われた Serverlss Meetup#19 で上記のタイトルで登壇してきました。サーバーサイドの話をしようと思ったけどGraphQLの解決している話をしようと思ったらクライアントの事もかなりはいってしまったので記事のタイトルは変えました。 以下内容です。記事の最後に資料を書くにあたって参考になった資料のリンクを置いてます。 GraphQL and me この1年書いたQiita記事 GraphQLの特徴を分解する ~API インターフェース・Universal BFF・API Gateway~ GraphQLはサーバーサイド実装のベストプラクティスとなるか GraphQLの全体像とWebApp開発のこれから 今回話す事 そもそもGraphQLはなんで作られたのか、何を解決しようとして

    GraphQLが解決する問題とその先のユースケース
  • 「WebAPI 設計のベストプラクティス」に対する所感 - Qiita

    「翻訳: WebAPI 設計のベストプラクティス」を読んで色々と思うところがあったので書きました。 上記の記事は訳文でありますので、正しくは「Best Practices for Designing a Pragmatic RESTful API」に対する所感と述べた方が良いのかもしれませんが、日語で通して読めるよう Qiita に投稿された訳文に対する所感として書いています。 以下では「翻訳: WebAPI 設計のベストプラクティス」並びに「Best Practices for Designing a Pragmatic RESTful API」は「当該記事」と表現します。 観点 当該記事では「○○とした方がよい」との意見に対してそうすべき理由が明らかになっていないか、もしくは表現が曖昧な場合が目立っていると感じました。設計は実装のようにプログラム言語仕様が制約を与えられないため、意図

    「WebAPI 設計のベストプラクティス」に対する所感 - Qiita
  • 翻訳: WebAPI 設計のベストプラクティス - Qiita

    これは Enchant の開発者である Vinay Sahni さんが書いた記事「Best Practices for Designing a Pragmatic RESTful API」1を、ご人の許可を得て翻訳したものです。 RESTful な WebAPI を設計しようとすると、細かなところで長考したり議論したりすると思います。また、他の API に倣ってやってはみたものの、当にそれでいいのか、どうしてそうしているのか分からない、何てことも少なくはないと思います。 この記事では、そのようなハマリどころについて Vinay さんなりの答えを提示し、簡潔かつ明快に解説してくれています。 今後 WebAPI を設計される方は、是非参考にしてみてください。 なお、誤訳がありましたら編集リクエストを頂けると幸いです。 まえがき アプリケーションの開発が進むにつれて、その WebAPI を公

    翻訳: WebAPI 設計のベストプラクティス - Qiita
  • ChromeでREST APIをテストするならコレ!「DHC」 | mah365

    「え、Chrome使ってるのにDHC知らんの?」と言われて「え、化粧品の話ですか???」と壮大なボケをかましたのですが、REST APIをテストするためのChromeアプリでした。 こんな便利なツールを知らなかったとは・・・って感じ こちらのリンクからDHCをインストールすると、Chromeのアプリ一覧にDHCが並ぶようになります。そこからDHCを開くと、↑の画像のような感じの画面が表示されます。 使い方は画面を見れば分かるほど分かりやすいですね。リクエストは名前をつけて保存することができるので、「あのAPI、どんな値が返って来たっけ?」というときでも安心です。 POSTリクエストの場合は↑の画像のような感じでリクエストボディの値を書くことができます。 Formモードにすると、かなり直感的な形でリクエストボディの値を指定することができます。凄いぜ。。 ブラウザベースなので、セッションを保持

    ChromeでREST APIをテストするならコレ!「DHC」 | mah365
  • JSONPlaceholder - Free Fake REST API

    {JSON} Placeholder Free fake API for testing and prototyping. Powered by JSON Server + LowDB. Tested with XV. Serving ~2 billion requests each month. Sponsors JSONPlaceholder is supported by the following companies and Sponsors on GitHub, check them out 💖 Your company logo here Try it Run this code here, in a console or from any site: fetch('https://jsonplaceholder.typicode.com/todos/1') .then(re

    cuttoff19
    cuttoff19 2016/06/10
    便利
  • RailsでAPI開発する前に知っておくべき4つのこと - Qiita

    $ bin/rails g scaffold user name:string mail:string password:string invoke active_record create db/migrate/20151214145437_create_users.rb create app/models/user.rb invoke test_unit create test/models/user_test.rb create test/fixtures/users.yml invoke api_resource_route route resources :users, except: [:new, :edit] invoke scaffold_controller create app/controllers/users_controller.rb invoke test_un

    RailsでAPI開発する前に知っておくべき4つのこと - Qiita
  • ほげおメモ: Python Twitter API python-twitter の使い方 (Part3): Post & Reply

    それでは実際にTweetを投稿してみましょう。 ここからはWrite権限を持つ任意のユーザーでOAuthしたインスタンスが必要です。 使用するメソッドはPostUpdate()です。 twitter.Api.PostUpdate = PostUpdate(self, status, in_reply_to_status_id=None) unbound twitter.Api method Twitter Status(Tweet、あるいは"つぶやき"と呼ばれているテキスト)を、認証ユーザからPostします。 引数 status: PostするText in_reply_to_status_id: Reply対象のStatus(tweet)のID。これに指定されたIDのStatusに対してReplyを行う 返り値 Postされたtwitter.Statusインスタンスオブジェクト サンプル

    ほげおメモ: Python Twitter API python-twitter の使い方 (Part3): Post & Reply
  • 1