API - APIドキュメント
- このカテゴリでは、世界で最も人気があるウェブコミック「xkcd」の最新ナンバーをひたすら日本語に翻訳しています。
- 2014年の翻訳記事はxkcd(2014年)、2013年の翻訳記事はxkcd(2013年)から。更に過去の翻訳記事はxkcdからどうぞ。
- 翻訳済みの秀逸なコミックについては、過去のベスト10をまとめた記事(2009年?2010年、2011年、2012年、2013年、2014年)からどうぞ。
- このXKCD翻訳の目的の一つは、僕の英語スキル向上です。誤訳がありましたら、コメントなどで気軽にご指摘下さい。
©xkcd.com Creative Commons Attribution-NonCommercial 2.5 License
API(API)
API Guide
(APIガイド)
Request URL format:
(リクエストURLフォーマット:)
http://~~~.com/<username>/<item ID>
(http://~~~.com/<username>/<item ID>)Server will return an XML document which contains:
(サーバーは、以下を含むXMLドキュメントを返します:)
・The requested data.
(リクエストされたデータ)
・Documentation describing how the data is organized spatially.
(どんなデータを表現する文書が、空間的に構成される。)
API Keys
(APIキー)
To obtain API access, contact the X.509-authenticated server and request an ECDH-RSA TLS key...
(APIアクセスを獲得し、X.509で認証されたサーバーにコンタクトし、ECDH-RSA TLSキーをリクエストします...)If you do things right, it can take people a while to realize that your "API documentation" is just instructions for how to look at your website.
(物事を正しく行うなら、この「APIドキュメント」が君のウェブサイトを見る為の単なる説明だと理解するのに、かなりの時間が取られるだろう。)Alt-text: ACCESS LIMITS: Clients may maintain connections to the server for no more than 86,400 seconds per day. If you need additional time, you may contact IERS to file a request for up to one additional second.
(アクセス制限:クライアントは、1日につき86,400秒しかサーバーへの接続を維持しないかもしれない。さらなる時間が必要ならば、もう1秒追加の要請を届け出る為に、IERSに連絡するのがよいかもしれません。)
補足
単にWebサイトを閲覧するだけのAPIの解説を正しく書こうとすると、とてつもなく読みづらくなり、理解するのに時間がかかる。
XKCD作者が書いた本
XKCDの作者、ランドール マンロー氏の著作本『ホワット・イフ?:野球のボールを光速で投げたらどうなるか』を紹介します。ウェブサイトに投稿された科学のおかしな質問を、XKCDばりの捻くれ方で回答し、それらを本にまとめたものです。こちらも面白いので是非に。
評価: 4.0点
ランドール・ マンロー,吉田 三知世 2015-06-24
Amazonで詳しく見る
楽天市場で探す
Yahooショッピングで探す