Waifu Claim API

Dokumentasi REST API untuk melihat, meng-claim, dan mengelola waifu favoritmu.

Autentikasi

Setiap request ke API ini memerlukan API key yang valid. Kirimkan API key Anda sebagai query parameter bernama apikey.

Contoh Penggunaan API Key:
/api/waifus/random?apikey=your_apikey

Base URL

Semua API Endpoint ada di sini

URL:
https://api.danafxc.my.id/api

Endpoints

GET /waifus/random

Mendapatkan data satu karakter waifu secara acak dari katalog, lengkap dengan daftar gambar yang ditemukan untuknya.

Contoh Request:
https://api.danafxc.my.id/api/waifus/random?apikey=your_apikey
Contoh Respons Sukses (200 OK):
{
    "status": true,
    "message": "Berhasil mendapatkan data acak untuk Rem",
    "data": {
        "character_details": {
            "waifuid": 102,
            "nama": "Rem",
            "anime": "Re:ZERO - Starting Life in Another World"
        },
        "images": [
            "https://safebooru.org/images/....jpg",
            "https://safebooru.org/images/....jpg"
        ]
    }
}
GET /waifus/search

Mencari karakter berdasarkan nama. Jika karakter belum ada di database, API akan mencoba menemukannya dari sumber eksternal dan membuatkan `waifuid` baru secara otomatis.

Query Parameters:
KeyTipeWajibDeskripsi
apikeyStringYaAPI Key Anda yang valid.
namaStringYaNama karakter yang ingin dicari.
Contoh Request:
https://api.danafxc.my.id/api/waifus/search?apikey=your_apikey&nama=Asuna Yuuki
Contoh Respons Sukses (200 OK):
{
    "status": true,
    "message": "Hasil untuk Asuna Yuuki",
    "character_details": {
        "waifuid": 101,
        "nama": "Asuna Yuuki",
        "anime": "Sword Art Online"
    },
    "images": [
        "https://safebooru.org/images/....jpg",
        "https://safebooru.org/images/....jpg"
    ]
}
GET /waifus/ranking

Mendapatkan daftar peringkat waifu berdasarkan jumlah klaim terbanyak.

Contoh Request:
https://api.danafxc.my.id/api/waifus/ranking?apikey=your_apikey
Contoh Respons Sukses (200 OK):
{
    "status": true,
    "message": "Berhasil mendapatkan ranking waifu yang di-claim",
    "data": [
        {
            "waifuid": 102,
            "rankwaifu": 1,
            "nama": "Rem",
            "claimedBy": [ /* ... */ ]
        },
        {
            "waifuid": 101,
            "rankwaifu": 2,
            "nama": "Asuna Yuuki",
            "claimedBy": [ /* ... */ ]
        }
    ]
}
GET /waifus/myclaim

Melihat detail klaim aktif yang dimiliki oleh seorang user.

Query Parameters:
KeyTipeWajibDeskripsi
apikeyStringYaAPI Key Anda.
userIdStringYaID unik user yang ingin dicek.
Contoh Request:
https://api.danafxc.my.id/api/waifus/myclaim?apikey=your_apikey&userId=alpha
Contoh Respons Sukses (200 OK):
{
    "status": true,
    "message": "Berhasil menemukan klaim milik alpha",
    "data": {
        "waifu": {
            "waifuid": 101,
            "nama": "Asuna Yuuki",
            "anime": "Sword Art Online",
            "imgurl": "https://safebooru.org/..."
        },
        "claimDetails": {
            "userId": "alpha",
            "claimedAt": "2025-07-22T10:00:00.000Z",
            "marriedAt": "2025-10-20T10:00:00.000Z"
        }
    }
}
GET /waifus/mymarriage

Melihat detail pernikahan permanen yang dimiliki oleh seorang user.

Query Parameters:
KeyTipeWajibDeskripsi
apikeyStringYaAPI Key Anda.
userIdStringYaID unik user yang ingin dicek.
Contoh Request:
https://api.danafxc.my.id/api/waifus/mymarriage?apikey=your_apikey&userId=beta
Contoh Respons Sukses (200 OK):
{
    "status": true,
    "message": "Berhasil menemukan data pernikahan untuk user beta",
    "data": {
        "userId": "beta",
        "waifu": {
            "waifuid": 102,
            "nama": "Rem",
            "anime": "Re:ZERO",
            "imgurl": "https://safebooru.org/..."
        },
        "marriageDate": "2025-07-22T12:00:00.000Z"
    }
}

Informasi & Update