REST WebAPIのプラクティス｜yamarkz - Kazuki Yamaguchi
雑なメモ書きの様な内容です。 自分の知識、知恵の引き出しの整理も兼ねてます。 実践的で有用な対応パターンをまとめました。 HTTP Method with URI| http method | explain | URI | |GET| ドキュメントリソースの取得| https://api.example.com/v1/items/1 | |GET| コレクションリソースの取得| https://api.example.com/v1/items | |POST| リソースの作成 | https://api.example.com/v1/items | |PUT| リソースの更新 | https://api.example.com/v1/items/1 | |PATCH| リソースの部分更新 | https://api.example.com/v1/items/1 | |DELETE| リソ
翻訳: WebAPI 設計のベストプラクティス - Qiita
これは Enchant の開発者である Vinay Sahni さんが書いた記事「Best Practices for Designing a Pragmatic RESTful API」1を、ご本人の許可を得て翻訳したものです。 RESTful な WebAPI を設計しようとすると、細かなところで長考したり議論したりすると思います。また、他の API に倣ってやってはみたものの、本当にそれでいいのか、どうしてそうしているのか分からない、何てことも少なくはないと思います。 この記事では、そのようなハマリどころについて Vinay さんなりの答えを提示し、簡潔かつ明快に解説してくれています。 今後 WebAPI を設計される方は、是非参考にしてみてください。 なお、誤訳がありましたら編集リクエストを頂けると幸いです。 まえがき アプリケーションの開発が進むにつれて、その WebAPI を公
Swaggerで始めるモデルファーストなAPI開発
This document summarizes a microservices meetup hosted by @mosa_siru. Key points include: 1. @mosa_siru is an engineer at DeNA and CTO of Gunosy. 2. The meetup covered Gunosy's architecture with over 45 GitHub repositories, 30 stacks, 10 Go APIs, and 10 Python batch processes using AWS services like Kinesis, Lambda, SQS and API Gateway. 3. Challenges discussed were managing 30 microservices, ensur
RESTful APIの記述標準化を担うSwaggerとは？ | NTT Communications Developer Portal
先日、Open API Initiativeの設立が発表されました（via RESTful APIの記述標準化を目指す「Open API Initiative」をマイクロソフト、Google、IBMらが立ち上げ。Swaggerをベースに － Publickey）。これにより、RESTful APIが各企業間において標準化され、より広まっていくものと考えられます。 そんなRESTful APIを広めていく中で必要な要素になるのがドキュメントです。APIは開発者向けの画面はなく、プログラムからコールして利用します。そのため、分かりやすいドキュメントが必須になります。その標準フォーマットとして取り上げられているのが今回紹介するSwaggerです。 Swaggerはドキュメントフォーマットおよびビューワーになります。Swagger自体オープンソースとして公開されており、関連するツールやライブラリも
WebAPIについての説明 - Qiita
はじめに 新人への説明の為に書きました。 元々は社内勉強会用のスライドのメモだったものを、いい感じに直して公開する事にしました。 「勉強は真面目にするものだ」と考えている人には向きません。 「技術的な事は正確でなければいけない」と考えている人には向きません。 基本的な事から馬鹿丁寧に書いてあるので長いです。時間ある時用の記事です。 誤解を生じるぐらい噛み砕いて簡単に説明してあります。 教科書的に通して読むことでWebAPIが理解出来るように書いてあります。 対象者 htmlとcssは書ける phpとjsを主にコピペでしか書けない IT関連の基本的な用語も知らない、理解してない WebAPI？何それおいしいの？っていう人 どちらかと言うと営業寄りの部署に所属 アジェンダ 第1部 知識編 WebAPIの 仕組みを理解する 用語を理解する 第2部 実践編 WebAPIを作る WebAPIを利用す
非チェック例外多用作戦のトレードオフ認識 - 都元ダイスケ IT-PRESS
まず、以下に持論を展開するにあたって、自分の立ち位置を明確にしよう。自分は「Webアプリケーション開発者」としてではなく「JavaによるWebアプリではない（デスクトップアプリ,コマンドラインアプリ,ライブラリ）アプリの開発者」として語る。まぁ、自分に一番馴染みの深いプロダクトとしてJiemamyが挙げられるわけだが、こいつはWebアプリじゃない。Eclipse上で動くアプリケーションであり、そしてMaven2によって呼ばれるCLIアプリでもあり、また、クラスライブラリである。 この視点からJavaにおけるチェック例外と非チェック例外の話を再び。 Javaにおけるthrows句は、メソッドシグネチャの一部であり、インターフェイスにも現れる情報である。今まで「Javadocは仕様だ」と言い続けて来たが、正確にはインターフェイス（シグネチャ＋Javadoc）が仕様だ。*1 検査例外が使いにくい
Tips - Eclipse APIのクラスファイルがどのjarファイルにあるか判断するには？
Eclipse APIのクラスファイルがどのjarファイルに含まれているか判断するには？ スタンドアローンのアプリケーションを作成するには、必要に応じてEclipse APIが含まれるjarファイルをクラスパスに追加しておかなくてなりません。しかし、pluginsディレクトリにあるjarファイルの名前からは、どのクラスがどのファイルに含まれているかを判断するのは困難です。たとえば、org.eclipse.jface.text.Documentクラスがどのjarファイルに含まれているかを考える場合に、jarファイルの名前からjfacetext.jarとtext.jarと見当がつけられるのですが、どちらに含まれるかは、jarを実際に展開して調べてみなければわかりません。 そこで、Eclipse APIのjarファイルと、そこに含まれるファイル（主にクラスファイル）の対応リストあると便利です。W
Web APIって何？
Web APIとJSON Web上ではネットショッピング、ブログ、SNSなどさまざまなサービスが提供されています。これらのサービスの中にはWebブラウザから利用するだけでなく、サービスの機能の一部をプログラムから利用可能なAPI（Web API）として提供しているものもあります。Web開発者はWeb APIを利用したアプリケーションを開発したり、既存のWebサイトにWeb APIを利用した機能を追加することなどが可能です。 なお、Web APIを使用し、複数のサービスの機能を組み合わせたり、独自の機能を追加したサービスを構築することをマッシュアップと呼びます。 これらのWeb APIの多くはXMLで情報を返すものが多いのですが、中にはJSONで情報を返却するWeb APIも存在します。そこで、今回はJSONを使用するWeb APIの利用方法を紹介します。 Ajaxのクロスドメイン制約 しか
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
http://groovy.codehaus.org/groovy-jdk/
org.eclipse.jem.util.emf.workbench.ProjectUtilities
ComponentCore
org.eclipse.wst.common.componentcore
XPFriend