GoogleのWebAPI設計とWebAPI設計のベストプラクティスを比較してみる
RESTful な URL にしよう 元記事 GET /tickets - チケットのリストを取得する GET /tickets/12 - 指定したチケットの情報を取得する POST /tickets - 新しいチケットを作成する PUT /tickets/12 - チケット #12 を更新する PATCH /tickets/12 - チケット #12 を部分的に更新する DELETE /tickets/12 - チケット #12 を削除する Google GET /events - 予定のリストを取得する GET /events/12 - 指定した予定の情報を取得する POST /events - 新しい予定を作成する PUT /events/12 - 予定 #12 を更新する PATCH /events/12 - 予定 #12 を部分的に更新する DELETE /events/12 -
HTTP APIの詳細なエラー情報をレスポンスに持たせるための仕様
今日では HTTP(s) で API が公開されることは当たり前の時代ですが、エラーをアプリケーションにどう伝えるかは、個々の API の設計に依存していました。特に、HTTP ステータスコードは有限であり、元々持っている意味があるので、自由に使うことはできません。API はそのドメインごとにもっと複雑で細かなエラー情報があるはずで、それらはレスポンスボディに載せてアプリケーションに伝えることになりますが、その書式に規定は今までありませんでした。 HTTP API にて、アプリケーションにエラー情報を伝達するための（レスポンスボディに載せられる）標準的な形式が、RFC7807 Problem Details for HTTP APIs で定められています。適用例としては、以下のようになります。 HTTP/1.1 403 Forbidden Content-Type: application
C#でWebAPI叩いてJson形式の結果を受け取る処理メモ - Qiita
※C#初心者なのでメモです 環境 .NET Framework 3.5 4.0 からはDynamicJSONが使えるらしい using追加 using System.IO; using System.Net; using System.Runtime.Serialization; using System.Runtime.Serialization.Json; using System.Web.Script.Serialization [DataContract] public class RequestResult { [DataMember] public string data1 { get; set; } [DataMember] public string data2 { get; set; } [DataMember] public string data3 { get; se
Spring BootでJSONデータを受け付けるWebAPIを作る - 俄
前回の記事の続きモノです。 niwaka.hateblo.jp ↑の記事で、POSTでリクエストパラメータを受け付けるWebAPIを Spring Bootでサクッと作る方法をまとめてみましたが、今度は リクエストをJSON形式で受け取る方法を整理してみます。 (前回の記事から続きで実装する体で進めます......！) 環境は以下の通りです。 Mac OS X 10.10 Java 1.8.0 Eclipse Luna Spring Boot 1.0.2 1. Controllerクラスのメソッドをいじる(1) 前回、↓のようなControllerクラスを作りました。 @Controller @EnableAutoConfiguration public class SampleController { @RequestMapping("/service") @ResponseBody p
Web APIにはJSONベースのフォーマットを使おう - Qiita
{ "response": { "id": 3342124, "message": "Hi!", "user": { "id": 3456, "name": "Taro Yamada", "image_url": "/images/taro.png" } } } など、どの構造がいいでしょうか？ もっと違う構造も考えられます。 JSONはシンプルですが、構造に制約がなさすぎます。適切な設計を行うには適切な制約が必要です。 そこで、plain JSONに少し制約を加えたJSONベースのフォーマットを使うことをおすすめします。 もしあなたが、JSONレスポンスをどのようなフォーマットにするかをチームで議論したことがあるなら、JSON APIは『自転車置き場の議論』に対抗する武器となる。 共有された規約に従うことで、生産性が向上し、汎用的なツールを利用でき、アプリケーションという重要なものに集中
C#で東京メトロオープンデータAPIを使って駅情報を取得する - 酢ろぐ！
さて、今回も東京メトロオープンデータAPIを使ってみましょう。 タイトルでは駅情報を取得するとなっていますが、正しくはodpt:Stationで指定する東京メトロ駅情報を取得するです。 東京メトロ駅情報を取得する 東京メトロの駅情報は、JSON.NETを使って取得したJSON-LD形式のデータをパース(デシリアライズ)させます。その時、型を指定しますので事前に下記のようにStationクラスを定義しておきましょう。 using Newtonsoft.Json; using System; namespace TokyoMetro.Apis { public class Station { [JsonProperty("@context")] public string Context { get; set; } [JsonProperty("@id")] public string Id
API 仕様
気象庁防災情報 XML 検索 API JSON 形式で応答を返す Web API です。以下の URL にパラメータを付加して GET してください。 指定したパラメータと値によってデータベース内の気象庁防災情報 XML を検索し、一致するものへのリンクが返されます。 http://api.aitc.jp:80/jmardb/search 使用可能なパラメータは以下のとおりです。パラメータの名前はすべて小文字です。 実際の各パラメータの値がどのようなものかは、トップページで検索した結果の一覧を見ると把握できると思います。 また、文字列の検索は部分一致でなく完全一致であることに注意してください。 status
Web APIで取得したXML/JSONからVSデザイナで表示できるリアルなXAMLサンプルデータを作成する - Neutral Scent
どうもこんにちは、手書きXAML派、id:kaorunです。 このエントリーはXAML Advent Calendar 2013、2日目のエントリーです。 今回は、各種Web APIから取得したXML/JSONデータをサンプルデータとしてXAMLに差し込むおおまかな方法をご紹介します。 手書きXAML派でもデザイナーさんとは仲良くしたいよね、やっぱりきちんとリアルデータでプレビューしたいよね、と最近ちょっと研究していた点をまとめてみました。既に実践されてた方々には何をいまさらという話です。 一口にWeb APIといっても要求に対する応答形式は千差万別ですのでさくっとできるとは限りませんが、逆にXMLやJSONであればWeb APIでなくても通用する手法かと思います。 このエントリーは予備知識として、XAMLの基本的な文法、ListBoxのItemTemplateによるデザインやDataBi
HaskellでJSON Web APIを作ると幸せになれるかもよ - Fujimura
先日Yesod勉強会第2回でHaskellでJSON Web APIを作る話しをしました。 内容的には下記のような感じです。 Web開発はクライアントサイドの技術が発達して、Web APIを作る機会が多くなった最近のフロントエンドは難しいし、分業したほうがいいっぽいYesodは独自技術＆フルスタックすぎて分業辛いではscotty + persistent + aesonでJSON Web API作ろうぞなんか想像以上の相性の良さ。幸せになれそうなイキフンがビシビシ来てる発表資料はこちら。 ちなみにscottyはsinatraみたいな奴、aesonはJSONライブラリ、persistentはORマッパーです。 何しろaeson + persistentの相性がバッチリでした。発表後に@thimuraさんが見つけた じつは persistent のスキーマ定義で、テーブル名の横に js
neue cc - C#とLinq to JsonとTwitterのChirpUserStreamsとReactive Extensions
何か盛り沢山になったのでタイトルも盛り沢山にしてみました。SEO(笑) 最近話題のTwitterのChirpUserStreamsを使ってみましょー。ChirpUserStreamsとは、自分のタイムラインのあらゆる情報がストリームAPIによりリアルタイムで取得出来る、というもの。これを扱うには、まずはストリームをIEnumerable化します。そのまま扱うよりも、一度IEnumerable化すると非常に触りやすくなる、というのがLinq時代の鉄則です。C#でのストリームAPIの取得方法は以前にも記事にしましたが、かなり汚かったのでリライト。WebClient愛してる。 public static IEnumerable<XElement> ConnectChirpStream(string username, string password) { const string StreamA
Android：SimpleDateFormatに潜む罠 | 自転車で通勤しましょ♪ブログ
某WebAPIを使っているアプリを作成中です。 そのWebAPIから取得できるJSONに、lastBuildDateという日付を表す項目があったので、せっかくなのでそれをパースして日本語表記で出力しようと思ったのですが、Javaだとどうやって日付の文字列をDateに戻すのだろうと…。 ググったら、SimpleDateFormatというクラスがありました！ lastBuildDateの形式は、”EEE, dd MMM yyyy HH:mm:ss Z”でした。 Wed, 23 Feb 2011 02:55:21 +0900 みたいな感じです。なので、それを指定してみました。 // 失敗・・・ SimpleDateFormat format = new SimpleDateFormat("EEE, dd MMM yyyy HH:mm:ss Z"); // jsonはJSONObject try
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Introduction - 艦これAPIを叩く
HeartRails Express | 路線／駅名／最寄駅データサービス
日本気象協会、「天気予報API」にJSON版を追加、スマホアプリ開発容易に