Mulai cepat
- 1
Daftar gratis lalu buat API key di dashboard.
- 2
Panggil endpoint mana pun dengan header x-api-key.
cURL
curl -H "x-api-key: ga_live_..." "https://kajidata.artonlabs.com/v1/indonesia:hari-libur/check?date=2026-08-17"
Python
import requests
response = requests.get(
"https://kajidata.artonlabs.com/v1/indonesia:hari-libur/check",
params={"date": "2026-08-17"},
headers={"x-api-key": "ga_live_..."},
timeout=30,
)
body = response.json()
print(body["data"] if body["ok"] else body["error"])
JavaScript
const params = new URLSearchParams({"date": "2026-08-17"});
const response = await fetch(`https://kajidata.artonlabs.com/v1/indonesia:hari-libur/check?${params}`, {
headers: { "x-api-key": "ga_live_..." },
});
const body = await response.json();
console.log(body.ok ? body.data : body.error);
PHP
<?php
$ch = curl_init('https://kajidata.artonlabs.com/v1/indonesia:hari-libur/check?' . http_build_query(['date' => '2026-08-17']));
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ga_live_...'],
CURLOPT_TIMEOUT => 30,
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body['ok'] ? $body['data'] : $body['error']);
Go
package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
)
func main() {
params := url.Values{}
params.Set("date", "2026-08-17")
req, _ := http.NewRequest("GET", "https://kajidata.artonlabs.com/v1/indonesia:hari-libur/check?"+params.Encode(), nil)
req.Header.Set("x-api-key", "ga_live_...")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
var body map[string]any
json.NewDecoder(res.Body).Decode(&body)
fmt.Println(body["data"])
}
Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://kajidata.artonlabs.com/v1/indonesia:hari-libur/check?date=2026-08-17"))
.header("x-api-key", "ga_live_...")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
Ruby
require "net/http"
require "json"
uri = URI("https://kajidata.artonlabs.com/v1/indonesia:hari-libur/check")
uri.query = URI.encode_www_form({"date" => "2026-08-17"})
request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "ga_live_..."
response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(request) }
body = JSON.parse(response.body)
puts body["ok"] ? body["data"] : body["error"]
C#
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "ga_live_...");
var json = await client.GetStringAsync("https://kajidata.artonlabs.com/v1/indonesia:hari-libur/check?date=2026-08-17");
Console.WriteLine(json);
Pola URL: GET https://kajidata.artonlabs.com/v1/{category}:{api}/{endpoint}
Autentikasi
Key juga bisa dikirim lewat Authorization: Bearer … atau parameter query api_key (hindari yang terakhir di produksi karena URL tercatat di log). Tambahkan Accept-Language: id untuk pesan error berbahasa Indonesia.
Format respons
Berhasil
{
"ok": true,
"project": "indonesia:hari-libur",
"endpoint": "check",
"data": {
"date": "2026-08-17",
"is_holiday": true,
"name": "...",
"is_weekend": false
},
"meta": {
"request_id": "9f2c1a7b3e5d4c21",
"timestamp": "2026-11-01T05:05:18+00:00",
"latency_ms": 300,
"cached": false,
"stale": false,
"cost": 1,
"quota_remaining": 999,
"source": "Nager.Date",
"fetched_at": "2026-11-01T05:05:18+00:00"
}
}
Gagal
{
"ok": false,
"error": {
"code": "invalid_params",
"message": "...",
"details": [
{
"loc": [
"date"
],
"msg": "..."
}
]
},
"meta": {
"request_id": "...",
"timestamp": "..."
}
}
| Kolom | Arti |
|---|---|
| meta.cached | true: dari cache, tidak ditagih |
| meta.stale | true: sumber gagal dan ini salinan terakhir yang valid |
| meta.cost | kuota yang dipotong request ini |
| meta.source | sumber yang benar-benar menjawab |
| meta.fetched_at | kapan data diambil dari sumber |
Kode error & penagihan
Yang memotong kuota hanya respons 200 yang diambil langsung dari sumber. Cache hit dan salinan stale gratis.
| Kode | HTTP | Ditagih? | Arti |
|---|---|---|---|
| missing_api_key | 401 | tidak | Header x-api-key tidak ada |
| invalid_api_key | 401 | tidak | Key salah atau sudah dicabut |
| plan_required | 403 | tidak | API butuh paket yang lebih tinggi |
| not_found | 404 | tidak | Endpoint atau data (mis. kode wilayah) tidak ada |
| invalid_params | 422 | tidak | details berisi field yang salah |
| rate_limited | 429 | tidak | Melebihi batas request per detik; lihat Retry-After |
| quota_exceeded | 429 | tidak | Kuota bulan ini habis |
| upstream_error | 502 | tidak | Semua sumber gagal dan belum ada salinan tersimpan |
| upstream_timeout | 504 | tidak | Sumber terlalu lama merespons |
| unavailable | 503 | tidak | Gateway sedang tidak tersedia; coba lagi nanti |
Header respons
- X-Request-Id
- Sertakan saat menghubungi dukungan.
- X-Cache
- HIT, MISS, atau STALE.
- X-Request-Cost
- Kuota yang dipakai request ini.
- X-Quota-Remaining
- Sisa kuota bulan ini.
- X-Latency-Ms
- Waktu proses di gateway.
- Retry-After
- Jumlah detik menunggu setelah error rate_limited.
OpenAPI, SDK, dan agen AI
Gunakan generator seperti openapi-generator untuk membuat klien di bahasa apa pun. Untuk agen AI, lihat Server MCP dan llms.txt.