未来へのキオク API 仕様

キオク投稿

POST http://www.miraikioku.com/api/post

概要

Picasa または Youtube に投稿されたキオクを、未来へのキオクに登録します。投稿の流れは以下の通りです。

  1. Picasa / Youtube の API を使用し、画像/動画を投稿します。この際、 miraikioku タグを付与し、位置情報を登録のうえ公開に設定してください。
    - Picasa Web Albums Data API
    https://developers.google.com/picasa-web/
    - YouTube API
    https://developers.google.com/youtube/2.0/developers_guide_protocol_audience
  2. 本 API に画像/動画の URL を渡し、画像/動画を未来へのキオクに登録します。
    (本 API を使用しなくても数時間後に自動登録されますが、本 API を使用することで即時登録されます。)

リクエストパラメータ

パラメータ名 説明 必須 データ型 備考
urls 画像 (Picasa) /
動画 (Youtube) URL
複数指定可能
文字列リスト (カンマ区切り) https://picasaweb.google.com/data/feed /api/user/102727037249677238729 /albumid/5623564068906801233 /photoid/5657709955978895602, http://www.youtube.com/watch?v=0RWS76l2gXg 上限 100。
Picasa の URL は、 https://picasaweb.google.com /data/feed/api/user/{userid} /albumid/{albumid}/photoid /{photoid} の形式で指定。
Youtube は ID のみでも可。
AppEngine の 日本語 Full Text Search を使用。
callback コールバック関数名 文字列 callback 指定すると JSONP で返す

レスポンス (JSON)

要素名 説明 データ型 備考
results 結果オブジェクト
url URL 文字列 https://picasaweb.google.com/data/feed /api/user/102727037249677238729/albumid /5623564068906801233/photoid /5657709955978895602 リクエストパラメータ urls の 1 要素に対応
id キオクID 文字列 5657709955978895602
status ステータス 文字列 (ok/error) ok
message エラーメッセージ 文字列 miraikiokuタグがありません ステータスが OK の場合は要素なし