リクエスト情報取得API
どこどこJPのタグを貼っていただいたページのアクセス数を取得することが出来ます。
返されるデータはXMLまたはJSONで取得することが可能です。
Perl、PHPなどの他のプログラムから、間単に利用することができます。(文字コード:UTF-8)
リクエストURL
http://api.docodoco.jp/v3/count?パラメータ名=パラメータ値…
リクエストパラメータ
リクエスト情報の取得API リクエストパラメータ一覧表
| パラメータ名 |
説明 |
値 |
デフォルト値 |
| data |
取得するデータの指定 |
別表1をご参照ください。 |
※必須 |
| key1 |
APIキー1 |
英数字 |
※必須 |
| key2 |
APIキー2 |
英数字 |
※必須 |
リクエスト情報の取得API 別表1 data指定値一覧表
| 値 |
説明 |
期間 |
| DailyAccess |
日別アクセス |
過去11日 |
| MonthlyAccess |
月別アクセス |
過去11ヶ月 |
| HourlyAccess |
時間帯別アクセス |
過去11日の合計 |
| PrefRanking |
都道府県別ランキング |
過去11日 |
| CountryRanking |
国別ランキング |
過去11日 |
リターンパラメータ
DailyAccess:リクエスト情報の取得API リターンパラメータ
| パラメータ名 |
種類 |
説明 |
値、サンプル |
| Description |
データ |
情報名 |
日別アクセス数 |
| Config |
セクション |
出力データ構成 |
data/pv/uu |
| Rows |
セクション |
データ本文 |
Row |
| Row |
セクション |
1日単位の各データを内包 |
data/pv/uu |
| date |
データ |
日付 |
yyy-mm-dd |
| pv |
データ |
ページビュー数 |
数値(3桁区切り) |
| uu |
データ |
ユニークユーザー数 |
数値(3桁区切り) |
MonthlyAccess:リクエスト情報の取得API リターンパラメータ
| パラメータ名 |
種類 |
説明 |
値、サンプル |
| Description |
データ |
情報名 |
月別アクセス数 |
| Config |
セクション |
出力データ構成 |
data/pv/uu |
| Rows |
セクション |
データ本文 |
Row |
| Row |
セクション |
1日単位の各データを内包 |
data/pv/uu |
| date |
データ |
日付 |
yyy-mm |
| pv |
データ |
ページビュー数 |
数値(3桁区切り) |
| uu |
データ |
ユニークユーザー数 |
数値(3桁区切り) |
HourlyAccess:リクエスト情報の取得API リターンパラメータ
| パラメータ名 |
種類 |
説明 |
値、サンプル |
| Description |
データ |
情報名 |
時間別アクセス数 |
| Config |
セクション |
出力データ構成 |
data/pv/uu |
| Rows |
セクション |
データ本文 |
Row |
| Row |
セクション |
1時間単位の各データを内包 |
data/pv/uu |
| date |
データ |
時間 |
0~23 |
| pv |
データ |
ページビュー数 |
数値(3桁区切り) |
| uu |
データ |
ユニークユーザー数 |
数値(3桁区切り) |
PrefRanking:リクエスト情報の取得API リターンパラメータ
| パラメータ名 |
種類 |
説明 |
値、サンプル |
| Description |
データ |
情報名 |
都道府県別ランキング |
| Config |
セクション |
出力データ構成 |
pref_name/pv/uu |
| Rows |
セクション |
データ本文 |
Row |
| Row |
セクション |
各順位のデータを内包 |
pref_name/pv/uu |
| pref_name |
データ |
都道府県名 |
北海道~沖縄県 |
| pv |
データ |
ページビュー数 |
数値(3桁区切り) |
| uu |
データ |
ユニークユーザー数 |
数値(3桁区切り) |
CountryRanking:リクエスト情報の取得API リターンパラメータ
| パラメータ名 |
種類 |
説明 |
値、サンプル |
| Description |
データ |
情報名 |
国別ランキング |
| Config |
セクション |
出力データ構成 |
name/pv/uu |
| Rows |
セクション |
データ本文 |
Row |
| Row |
セクション |
各順位のデータを内包 |
name/pv/uu |
| name |
データ |
国名 |
日本語表記の国名 |
| pv |
データ |
ページビュー数 |
数値(3桁区切り) |
| uu |
データ |
ユニークユーザー数 |
数値(3桁区切り) |
結果
DEMOデータでご確認下さい。
リクエスト情報の取得API エラー
エラーが発生した場合には、以下の情報を返します。
リクエスト情報の取得API エラー一覧表
| 種類 |
ステータス |
メッセージ |
内容 |
| 認証 |
401 |
Unauthorized |
APIキーの認証に失敗 |
Unauthorizedの場合
<?xml version="1.0" encoding="utf-8"?><docodoco><status>401</status><message>Unauthorized</message></docodoco>
