2010-12-24

(開発者向け) はてなハイク1.1とのAPI互換性について

はてなハイクの新バージョンでも、現行バージョンと同等の API や RSS を提供しています。現行バージョンのはてなハイクで動作するアプリケーションは新バージョンでもそのまま動作することを意図していますが、開発者のみなさまにはよろしければベータテスト期間中に動作確認していただきますようお願い致します。

新バージョンで動作した、あるいは動作しなかったというご報告は、是非「はてなハイク1.1」キーワードでお聞かせください。

新バージョンのはてなハイクでは、API に次の変更を加えています。

OAuth に対応しました

認証方式として OAuth に対応しました。読み取り操作については read_public 権限、書き込み・削除操作については write_public 権限で行えます。

これまでの HTTP Basic 認証も引き続き提供しますが、今後は非推奨とし、 OAuth の利用を推奨します。 Basic 認証を廃止する予定は現時点ではございませんが、 OAuth への移行の状況を見て検討していきます。

@ による自動返信機能を廃止しました

statuses/update の status には

先頭の @id は id さんの最後のエントリーへの返信になります。
http://developer.hatena.ne.jp/ja/documents/haiku/apis/rest#statuses-update

... との機能がありましたが、API 独自の機能であり混乱を招くため、新バージョンでは廃止します。「@id」は単なる文字列として扱います。返信としたい場合は明示的に in_reply_to_status_id で返信先エントリーの ID を指定してください。

キーワード一覧の `without_related_keywords` 引数を新設しました

キーワード一覧を取得する keywords/list と keywords/hot に新たに引数として without_related_keywords を追加しました。 without_related_keywords=1 とすることで、関連キーワードのリストが結果に含まれなくなります。関連キーワードの情報を利用しないアプリケーションでは、より高速に動作するこのオプションの利用を推奨します。

ファン・お気に入りキーワードの一覧に `page` 引数を新設しました

ファンの一覧を取得する statuses/followers とお気に入りキーワードの一覧を取得する statuses/keywords に新たに引数として page を追加しました。これらの一覧に含まれるユーザーやキーワードは1ページあたり最大100件までで、それ以上は page=2 などと指定すると取得できます。これはお気に入りユーザーの一覧 statuses/friends と同じ仕様です。

Web ページのフォームにフィルインできるようになりました

API ではありませんが、はてなハイクの URL に引数として word や body を

http://h1beta.hatena.ne.jp/?word=Hatena%20Haiku&body=Hello,%20New%20Haiku!

... のように指定することで、お題や本文に文字列を指定した状態でページを開くことができるようになりました。

ドメインについて

ベータテスト用のドメイン h1beta.hatena.ne.jp は、ベータテスト終了後もしばらくは残す予定ですが、事前の告知なしに廃止する可能性がありますのでご注意ください。

2010-12-24

はてなハイク1.1のベータテストを開始しました

本日、はてなハイクの新バージョンの公開ベータテストを開始しました。新バージョンのテスト環境には次の URL でアクセス可能です。

http://h1beta.hatena.ne.jp/ (パソコンから)
http://h1beta.hatena.ne.jp/touch/ (スマートフォン、ニンテンドー DSi から)
(携帯電話から)

ベータテストの目的

はてなでは、現在はてなハイクの新バージョンを開発中です。はてなハイクの新バージョンでは、みなさまにより快適にご利用いただけるよう、様々な機能追加と改良を行っています。本ベータテストは、新バージョンのはてなハイクを実際にご利用いただき、みなさまからご意見・ご感想をいただくことを目的としております。また、はてなハイク APIなどを使ったアプリケーションの開発者のみなさまには、よろしければアプリケーションが問題なく動作することをベータテスト期間中にご確認いただきたいと考えております。

はてなハイクの新バージョンをご利用になってのご意見、ご要望、お気づきの点などがございましたら、是非とも「はてなハイク1.1」キーワードでお聞かせください。個別にご返信は致しかねますが、開発・運営の参考にさせていただきます。

なお、ベータテスト中は機能の大幅な追加や削除などを行ったり、一時的にサービスを中断したりすることがあります。ご了承ください。

投稿データの扱い

新バージョンのテスト環境は、「Following」ページを除き、正式版と同じデータベースを用いています。新バージョンへの投稿は旧バージョンにも反映されますし、旧バージョンへの投稿も新バージョンで閲覧できます。ただし、以下の制限がございます。

変更が伝播するまでに多少の時差が生じることがあります。
「Following」ページに関しては、新バージョンへの投稿が二重に表示されることがあります。
新バージョンからの投稿を旧バージョンで削除すると、一部で削除されずに残ることがあります。

新バージョンの主な変更点

旧バージョンからの主な変更点を簡単に紹介します。ベータテストの状況によっては予定を変更する可能性もございますので、詳しくは正式版の公開の折に改めてご案内いたします。

ページ遷移なしに投稿や閲覧を行える場面が増えました

キーワードページや自分のユーザーページなどへの投稿の際、ページ全体の再読み込みが発生しないようになりました。また、他の人から新しい投稿があると通知が出るようになりました。通知をクリックすると新しい投稿を読むことができます。 (これらの新機能はお使いの機種や Web ブラウザーによっては動作しません。)

スマートフォンやニンテンドー DSi のための表示モードを新設しました

スマートフォンの Web ブラウザーやニンテンドー DSi ブラウザーのための表示モードを新設しました。これまでスマートフォンやニンテンドー DSi の方には旧来の携帯電話用のモバイル版をご案内してきましたが、専用のモードでより快適に閲覧・投稿できるようになりました。iPhone、ニンテンドー DSi などでは簡易版のお絵かき機能もご利用いただけます。スマートフォン・DSi ブラウザー版はてなハイクには次の URL でアクセスできます。

http://h1beta.hatena.ne.jp/touch/

(設定を変更することによってパソコン版やモバイル版も引き続きご利用いただけます。お絵かきは機種によっては動作しないことがあります。)

ニックネームが表示されるようになりました

投稿者名やユーザーページタイトルの名前の表示などにニックネームを使うようにしました。これまではニックネームを設定していても一部のページにしか表示されていませんでしたが、今後は基本的にニックネームで表示されるようになります。 (はてなIDが必要なときには、ユーザーページの「プロフィール」の欄で確認できます。)