DIV CSS 佈局教程網

用 jQuery 與 Ajax 呼叫新浪微博 API 產生短網址
編輯:JQuery特效代碼     

新浪微博開放平台提供了短鏈服務,把長網址換成 t.cn 開頭的短網址。因為它支援 JSONP,所以可以純前端呼叫,不需要自己的伺服器中轉。

<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>取得新浪短網址</title>
<script src="https://ajax.aspnetcdn.com/ajax/jQuery/jquery-1.8.0.js"></script>
</head>
<body>
<label for="long">長網址:</label>
<input value="https://example.com/a/very/long/path" id="long"><br><br>

<label for="app_key">輸入您的 app_key(沒有可到網上搜尋):</label><br>
<input value="211160679" id="app_key"><br><br>

<span id="short">短網址:</span><br><br>
<span id="dlgcy">呼叫網址:</span><br><br>

<button type="button" id="btn">Click me</button>
</body>

<script type="text/javascript">
  $(document).ready(function () {
    $("#btn").click(function () {
      var $short  = $("#short");
      var long    = $("#long").val();          // 取得長網址
      var url2    = "https://api.weibo.com/2/short_url/shorten.json";
      var app_key = $("#app_key").val();       // app_key 無效會導致沒有反應
      var cmd2    = url2 + "?source=" + app_key + "&url_long=" + encodeURIComponent(long);

      var message = "";
      $.ajax({
        url: cmd2,
        type: "GET",
        dataType: "jsonp",   // 用 JSONP 繞過跨域限制
        cache: false,
        success: function (data, status) {
          for (var x in data.data.urls[0]) {
            message += x + '=' + data.data.urls[0][x] + '&';
          }
          alert("Data:\n" + message + "\n\nStatus: " + status);
          $short.append(data.data.urls[0].url_short + "<br>");
          $("#dlgcy").text(cmd2);
        },
        error: function (obj, info, errObj) {
          alert("$.ajax() 中發生錯誤:" + info);
        }
      });
    });
  });
</script>
</html>

幾個實作要點

  • JSONP 是唯一選擇。微博的 API 位於不同網域,瀏覽器的同源政策會阻擋普通的 XHR 請求,因此必須指定 dataType: "jsonp"。
  • 長網址要編碼。網址中的 &、?、= 若不編碼會被誤認為參數分隔符,所以必須用 encodeURIComponent() 處理。原範例直接拼接是有問題的。
  • JSONP 沒有真正的錯誤處理。由於它靠動態插入 script 標籤實作,error 回呼在部分情境下不會觸發。若需要可靠的失敗提示,應改用支援 CORS 的後端代理。
  • app_key 請勿寫死在前端。範例中的 key 是公開測試值,實務上應由自己的後端保管並轉發請求。

關於這份程式碼的現況

需要說明的是,範例中的微博 API 位址(api.weibo.com/2/)與 CDN 上的 jQuery 1.8.0 都已年代久遠,實際呼叫很可能失敗。若要在新專案中實作短鏈功能,建議:

  • 改用目前仍在服務的短網址服務,並先查閱其官方文件的端點與鑑權方式。
  • 由後端代理呼叫,把金鑰留在伺服器端。
  • 為失敗情境設計明確的提示與重試機制。

這個範例的價值主要在示範「JSONP + 第三方開放 API」的組合方式,理解之後換成任何支援 JSONP 的服務都能套用。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved