Tutorial Laravel 5.5 - Membuat URL Shortener / Pemendek URL dengan Cuttly Gratis

Pada artikel kali ini saya akan menjelaskan bagaimana cara untuk melakukan url shortener dengan menggunakan API dari Cutt.ly yang disediakan secara gratis. Fungsi dari URL Shortener atau pemendek URL ini biasanya saya gunakan saat melakukan share suatu url ke sosial media Twitter dikarenakan adanya limitasi jumlah karakter yang bisa digunakan pada Twitter. Berikut ini adalah langkah-langkah cara pembuatan URL Shortener tersebut :

#REGISTER ACCOUNT

Langkah pertama adalah melakukan registrasi dan aktivasi akun pada web Cutt.ly ini terlebih dahulu. Caranya adalah dengan membuka alamat url di https://cutt.ly/register dan melakukan registrasi. Kemudian anda akan menerima email yang berisi link untuk melakukan aktivasi dari akun yang anda daftarkan sebelumnya, Lakukan login dan kemudian akan muncul halaman seperti gambar di bawah ini

#MENDAPATKAN API KEY

Hal berikutnya yang perlu dilakukan adalah mendapatkan api key. API Key ini nantinya akan kita gunakan sebagai salah satu parameter saat kita menggunakan api dari Cutt.ly ini. Cara untuk mendapatkan api key adalah dengan memilih menu Edit Account yang merupakan salah satu sub menu dari menu Your Account yang terdapat pada bagian kanan atas. 

API Key terdapat pada bagian yang saya sensor pada gambar di atas. Jika anda baru melakukan pendafataran dan aktifasi akun maka api key anda masih kosong. Cara untuk melakukan generate API key adalah dengan menekan tombol Change API Key. Kemudian anda akan mendapatkan API Key anda pada bagian yang yang saya sensor tersebut. Simpan data API Key tersebut karena akan kita gunakan dalam program Laravel selanjutnya. 

#CARA PENGGUNAAN

Langkah-langkah pada bagian ini adalah langkah-langkah yang dilakukan pada bagian Laravel. 

#INSTALL PLUGIN GUZZLE

Caranya adalah dengan mengetikkan kode berikut ini pada command prompt

composer require guzzlehttp/guzzle

Tunggu sampai proses download dan instalasi selesai.

#PENGGUNAAN PADA LARAVEL

Pada bagian ini akan saya jelaskan bagaimana cara membuat URL Shortener ini dengan menggunakan Laravel. Perhatikan contoh kode berikut ini :

        $api_key = "YOUR API KEY";

        $url = "https://ozkadon.blogspot.com/";

        $name = "ozkadon-blog";

        $client = new \GuzzleHttp\Client();

        $response = $client->request('GET', 'https://cutt.ly/api/api.php?key='.$api_key.'&short='.$url.'&name='.$name);

        $data = json_decode ($response->getBody(), true);

        dd($data);

Cara untuk melakukan URL Shortener adalah dengan menggunakan Guzzle untuk mengakses url https://cutt.ly/api/api.php yang disertai dengan beberapa parameter. Parameter pertama adalah API Key yang anda miliki yang telah saya jelaskan pada bagian sebelumnya. Parameter kedua adalah URL penuh yang ingin anda persingkat dengan menggunakan program ini dan parameter ketiga adalah nama alias yang ingin anda gunakan. Parameter ketiga ini bukan parameter yang wajib anda isi. 

        $response = $client->request('GET', 'https://cutt.ly/api/api.php?key='.$api_key.'&short='.$url.'&name='.$name);

Contoh kode di atas digunakan untuk mendapatkan data dari URL https://cutt.ly/api/api.php dengan parameter-parameter yang diperlukan. Nantinya data tersebut akan kembali berupa string json yang perlu dilakukan proses decode untuk memprosesnya. Caranya terdapat pada kode berikut ini :

        $data = json_decode ($response->getBody(), true);

Nilai dari $data tersebut akan mengembalikan nilai status yang dapat diakses dengan cara sebagai berikut 

        $status = $data['url']['status'];

Berikut ini adalah keterangan dari nilai status tersebut :

• 1 : the shortened link comes from the domain that shortens the link, i.e. the link has already been shortened.
• 2 : the entered link is not a link.
• 3 : the preferred link name is already taken
• 4 : Invalid API key
• 5 : the link has not passed the validation. Includes invalid characters
• 6 : The link provided is from a blocked domain
• 7 : OK - the link has been shortened

Jika nilai status adalah 7 yang menunjukkan bahwa proses shorten sukses maka akan terdapat nilai-nilai lain dari $data yang dapat kita kelola dengan keterangan sebagai berikut :

$data["url"]["date"] - date of shortening the link

$data["url"]["shortLink"] - shortened link

$data["url"]["fullLink"] - original link

$data["url"]["title"] - website title

Jadi untuk mendapatkan shorten url lebih baik anda melakukan pengecekan terhadap nilai status terlebih dahulu. Dan jika nilai status adalah 7 baru anda melakukan proses selanjutnya dengan ketentuan seperti pada contoh kode di atas ini.

Demikianlah penjelasan saya pada artikel Tutorial Laravel 5.5 - Membuat URL Shortener / Pemendek URL dengan Cuttly Gratis. Untuk informasi penggunaan yang lebih lengkap dapat anda baca pada url berikut ini : https://cutt.ly/cuttly-api. Nantinya pada artikel selanjutnya akan saya jelaskan bagaimana cara untuk mendapatkan data analytic dari shorten url ini contohnya adalah data jumlah click pada link tersebut. Semoga artikel penjelasan ini dapat mudah dipahami. Silahkan gunakan kolom komentar untuk menyampaikan pertanyaan-pertanyaan anda jika ada. Terima kasih.