Ketika industri pemasaran pertama kali bergeser dari pemasaran keluar ke pemasaran masuk, banyak pemasar melepaskan peran lama mereka sebagai pengganggu konten untuk yang baru sebagai pembuat konten.
Tetapi pergeseran itu masih menghasilkan gempa susulan, dan untuk mengimbangi pesaing Anda saat ini, Anda perlu memahami apa itu API, bagaimana mereka berintegrasi dengan Anda. strategi konten, dan wawasan sosial yang mereka bawa ke situs web Anda.
Jangan khawatir – API mungkin tampak rumit, tetapi di akhir posting ini, Anda akan tahu cara kerjanya dan apa yang diperlukan untuk menggunakannya.
Berikut adalah definisi singkat tentang API, diikuti dengan beberapa informasi penting tentang cara membuatnya berfungsi untuk bisnis Anda.
Apa itu API?
API, kependekan dari antarmuka pemrograman aplikasi, adalah serangkaian aturan. Untuk lebih jelasnya, ini adalah perantara informasi. API memungkinkan aplikasi mengekstrak informasi dari perangkat lunak dan menggunakan informasi itu dalam aplikasinya sendiri, atau terkadang untuk analisis data.
Sederhananya, API adalah cetak biru yang memungkinkan “barang Anda” untuk berbicara dan bekerja dengan “barang mereka”. Barang Anda, dalam hal ini, dikenal sebagai titik akhir API.
Apa itu titik akhir API?
Titik akhir API adalah tujuan digital tempat API mengirim permintaan informasi dari aplikasi web atau server dan tempat API menerima respons dan mengakses sumber daya yang diperlukan untuk menjalankan fungsinya.
Kedengarannya membingungkan? Jangan khawatir – kami akan membahas contoh di bawah ini.
Contoh API Endpoint
Katakanlah Anda ingin mengalirkan tweet publik secara real-time sehingga Anda dapat terus mendapat informasi tentang topik minat tertentu atau tren terkini di dunia. Kemudian Anda bisa menggunakan Titik akhir streaming Twitter yang difilter. URL-nya adalah: https://api.twitter.com/2/tweets/search/stream
Secara teknis, titik akhir API hanya perlu dirujuk dengan jalur akhir dari URL sumber daya. Jalur dasar, yang umum untuk semua titik akhir, adalah https://api.twitter.com. Karena itu tetap sama, tidak perlu terus-menerus mencantumkannya. Sebagai gantinya, Anda dapat mencantumkan titik akhir: / 2 / tweets / search / stream.
Cara Menguji Endpoint API
Ada beberapa alat online yang tersedia untuk menguji titik akhir API. Demi postingan ini, kami akan menjelaskan cara menyiapkan pengujian menggunakan cURL. keriting adalah alat baris perintah untuk mentransfer data yang mendukung banyak protokol, termasuk HTTP. Ia mampu membuat permintaan, mendapatkan data, dan mengirim data – menjadikannya alat yang sempurna untuk meminta informasi dari API.
Mari gunakan contoh dari Dokumentasi Twitter sendiri. Katakanlah, Anda ingin terus mendapat informasi tentang API Twitter. Maka Anda akan ingin mendapatkan tweet dari akun-akun besar seperti @TwitterDev dan @TwitterAPI segera setelah mereka diposting. Dan mungkin Anda hanya menginginkan tweet yang berisi tautan ke artikel atau dokumentasi sehingga Anda mendapatkan konteks sebanyak mungkin.
Dalam hal ini, menggunakan titik akhir aliran yang difilter adalah pilihan yang tepat. Tetapi agar titik akhir mengetahui jenis tweet apa yang akan dikirimkan kepada Anda, Anda harus menentukan kriteria pemfilteran. Jika tidak, Anda hanya akan meminta untuk melihat setiap tweet yang diposting secara real-time.
Kriteria pemfilteran akan diterapkan ke titik akhir dalam bentuk aturan. Untuk membuat aturan ini, Anda memerlukan sekumpulan operator. Untuk contoh ini, Anda dapat menggunakan dua operator – dari: dan memiliki: tautan – untuk hanya melihat tweet dari akun tertentu dan yang berisi tautan. Untuk menginstruksikan titik akhir aliran yang difilter agar hanya menampilkan tweet dari akun @Twitterdev dan @TwitterApi yang berisi tautan, Anda akan menggunakan aturan berikut: “Dari: twitterdev from: twitterapi memiliki: tautan”
Untuk meminta informasi ini dari titik akhir aliran yang difilter, Anda perlu menyertakan permintaan HTTP yang benar untuk memberi tahu API tindakan yang harus diambil. Ada empat opsi utama. Lihat deskripsi singkat masing-masing di bawah ini:
- GET: ambil sumber daya
- POST: buat sumber daya
- PUT: perbarui sumber daya yang ada
- HAPUS: menghapus sumber daya
Untuk contoh ini, Anda akan menggunakan permintaan POST. Selain menyertakan aturan yang disebutkan di atas dalam permintaan Anda, Anda akan menyertakan tipe konten dan otorisasi. Di bawah tipe konten didefinisikan sebagai “application / json” sehingga permintaan diberikan dalam format data ringan JavaScript Object Notation (JSON). Untuk mengautentikasi permintaan Anda, Anda harus mengganti teks placeholder $ BEARER_TOKEN dengan keunikan aplikasi Anda Token Pembawa, yang dapat dibuat di portal pengembang Anda.
curl -X POST 'https://api.twitter.com/2/tweets/search/stream/rules'
-H "Content-type: application/json"
-H "Authorization: Bearer $BEARER_TOKEN" -d
'{
"add": [
{"value": "from:twitterdev from:twitterapi has:links"}
]
}'
Mengapa API penting?
Salah satu pertanyaan pertama yang ditanyakan banyak pemasar adalah: Mengapa semua bisnis ini membagikan datanya secara terbuka, gratis?
Biasanya, jawabannya adalah: skala. Ketika perusahaan perangkat lunak tumbuh, staf di dalam perusahaan tersebut dengan cepat menyadari bahwa mereka memiliki lebih banyak ide daripada waktu dan sumber daya untuk mengembangkannya.
Dengan membuat API, perusahaan mengizinkan pengembang pihak ketiga membuat aplikasi yang dapat meningkatkan penggunaan dan adopsi platform utama. Dengan cara itu, bisnis dapat membangun ekosistem yang bergantung pada data dari API mereka – dinamika yang sering kali mengarah pada peluang pendapatan tambahan.
Cara Menggunakan API
Memahami nilai API tertentu pada dasarnya adalah tentang memahami informasi apa yang tersedia melalui API dan bagaimana informasi itu dapat diakses. Untuk mengetahui apa yang dapat dilakukan API untuk Anda, Anda dapat melakukan salah satu dari dua hal.
- Minta pengembang web untuk melihat API dan mendiskusikannya dengan Anda.
- Lakukan riset sendiri. Jika Anda tidak memiliki akses atau anggaran untuk menggunakan pengembang web, ini adalah opsi yang menarik. Tapi jangan panik – banyak layanan online memiliki dokumentasi API yang bagus.
Dokumentasi API
Mari kita lihat sekilas Indeks referensi API Twitter sebagai contoh.
Sebagian besar pertumbuhan Twitter disebabkan oleh pengembang luar, dan yang pertama API Twitter dimulai sebagai wiki dasar. Sejak itu, telah berkembang menjadi detail indeks API yang dapat digunakan oleh pemasar yang cerdas untuk menentukan informasi apa yang mungkin tersedia bagi pengembang dalam bentuk API – dan cara memasukkan API ini di situs web Anda.
Melihat tangkapan layar di atas, Anda dapat melihat ada beberapa kategori informasi yang tersedia untuk pengembang luar. Setelah Anda memilih API yang Anda minati, Anda dapat mengekliknya untuk melihat informasi apa yang tersedia melalui API ini. Periksa Titik akhir API Garis Waktu Tweet Twitter di bawah.
Dalam dokumentasi API di atas, API Garis Waktu Tweet Twitter menjelaskan bagaimana Anda dapat mengambil kumpulan singkat tweet terbaru dari garis waktu pengguna tertentu dan menampilkannya, dalam bentuk yang dapat diklik, di situs web Anda sendiri. Dokumentasi API mencakup batasan volume tweet, URL sumber daya API, serta apa yang Anda bisa dan tidak bisa pilih untuk ditampilkan melalui API ini.
Menerapkan API ke Situs Anda
Jika Anda menambahkan URL sumber daya API ke bagian belakang situs web Anda, itu akan mengembalikan informasi yang Anda panggil ke bagian depan situs web Anda. Inilah tampilannya di Pelari Jalan New York situs web, membantu mereka mempromosikan New York City Marathon (dengan beberapa modifikasi desain khusus):
Anda juga dapat melihat file Dokumentasi HubSpot API untuk melihat bagaimana Anda dapat membangun aplikasi dan integrasi menggunakan data dari HubSpot.
Satu peringatan terakhir: Untuk menggunakan API pengembang secara resmi, Anda mungkin juga perlu diberi kunci API.
Apa itu kunci antarmuka pemrograman aplikasi (API)?
Kunci API adalah pengenal unik yang ditetapkan ke pengguna API, yang menunjukkan bahwa mereka diizinkan untuk menggunakan antarmuka pemrograman aplikasi di situs web mereka. Banyak pengembang meminta Anda untuk meminta kunci ini sebelum menggunakan API, sementara yang lain mungkin menetapkannya untuk Anda saat permintaan API pertama Anda.
Pikirkan kunci API Anda sebagai token autentikasi, yang menyatakan Anda sebagai anggota komunitas pengembang. Akibatnya, token ini mengidentifikasi untuk apa Anda menggunakan API, dan memverifikasi bahwa Anda telah diberi izin untuk melaksanakan proyek ini oleh pemilik API.
Yakinlah, kunci API Anda melakukannya tidak memberi pengembang akses ke informasi pribadi tentang Anda.
API sebagai Platform Pemasaran
Pemasaran di dunia masuk adalah tentang perusahaan yang mengembangkan aplikasi dan layanan yang berguna untuk mempertahankan retensi pelanggan. Merek perlu beralih dari iklan yang kadang-kadang berhenti menjadi saluran komunikasi konsumen.
Dalam proses tersebut, API memfasilitasi data yang dibutuhkan untuk memberikan solusi atas permasalahan pelanggan.
Contoh API
Memahami informasi apa yang tersedia melalui API akan membantu Anda menentukan apakah perlu bekerja sama dengan pengembang untuk melanjutkan proyek lebih jauh. Berikut dua contoh.
Sebutan Twitter
Jika Anda ingin menampilkan tweet di situs web Anda yang menyertakan mention di Twitter untuk artikel dari blog Anda, Anda perlu memahami apakah Anda dapat meminta tweet dengan hanya URL tertentu dari API Twitter.
Penyematan Video YouTube
Saat Anda mengeklik kanan video YouTube di youtube.com, dan memilih “Salin Kode Semat,” pada dasarnya Anda meminta untuk menggunakan API YouTube di situs web Anda. YouTube memberikan kemudahan bagi publik untuk menyematkan video YouTube untuk diputar langsung di situs web lain.
Persyaratan Layanan API
Apa pun proyeknya, Anda harus benar-benar membaca dan memahami persyaratan layanan untuk API yang Anda pertimbangkan untuk situs web Anda.
Sebagian besar API memiliki batasan penggunaan tertentu. Jika Anda tidak meluangkan waktu untuk memahami batasan API yang Anda minati, Anda dapat menginvestasikan lebih banyak waktu dan uang untuk mengembangkan aset pemasaran yang dianggap tidak berguna setelah penyedia API menentukan bahwa Anda telah melanggar persyaratan layanan API (dan mencabut akses Anda).
Karena alasan ini, sebagian besar API memiliki “batas panggilan”.
Apa itu panggilan API?
Panggilan API, juga dikenal sebagai permintaan API, adalah instance dari pemilik situs web yang “memanggil” untuk menggunakan API pengembang. Menyimpan API, masuk ke situs web pengembang, dan pertanyaan tentang aplikasi semuanya dihitung sebagai panggilan API.
Dengan pemikiran ini, batas panggilan API adalah berapa kali Anda dapat meminta informasi tentang API dari layanan web dalam jangka waktu tertentu. Sekali lagi, harap baca persyaratan penggunaan untuk API apa pun yang ingin Anda gunakan. Dokumen-dokumen ini harus secara jelas menjelaskan batasan apa pun serta penggunaan program yang sesuai.
Masa Depan API dalam Bisnis
Mengembangkan API layanan web yang ada hanyalah permulaan. Kita hidup di dunia yang sekarang mengharapkan konten terbuka dan tersedia untuk semua – perkembangan alami ini adalah untuk penerbit itu sendiri untuk merilis API mereka sendiri, sehingga mereka sebagai hasilnya pelanggan dapat mengembangkan aplikasi.
Berbagi API berlaku untuk semua bisnis – tidak hanya bisnis yang berbasis web, tetapi siapa pun yang memiliki alat atau komponen berbasis web dari organisasinya. Tentunya konsep ini dapat menimbulkan kendala bagi beberapa organisasi, terutama dari departemen hukum. Terserah Anda untuk mencari tahu API mana yang paling berharga dan bagaimana Anda dapat menggunakannya secara sah dan berkelanjutan.
Catatan Editor: Posting ini awalnya diterbitkan pada Maret 2013 dan telah diperbarui agar lebih lengkap.
