Instal aplikasi Vivoldi dari Google Play untuk membuatnya lebih nyaman.

API Developer URL Pendek Vivoldi

API Developer Vivoldi memungkinkan Anda mengintegrasikan fitur pemendek URL, manajemen tautan, dan pelacakan klik langsung ke website, aplikasi mobile, maupun sistem internal menggunakan REST API dan respons JSON.

Semua API menyediakan data JSON yang terstruktur dan dapat digunakan dengan lancar di berbagai lingkungan pengembangan seperti JavaScript, Python, Java, PHP, Android, iOS, serta platform lain yang mendukung permintaan HTTP.

Autentikasi API

Semua permintaan API memerlukan API key di header Authorization.
API key dapat dibuat di halaman Developer API pada dashboard.

Authorization: APIKey {Your API Key}

Apa Itu API Developer Vivoldi?

API Developer Vivoldi adalah REST API yang memungkinkan integrasi fitur pemendek URL dan manajemen tautan langsung ke website, aplikasi mobile, maupun sistem internal perusahaan.

Tidak hanya untuk membuat tautan pendek, API ini juga dapat digunakan untuk mengotomatiskan berbagai fitur Vivoldi seperti statistik klik, manajemen grup tautan, pembuatan kode QR, kupon digital, dan fitur stamp.

Contoh Penggunaan Utama

  • Membuat short URL otomatis untuk kampanye marketing
  • Mengoptimalkan pembagian tautan produk di platform eCommerce
  • Mengotomatiskan laporan dan analitik klik di sistem internal
  • Menggabungkan deep link dan short URL untuk meningkatkan instalasi aplikasi
  • Mengelola tautan otomatis untuk media sosial, SMS, dan email marketing

Persiapan Sebelum Menggunakan API

Untuk menggunakan API Vivoldi, Anda perlu membuat akun dan menghasilkan API key terlebih dahulu.
API key yang telah dibuat dapat dimasukkan ke header Authorization untuk mengakses REST API berbasis HTTPS.

Langkah 1 — Buat Akun Vivoldi

Setelah mendaftar, Anda sudah dapat menggunakan fitur API melalui paket gratis.
Paket berbayar menyediakan batas penggunaan API yang lebih tinggi serta fitur tambahan lainnya.

Langkah 2 — Generate API Key

Setelah login, Anda dapat membuat API key melalui halaman Developer API di dashboard.
Demi keamanan, simpan API key di environment variable server atau backend agar tidak terekspos secara publik.

Langkah 3 — Uji Request API Pertama

Masukkan API key Anda ke header Authorization lalu kirim request POST ke endpoint di bawah untuk membuat short URL.

Setelah semuanya siap, Anda dapat mulai mengintegrasikan Vivoldi ke berbagai layanan menggunakan panduan API dan contoh kode berikut.

Cara memanggil API

API Vivoldi dibangun menggunakan arsitektur REST API berbasis HTTPS.
Setiap request wajib menyertakan autentikasi menggunakan API Key pada HTTP Header, dan Content-Type harus diatur ke application/json.

Semua respons dikembalikan dalam format JSON dengan struktur yang konsisten berupa code, message, dan result.
Nilai 0 pada code menandakan request berhasil diproses, sedangkan kode dan pesan error dapat digunakan untuk implementasi exception handling maupun penanganan kegagalan request.

Request 
Host: https://vivoldi.com/api/{uri}
Authorization: APIKey {Your API Key}
Content-type: application/json
User-Agent: {Your User-Agent}
Accept-Language: en
Response 
{
	"code": 0,
	"message": "",
	"result": Object
}
Bidang Deskripsi Jenis
code Kode respons. Nilai 0 menunjukkan berhasil, sedangkan nilai selain 0 menunjukkan gagal.
Kode ini terpisah dari status HTTP dan hanya dikembalikan jika status HTTP berada dalam kisaran 2xx atau 3xx.

int
message Hanya disertakan jika code tidak sama dengan 0. Menyediakan pesan kesalahan yang menjelaskan kegagalan.
Bisa kosong atau tidak disertakan jika permintaan berhasil.		 string
result Data sebenarnya yang dikembalikan oleh API. Formatnya dapat berupa String atau Objek JSON, tergantung jenis API. object

Examples:

Vivoldi menyediakan contoh kode REST API untuk berbagai lingkungan pengembangan seperti JavaScript, PHP, dan Java.
Contoh di bawah ini menggunakan API pembuatan short URL (/api/v2/create), sehingga Anda dapat langsung melakukan pengujian hanya dengan mengganti API Key dan domain.

Dengan struktur request dan response berbasis JSON, API ini dapat diintegrasikan dengan mudah ke website, dashboard admin, sistem internal, platform marketing automation, dan berbagai layanan lainnya. 

<!DOCTYPE html>
<html>
<head>
	<meta charset="utf-8"/>
	<script src="https://code.jquery.com/jquery-4.0.0.min.js" crossorigin="anonymous"></script>
</head>

<body>

<form id="exampleForm">
	<button id="btnCreateLink" type="button">Create Link</button>
</form>

<script type="text/javascript">
$(function(){
	$("#btnCreateLink").on('click', function(evt){
		evt.preventDefault();

		$.ajax({
			type: 'POST',
			url: 'https://vivoldi.com/api/link/v2/create',
			data: JSON.stringify({'url':'https://google.com','domain':'https://vvd.bz'}),
			headers: {'Authorization':'APIKey oc3w9m4ytso9mv5e8yse9XXXXXXXXXX'},
			contentType: 'application/json; charset=utf-8',
			dataType: 'json',
			timeout: 5000
		}).done(function(res){
			if (res.code === 0) {
				alert('short url: ' + res.result);
			} else {
				alert('code: ' + res.code + ', message: ' + res.message);
			}
		}).fail(function(xhr, textStatus, e){
			alert('error: ' + e);
		});
	});
});
</script>

</body>
</html>
<?php
$url = "https://vivoldi.com/api/link/v2/create";
$params = array (
	"url" => "https://www.facebook.com/vivoldi365",
	"domain" => "https://vvd.bz",
);
$body = json_encode($params);

$headers = array(
	"Authorization: APIKey oc3w9m4ytso9mv5e8yse9XXXXXXXXXX",
	"Content-Type: application/json"
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HEADER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10000);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);

$result = curl_exec($ch);

if ($result === FALSE) {
     echo "Error sending: " . curl_error($ch);
} else {
     print_r($result);
}
curl_close($ch);
?>
package com.example;

import org.json.JSONObject;
import org.springframework.http.HttpStatus;

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class CreateLink {
    public static void main(String[] args) {
        try (HttpClient client = HttpClient.newBuilder().build()) {
            JSONObject params = new JSONObject();
            params.put("url", "https://www.facebook.com/vivoldi365");
            params.put("domain", "https://vvd.bz");

            HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://vivoldi.com/api/link/v2/create"))
                .header("Content-Type", "application/json")
                .header("Authorization", "APIKey oc3w9m4ytso9mv5e8yse9XXXXXXXXXX")
                .POST(HttpRequest.BodyPublishers.ofString(params.toString()))
                .build();

            HttpResponse<String> response;
            try {
                response = client.send(request, HttpResponse.BodyHandlers.ofString());
            } catch (Exception e) {
                throw new RuntimeException(e);
            }

            if (response != null) {
                if (response.statusCode() == HttpStatus.OK.value()) {
                    String jsonString = response.body();
                    if (jsonString != null && !jsonString.isEmpty()) {
                        JSONObject json = new JSONObject(jsonString);
                        if (json.getInt("code") == 0) {
                            System.out.println("Short URL: " + json.getString("result"));
                        } else {
                            System.out.println("Failed: " + String.format("[%d] %s", json.getInt("code"), json.getString("message")));
                        }
                    }
                }
            }
        }
    }
}
Silakan hubungi Vivoldi jika Anda membutuhkan peningkatan atau modifikasi REST API.