円分Rマイページ新規会員登録ログインくまポンAPI(beta)について目次:くまポンAPI(beta)について1.エリア一覧取得API2.クーポンデータ取得APIくまポンAPI(beta)についてくまポンAPI(beta)とは?「くまポンbyGMO」では、掲載されているクーポンの情報などの一部をhttp経由で得ることができるAPIを提供しております。毎日更新される多彩なクーポンの情報を、サイト・WEBサービスのコンテンツとしてご活用いただけます。各情報に対応するURLをリクエストすることで、XML,JSON,JSONPなどの形式でレスポンスを得ることができます(UTF-8エンコード)。データの詳細な形式等については、各APIの資料をご参照ください。通信プロトコルはhttpのみとなっております。くまポンAPI(beta)ご利用上の注意点API利用登録などの手続きは不要で、どなたでもご使用になれます。APIの仕様、およびご利用方法については本ページの各APIについての仕様をご参照ください。本APIによって得られる情報は、リアルタイムな情報となっています。「くまポンbyGMO」で販売されるクーポンは毎日追加・更新され、また販売状況によって残り枚数などの情報が随時変動するため、本APIを利用した情報の表示を行うサービスにおいては、可能な限り最新の情報を取得したうえで表示を行っていただくようお願いいたします。本APIを通して得られた情報について、データを正しくない情報に改変した上で公開することはできません。本APIを通して得られた情報について、これを販売するなどの二次的な利用を行うことはできません。サーバーに負荷のかかる高頻度のアクセス等、弊社が適当でないと認める使用が行われていると判断した場合には、予告無くAPIの停止、制限、または仕様の変更を行う場合がございます。本APIは現在ベータ版(試験運用版)です。本APIはその動作について予告無く仕様の変更または停止行う場合があります。そのような仕様の変更または停止があった場合を含め、本APIを直接に利用したことによって生じたいかなる損害についても、「くまポンbyGMO」の運営会社であるGMOくまポン株式会社はその責任を負いかねます。本APIから得られる情報に基づいてサービス・情報を公開したことによる損害、またはそれらの公開されたサービス・情報を利用またはダウンロードしたことによって利用者に生じたいかなる損害についても、同様に責任を負いかねます。更新履歴[2014/06/16]クーポンの総在庫数を削除しました。レスポンスデータからタグを削除しました。[2014/02/25]ジャンルを追加しました。クーポンデータ取得APIにタグを追加しました。[2012/01/18]画像サイズを追加しました。クーポンデータ取得APIにタグを追加しました。[2011/01/28]ベータ版(試験運用版)リリース。エリア一覧取得APIが利用可能になりました。クーポンデータ取得APIが利用可能になりました。1.エリア一覧取得APIくまポン(http://kumapon.jp/)で現在購入可能なクーポンが販売されているエリアの一覧情報を取得できます。このAPIのレスポンスにおけるgroup(エリアの番号)の値を指定することで、そのエリアグループに含まれるエリアの情報のみを得ることができます。エリアグループとは、通常都道府県の範囲を指し、エリアとは各都道府県の中における地域を指します。このAPIのレスポンスにおけるid(エリアの番号)の値を指定することで、そのエリアの情報のみを得ることができます。取得するデータのフォーマットを指定します。拡張子がjsonである場合、このパラメータを指定するとjsonpデータが得られます。指定したパラメータの値がjsonpの関数名となります。レスポンスデータレスポンスは、エリア情報のレコードが1つ〜複数含まれたものが取得できます。エンコード(jsonの場合)されています。配下ノードに複数のareaデータを持ちます。配下ノードにエリア情報の各項目を持ちます。エリアの日本語名称です。エリアグループ(都道府県)固有の番号です。APIのバージョンです。エリア固有の番号です。配下ノードに複数のdealデータを持ちます。販売されるクーポン(商品)固有の番号です。</area></areas>レスポンスデータの例(JSON)URLhttp://api.kumapon.jp/areas.json[{"name":"\u57fc\u7389\u770c","group":"21","deal":"237","area":"21"},{"name":"\u57fc\u7389\u770c","group":"21","deal":"239","area":"21"},{"name":"\u5343\u8449\u770c","group":"23","deal":"237","area":"23"},{"name":"\u5343\u8449\u770c","group":"23","deal":"239","area":"23"},{"name":"\u65B0\u5BBF\u99C5\u5468\u8FBA","group":"25","deal":"239","area":"25"},{"name":"\u795e\u5948\u5ddd\u770c","group":"27","deal":"237","area":"27"},{"name":"\u795e\u5948\u5ddd\u770c","group":"27","deal":"239","area":"27"},{"name":"\u4E0A\u91CE\u99C5\u5468\u8FBA","group":"25","deal":"237","area":"95"}]レスポンスデータの例(JSONP)URLhttp://api.kumapon.jp/areas.json?callback=jsonp_callbackjsonp_callback([{"name":"\u57fc\u7389\u770c","group":"21","deal":"237","area":"21"},{"name":"\u57fc\u7389\u770c","group":"21","deal":"239","area":"21"},{"name":"\u5343\u8449\u770c","group":"23","deal":"237","area":"23"},{"name":"\u5343\u8449\u770c","group":"23","deal":"239","area":"23"},{"name":"\u65B0\u5BBF\u99C5\u5468\u8FBA","group":"25","deal":"239","area":"25"},{"name":"\u795e\u5948\u5ddd\u770c","group":"27","deal":"237","area":"27"},{"name":"\u795e\u5948\u5ddd\u770c","group":"27","deal":"239","area":"27"},{"name":"\u4E0A\u91CE\u99C5\u5468\u8FBA","group":"25","deal":"237","area":"95"}])2.クーポンデータ取得APIクーポン番号を指定して、販売されているクーポンの詳細情報を取得できます。クーポン(商品)ごとに一意な番号を指定。エリア一覧取得APIなどで得られる。取得するデータのフォーマットを指定します。レスポンスデータレスポンスは、1つのクーポンの情報であり、以下の情報を持ちます。エンコード(jsonの場合)されています。クーポンのタイトルです。配下ノードに複数の商品画像情報(image)を持ちます。配下ノードに商品画像情報の各項目(max,large,small,thumb)を持ちます。大サイズ(400×267pixel)の商品画像のURLです。大サイズ(660×440pixel)の商品画像のURLです。通常サイズ(218×138pixel)の商品画像のURLです。サムネイルサイズ(95×63pixel)の商品画像のURLです。クーポンの販売開始日時です。クーポンの販売終了日時です。購入したクーポンが利用可能になる日時です。クーポンの利用期限です。クーポンのサブタイトルです。クーポンの参考価格(割引前の価格)です。