API

Đăng ký khóa API

Như trước, một khóa API được yêu cầu cho các yêu cầu được xử lý bởi hệ thống. Sau khi người dùng đăng ký, một khóa API được tạo tự động cho người dùng này. Khóa API phải kèm theo yêu cầu thông qua tham số api (xem ví dụ đầy đủ dưới đây).

Gửi yêu cầu rút ngắn URL

Để gửi một yêu cầu, người sử dụng phải sử dụng định dạng sau đây, nơi các biến api và url được yêu cầu. Trong ví dụ dưới đây, URL của demo được sử dụng nhưng bạn nên sử dụng tên miền riêng của bạn. Để yêu cầu một bí danh tùy chỉnh, chỉ cần thêm & custom = vào cuối.

  GET http://lit.vn/short/api?api=APIKEY&url=THELONGURLTOBESHORTENED&custom=CUSTOMALIAS

Phản hồi của máy chủ

Như trước, phản hồi sẽ được mã hoá ở định dạng JSON (mặc định). Điều này được thực hiện để tạo thuận lợi cho việc sử dụng chéo ngôn ngữ. Yếu tố đầu tiên của phản hồi sẽ luôn luôn cho biết nếu một lỗi đã xảy ra (lỗi: 1) hay không (lỗi: 0). Phần tử thứ hai sẽ thay đổi đối với phần tử đầu tiên. Nếu có lỗi, phần tử thứ hai sẽ được đặt tên là "msg". Trong đó chứa các nguồn lỗi, nếu không nó sẽ được đặt tên là "ngắn" có chứa các URL ngắn. (Xem ví dụ bên dưới)

URL. (See below for an example)

// No errors
{
  "error":0,
  "short":"http:\/\/lit.vn\/short\/DkZOb"
}
// An error has occurred
{
  "error":1,
  "msg":"Please enter a valid email"
}

Sử dụng định dạng văn bản thuần túy

Bây giờ bạn có thể yêu cầu phản hồi ở trong văn bản thuần bằng cách thêm & format = văn bản vào cuối yêu cầu của bạn. Điều này sẽ trở lại chỉ http://lit.vn/short/DkZOb thay vì phản hồi JSON. Lưu ý rằng nếu một lỗi xảy ra, nó sẽ không xuất ra bất cứ điều gì.

Sử dụng API trong PHP

Để sử dụng API trong ứng dụng PHP của bạn, bạn phải gửi một yêu cầu GET thông qua file_get_contents hoặc cURL: Cả hai đều là các phương pháp đáng tin cậy. Bạn có thể xem mã mẫu bên dưới bằng cách sử dụng file_get_contents.


// Using JSON Response
  $api_url="http://lit.vn/api?api=APIKEY&url=THELONGURLTOBESHORTENED&custom=CUSTOMALIAS";
  $res= @json_decode(file_get_contents($api_url),TRUE);
  if($res["error"]){
    echo $res["msg"];
  }else{
    echo $res["short"];
  }

  // Using Plain Text Response
  $api_url="http://lit.vn/api?api=APIKEY&url=THELONGURLTOBESHORTENED&custom=CUSTOMALIAS&format=text";
  $res= @file_get_contents($api_url);
  if($res){
    echo $res;
  }
?>

Wir sind dabei

Facebook Likes

Like uns auf FacebookFolge uns auf Twitter