ポンパレWebサービス: ご利用案内

利用制限について

IPアドレスでの利用制限

サーバーへの負荷が一時的に高くなりすぎるのを避けるため、ある決められた短い時間のなかで、各IPアドレスのリクエスト数に制限を設けています。
制限の上限を超えた場合は、一定時間ロックがかかりますので、リクエストが再び利用できるようになるまでしばらくお待ちください。
また、利用制限の条件に関しては、公開していません。

利用制限の上限に達した場合

リクエストの頻度が利用制限の上限を超えた場合、APIへのリクエストに対して下記の様なレスポンスが返されます。

<?xml version="1.0" encoding="UTF-8"?> 
<error xmlns="ponws"> 
 <message>>サーバは一時的な過負荷かサーバのメンテナンスの為現在リクエストを扱うことができません。</message>
</error>

APIキー「sample」の利用期限

APIキー「sample」の利用期限を延長しました - 2010/12/24

APIキーの「sample」は、2011年2月22日AM5:59を利用期限とさせていただきます。その後もご利用いただく場合は、APIキーを発行いただくことになる予定です。

エラーについて

エラーメッセージおよびコード

API利用時に何か問題がある場合は、エラーレスポンスを受けます。

エラーメッセージ

返される可能性のあるエラーメッセージは以下のとおりです。

状況 メッセージ内容
アクセス負荷が高い場合 サーバは一時的な過負荷かサーバのメンテナンスの為現在リクエストを扱うことができません。
セキュリティエラーの場合 アクセスが拒否されました。
アカウント(APIキー)エラーの場合 不正なアカウントです。
リクエストパラメータが不正の場合 大エリア、中エリア、小エリア、チケットIDの何れかのパラメータが不正です。

エラーレスポンス例

XMLフォーマットの場合、各エラーについて、次のようなレスポンスを受け取ります。

<?xml version="1.0" encoding="UTF-8"?> 
<error xmlns="ponws"> 
 <message>エラーメッセージ</message>
</error>

バージョンの管理について

ポンパレWebサービスのバージョン

ポンパレWebサービスでは、各APIをバージョン別に管理しています。
ポンパレWebサービスで提供されている各APIは、それぞれのXMLスキーマによって構造が決められているため、 情報の活用がしやすいのですが、機能の修正や、新しい機能の追加によって、各APIの構造が変わる場合があります。
このような仕様変更があると、それまで各APIを利用して動いていたプログラムやアプリケーションは動かなくなってしまいます。 これらを避けるため、バージョン別に管理しています

クレジット表示について

ポンパレWebサービスでは、ポンパレWebサービスで提供されるAPIを利用して作成されたサイト・アプリケーションに、 簡単に表示できる画像形式とテキスト形式のクレジットを用意しています。

これらのクレジットは、アプリケーションやサイトが、ポンパレWebサービスの提供するAPIを利用していることを示すとともに、 その利用が「ポンパレWebサービスの利用規約」に従っていることを表します。
ポンパレWebサービスの提供するAPIを利用するすべてのアプリケーションやサイトには、クレジットを表示する必要があります。

クレジットを表示するときの注意

クレジットを表示する場合は、規定のHTMLソースを利用してください。 HTMLのソースの改変や、画像の改変が行われた場合などには、 ポンパレWebサービスが提供するAPIの利用を停止させていただく可能性があります。

クレジットの表示方法

1. クレジットの選択

表示形式 クレジット HTMLソース
a 画像形式 135px×17px 135x17px <a href="https://ponpare.jp/doc/ws/"><img src="https://ponpare.jp/doc/ws/img/pws_135_17.gif" alt="ポンパレ Web サービス" title="ポンパレ Web サービス" border="0"></a>
b 画像形式 88px×35px 88x35px <a href="https://ponpare.jp/doc/ws/"><img src="https://ponpare.jp/doc/ws/img/pws_88_35.gif" alt="ポンパレ Web サービス" title="ポンパレ Web サービス" border="0"></a>
c 画像形式 88px×50px 88x50px <a href="https://ponpare.jp/doc/ws/"><img src="https://ponpare.jp/doc/ws/img/pws_88_50.gif" alt="ポンパレ Web サービス" title="ポンパレ Web サービス" border="0"></a>
d テキスト形式 ポンパレWebサービス <a href="https://ponpare.jp/doc/ws/">ポンパレWebサービス</a>

2.クレジットの表示位置

画像形式、テキスト形式にかかわらず、表示位置は自由ですが、 そのアプリケーションやサイトがポンパレWebサービスの利用の上に制作されていることがわからなくなるような表示の仕方はできません。

ポンパレWebサービスのご利用にあたって

必ずリクルートWEBサービスの利用規約をお守り下さい。
※ポンパレWebサービスは、リクルートWEBサービスの利用規約に準拠します。

ポンパレの定期メンテナンスについて

ポンパレでは、システムメンテナンスの為、下記時間帯において、以下のサービスが一時停止いたします。
ご迷惑おかけいたしますが、あらかじめご了承くださいますようお願いいたします。

定期メンテナンスのお知らせ

こちらをご確認ください