Hatena::Grouphatenadeveloper

はてなグラフ数値登録API

ja/graph/apis/post

はてなグラフ数値登録API

このAPIは非推奨です。現在ははてなグラフ API をご利用ください。

本ドキュメントについて

本ドキュメントははてなグラフにおける、『グラフデータ登録API』の実装を解説するものです。

API仕様の解説

任意のグラフ名、日付、データをPOSTリクエストにより送信することで、グラフの作成、データ追加を行うことの出来るAPIです。

認証

OAuth

本 API は OAuth によるユーザー認証に対応しています。 OAuth 認証の詳細に関しては、はてなのOAuthを利用する方法を参照してください。

本 API の利用には write_private 操作の承認を得ている必要があります。

WSSE

OAuth のかわりに WSSE 認証も利用できます。詳しくははてなサービスにおけるWSSE認証をご覧ください。

利用方法

このAPIは非推奨です。現在ははてなグラフ API をご利用ください。

エンドポイントURIに対し、application/x-www-form-urlencodedのデータをPOSTしてください。

エンドポイントは次のURIです。

使用可能なキーは以下の通りです。

graphname
グラフの名前(UTF-8)
date
YYYY-MM-DD形式の日付(省略可:省略時は今日の日付)
value
グラフの値

指定されたグラフ名に該当するグラフが存在しない場合はグラフ作成を行った後データ追加、存在する場合は該当日付のデータ上書きを行います。

また、dateが省略された場合は、登録時の日付が自動で設定されます。

リクエストの成否は、レスポンスコードを参照してください。正しく作成された場合は201が返ります。

サンプルプログラム

Perl 版

非推奨

認証にはLWP::Authen::Wsseを使用しています。

#!/usr/bin/perl
use strict;
use warnings;
use LWP::UserAgent;
use DateTime;

my $ua = LWP::UserAgent->new;
$ua->credentials('graph.hatena.ne.jp:80', '', 'username', 'password');
my $res = $ua->post( 'http://graph.hatena.ne.jp/api/post', {
    graphname => 'graphname',
    date => DateTime->now->ymd,
    value => rand(10)
});
warn $res->content unless $res->code == 201;
exit;

Ruby 版

非推奨

gem から Hatena::API::Graph パッケージをインストールします。

# gem install hatenaapigraph
require 'rubygems'
require 'hatena/api/graph'

graph = Hatena::API::Graph.new('username', 'password')
graph.post('graphname', Time.now, rand(10))

tar からインストールしたい場合は

http://rubyforge.org/projects/hatenaapigraph/

からどうぞ。

※ruby は 1.8.4 以降のバージョンを利用する必要があります。

変更履歴

  • 2013年7月24日 OAuth 対応
  • 2007年6月12日 非推奨に
  • 2006年10月26日 dateパラメータの省略に対応
  • 2006年10月16日 リリース