Archives | Tumblr | Facebook | bullet-feed.pngRSS

xkcd: API - APIドキュメント

  • このカテゴリでは、世界で最も人気があるウェブコミック「xkcd」の最新ナンバーをひたすら日本語に翻訳しています。
  • 2014年の翻訳記事はxkcd(2014年)、2013年の翻訳記事はxkcd(2013年)から。更に過去の翻訳記事はxkcdからどうぞ。
  • 翻訳済みの秀逸なコミックについては、過去のベスト10をまとめた記事(2009年?2010年2011年2012年2013年2014年)からどうぞ。
  • このXKCD翻訳の目的の一つは、僕の英語スキル向上です。誤訳がありましたら、コメントなどで気軽にご指摘下さい。

api.png
©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の解説を正しく書こうとすると、とてつもなく読みづらくなり、理解するのに時間がかかる。

このエントリーをはてなブックマークに追加

関連性が高いおすすめ記事


comments powered by Disqus