R1 URL短縮サービス - APIページ

• TOPページ
• ユーザー登録
• 補助ソフトウェア
• クリック数確認
• API仕様参照

API仕様

短縮API

http://api.r1.gs/postapi
POST形式で
・username
・authkey
・LongURL
に値をセットして送りつけるとXMLのレスポンスが返ってきます。

オプション
・permに1をセットいたしますとそのURLは永続URLとして削除されないURLになります。

実際に動作確認をして頂くことも可能です
サンプル
<?xml version="1.0" encoding="UTF-8"?> <response> <res status="ok"/> <status>TRUE</status> <urlstatus>http://r1.gs/S8xje</urlstatus> </response>

短縮APIその他のレスポンス

<res status="ok"/> 正常なリクエストです。 <res status="failed" /> エラーが発生しています。詳細はstatusをご覧ください。 <status>TRUE</status> 正常なリクエストです。 <status>Registered</status> 既にURLが登録されています。 <status>Bad_URL</status> URLとして不適切な文字列が入っています。エンコードしてからPOSTしてください。 <status>Key_Miss_Mach</status> 認証に失敗しました。 <status>Not_AuthKey</status> Authkeyがありません。 <status>Not_Username</status> Usernameがありません。

復号API

http://api.r1.gs/restore
POST形式で
・url
（例 url=http://r1.gs/S8xje
セットし送りますとXMLのレスポンスが返ってきます。
実際に動作確認をして頂くことも可能です
サンプルは以下の様になります。
<?xml version="1.0" encoding="UTF-8"?> <response> <res status="ok"/> <status>TRUE</status> <urlstatus> http://best-network.jp/ </urlstatus> </response>

クリック数API

http://api.r1.gs/click_api
に対して以下の値をPOSTしてください。
・key:短縮されたURL
例）
key:http://r1.gs/clB6A
レスポンスとして以下のようなXMLが返ってきます。
<response> <res status="ok"/> <status>TRUE</status> <click>100</click> </response>
その他のレスポンス
<response> <res status="failed"/> <status>No_Result</status> </response> これは送られてきたURLに対してデータを保持していないことを示します。 <response> <res status="failed"/> <status>No_Service</status> </response> これは当サービス以外のURLが送られてきた事を示します。

ページのトップへ戻る