たんっ！ API

たんっ！ APIでは下記の呼び出しを行うことが出来ます。

1. 短縮URL 生成 [shorturl]
2. 生成したURL のクリック数や詳細を取得する [url-stats]
3. 短縮後のURLから長いURLを取得する [expand]（ログイン不要）
4. たんっ！ のバージョンを知る [version] （ログイン不要）

API利用にあたり準備するもの

• [たんっ！]短縮URL〜 メールに記載されている パスワード [shorturl][url-stats]利用時
• 上記メールを受信したメールアドレス [shorturl][url-stats]利用時
• 短縮URL [url-stats][expand]利用時

API接続情報

APIへの接続先 URL	https://su2.me/api.php
返却フォーマット	json または xml

コマンドと必須項目

コマンド	必須項目	パラメータ値
shorturl	url action format email api_key keyword（任意）	長いURL shorturl json or xml 一度取得したことがあるメールアドレス 上記の際のAPI_KEY（パスワード） 任意でURLにつけられる（4文字以上）
url-stats	shorturl action format email api_key	短くしたURL url-stats json or xml 一度取得したことがあるメールアドレス 上記の際のAPI_KEY（パスワード）
expand	shorturl action format	短くしたURL expand json or xml
version	action format	version json or xml

API 呼び出しサンプル PHP

実行結果

—- shorturl —-
{“api_key”:”SU2_live_5ba2084a8e3ac”,”timelimit”:0,”url”:”https:\/\/blog.gti.jp\/post-88\/”,”status”:”success”,”message”:”https:\/\/blog.gti.jp\/post-88\/ added to database”,”title”:”https:\/\/blog.gti.jp\/post-88\/”,”shorturl”:”https:\/\/su2.me\/s7wpf”,”statusCode”:200,”email”:”test@example.com”}
—- url-stats —-
{“statusCode”:200,”message”:”success”,”link”:{“shorturl”:”https:\/\/su2.me\/s7wpf”,”url”:”https:\/\/blog.gti.jp\/post-88\/”,”title”:”https:\/\/blog.gti.jp\/post-88\/”,”timestamp”:”2018-09-19 17:26:53″,”ip”:”203.104.193.44″,”clicks”:”0″}}
———- expand: s7wpf —–
{“keyword”:”s7wpf”,”shorturl”:”https:\/\/su2.me\/s7wpf”,”longurl”:”https:\/\/blog.gti.jp\/post-88\/”,”title”:”https:\/\/blog.gti.jp\/post-88\/”,”message”:”success”,”statusCode”:200}
———- version —–
{“version”:”1.0.1″}

APIご利用上の注意

• APIを利用した shorturl によるURL短縮の場合、「[たんっ！]短縮URL有効化のお願い」メールは送信されません。
• APIを利用した shorturl によるURL短縮の場合、有効化の処理は不要となりそのまま利用可能となります。
• APIを利用した shorturl によるURL短縮の場合、「[たんっ！]短縮URL登録されました」メールがURL短縮ごとに送信されますので大切に保管してください。
• API KEY は有効な短縮URLかつ同一メールアドレスであればどれでも同様に利用することが出来ます。
• APIを利用してURL短縮を行った場合に生じたエラー、不具合や仕様変更などにより利用者に生じた損害について、一切責任を負わないものとします。
• API KEY 及びメールアドレスに関して、当該の利用が利用者自身によるものであるか否かを問わず、利用者本人による利用とみなし、一切の義務と責任を負いません。
• その他、本サービスを停止すること、ならびに停止できなかったことによってお客様、ご利用者及び第三者が損害を被った場合も、当社は一切の賠償責任を負いません。

本マニュアルは機能追加または削除および改修により随時改定されます。

株式会社ジーティーアイ 佐藤 毅

改訂履歴

2020年9月24日 初版