Skip to main content
本文では、長いURLを短いURLに変換するShort URL APIの接続説明を紹介します。

​
申請プロセス

Short URL APIを使用するには、まずAce Data CloudコンソールにアクセスしてAPIトークンを取得し、保管してください。 まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。 1つのAPIトークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソールで一般残高をチャージできます。
📘 完全なドキュメント：Short URL API →

​
基本使用

まず、基本的な使用方法を理解します。変換したい長いURLを入力することで、処理された結果を得ることができます。まず、簡単にcontentフィールドを渡す必要があります。次に、画面上に対応する内容を入力できます。以下のように：

ここでは、リクエストヘッダーを設定しました。内容は以下の通りです：
  • accept：受け取りたいレスポンス結果の形式。ここではapplication/json、つまりJSON形式を記入します。
  • authorization：APIを呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
また、リクエストボディを設定しました。内容は以下の通りです：
  • content：短縮するURLの内容。
選択後、右側にも対応するコードが生成されていることがわかります。以下のように：

「Try」ボタンをクリックするとテストが行えます。上の図のように、以下の結果が得られました：
返された結果には複数のフィールドがあり、以下のように説明できます：
  • success：ここでのタスクが成功したかどうかの状態。
  • data：ここで変換されたURLを含みます。
元の長いURL https://platform.acedata.cloud/documents/shorturl が、短いURL https://surl.id/1uHCs01xa5 に成功裏に変換されたことがわかります。 また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURLのコードは以下の通りです：
Pythonの接続コードは以下の通りです：

​
エラーハンドリング

APIを呼び出す際にエラーが発生した場合、APIは対応するエラーコードとメッセージを返します。例えば：
  • 400 token_mismatched：不正なリクエスト、パラメータが不足または無効である可能性があります。
  • 400 api_not_implemented：不正なリクエスト、パラメータが不足または無効である可能性があります。
  • 401 invalid_token：未認証、無効または不足している認証トークン。
  • 429 too_many_requests：リクエストが多すぎます、レート制限を超えました。
  • 500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。

​
エラー応答の例

​
結論

この文書を通じて、Short URL APIを使用して長いURLを短いURLに変換する方法を理解しました。この文書が、APIの接続と使用をより良くする手助けとなることを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。