Pengembang

Mendapatkan API Key RATA.IN

Untuk mendapatkan API key RATA.IN, Anda harus membuat akun terlebih dahulu melalui halaman ini.

Jika Anda sudah memiliki akun RATA.IN, maka silahkan login melalui halaman ini dan pilih menu Pengaturan. Di halaman pengaturan, Anda bisa mendapatkan API key dibagian kanan bawah halaman.

Mengirim Permintaan Penyingkat URL

Untuk mengirimkan permintaan penyingkatan URL, Anda harus mengikuti format berikut dimana API key dan URL diperlukan.

 GET http://rata.in/api?api=APIKEYANDA&url=URLANDA&custom=CUSTOMALIAS

Respon Server RATA.IN

Respon berbentuk format JSON (default). Elemen pertama adalah untuk pengecekan error (error = 1) atau tidak (error = 0) kemudian untuk elemen kedua akan mengikuti hasil dari pengecekan error pada elemen pertama. Jika ada error, maka elemen kedua ini akan berisikan pesan error, jika tidak maka akan muncul hasil URL yang sudah disingkat. Contoh:

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

Menggunakan Format Plain Text

Anda dapat meminta respon dalam format plain text dengan menambahkan kode: &format=text dibagian akhir dari URL permintaan Anda. Ini akan menghasilkan respon berupa URL yang sudah disingkat saja bukan dalam bentuk format JSON. Catatan: Jika terjadi error, maka tidak menampilkan apapun dalam hasilnya.

Menggunakan API key RATA.IN dalam PHP

Untuk menggunakan API key dalam aplikasi PHP, Anda harus mengirimkan permintaan GET melalui file_get_contents atau cURL: 

Keduanya adalah metode yang bisa digunakan. Berikut contoh kode menggunakan file_get_contents.

<?php
  // Menggunakan respon JSON
  $api_url="http://rata.in/api?api=APIKEY&url=URLANDA&custom=CUSTOMALIAS";
  $res= @json_decode(file_get_contents($api_url),TRUE);
  if($res["error"]){
    echo $res["msg"];
  }else{
    echo $res["short"];
  }

  // Menggunakan respon TEXT
  $api_url="http://rata.in/api?api=APIKEY&url=URLANDA&custom=CUSTOMALIAS&format=text";
  $res= @file_get_contents($api_url);
  if($res){
    echo $res;
  }
?>