Pengantar API AffiliMate
Selamat datang di Developer Hub AffiliMate. API kami dirancang secara profesional untuk membantu Anda mengintegrasikan software automasi, chatbot, bot Threads, Telegram, atau aplikasi pihak ketiga Anda ke platform management affiliate AffiliMate secara realtime.
Penting: Izin Akses Admin
Fitur API Key ini secara default terkunci bagi semua pengguna baru. Pastikan status Akun Anda telah diaktifkan di panel Admin Console sebelum mencoba memanggil endpoint di bawah ini. Hubungi Admin jika Anda membutuhkan approval instan.
Autentikasi & Base URL
Setiap request ke server API AffiliMate wajib menyertakan API Key yang valid. Anda dapat melewatkan API Key ini dengan 3 metode alternatif berikut:
X-API-Key
Direkomendasikan. Kirim key langsung di HTTP Header.
Authorization: Bearer <key>
Standard industri modern. Sangat aman dan fleksibel.
?api_key=<key>
Sangat cocok untuk testing cepat langsung via browser client.
Base Production URL
https://affilimate.online/api/v1/
Sistem Credit & Pemakaian Developer API
Sebagai pengembang pihak ketiga, Anda dapat membangun tools kustom Anda sendiri (seperti bot Telegram, aplikasi CLI, atau scheduler lokal) yang terintegrasi dengan data AffiliMate. Berikut adalah aturan pemotongan credit untuk pemanggilan API:
Semua pemanggilan API untuk manajemen data link, seperti:
- Mengambil list project (
list_projects) - Mengambil detail project & daftar link (
get_project) - Menyisipkan/menambah link baru (
add_link)
Aksi ini tidak dipungut biaya apa pun agar developer bebas melakukan pengelolaan data.
Pemotongan credit hanya berlaku untuk request yang melibatkan kecerdasan buatan (Gemini AI) atau auto-posting cloud:
- Generasi deskripsi produk menggunakan AffiliMate AI.
- Memicu aksi posting otomatis dari jarak jauh.
Kalkulasi Pemotongan Credit (Jika Memakai AI):
Sistem kami menghitung pemakaian token AI secara presisi dan murah:
- 1 Credit = 100 Token Gemini AI.
- Rumus pemotongan:
Jumlah Credit = ceil((Input Token + Output Token) / 100). - Sebagai simulasi, 1 postingan AI produk menghabiskan sekitar 1.200 token (~800 input + ~400 output) yang setara dengan 12 credit per post.
1. List Data Projects
Endpoint ini mengembalikan daftar seluruh project (Link Generator atau Bank Konten) yang dimiliki oleh akun user tersebut.
Query Parameters
| Parameter | Tipe | Keterangan |
|---|---|---|
action |
string (Wajib) | Wajib diisi dengan nilai list_projects |
type |
string (Opsional) | Filter tipe project: link_generator atau bank_konten |
Response Sukses (JSON - 200 OK)
{
"success": true,
"total": 1,
"data": [
{
"project_id": "proj_xyz123",
"owner_uid": "user_abc456",
"type": "link_generator",
"title": "Produk Affiliate Shopee Terbaik",
"slug": "produk-affiliate-shopee-terbaik",
"drive_folder": "1BIPxYLL87UK...",
"permission": "view",
"updated_at": "2026-05-17 18:24:45"
}
]
}
2. Get Project Detail & Links
Endpoint ini digunakan untuk mengambil data lengkap dari satu project spesifik, termasuk daftar semua item/produk dan link affiliate yang tersimpan di dalamnya.
Query Parameters
| Parameter | Tipe | Keterangan |
|---|---|---|
action |
string (Wajib) | Wajib diisi dengan nilai get_project |
project_id |
string (Wajib) | ID unik dari project yang ingin Anda lihat datanya. |
Response Sukses (JSON - 200 OK)
{
"success": true,
"data": {
"project_id": "proj_xyz123",
"owner_uid": "user_abc456",
"type": "link_generator",
"title": "Produk Affiliate Shopee Terbaik",
"slug": "produk-affiliate-shopee-terbaik",
"drive_folder": "1BIPxYLL87UK...",
"permission": "view",
"updated_at": "2026-05-17 18:24:45",
"links": [
{
"id": 1,
"productName": "Botol Minum Olahraga Thermos",
"description": "Botol minum anti panas kualitas premium ukuran 1 liter",
"mainLink": "https://shope.ee/main-botol-premium",
"secondLink": "https://tokopedia.link/second-botol-premium"
}
]
}
}
3. Add New Affiliate Link
Gunakan endpoint ini untuk memasukkan data link affiliate baru (Nomor urut, deskripsi, nama produk, link utama, & link alternatif) ke dalam project Anda secara otomatis.
JSON Body Parameters (Payload)
| Field Name | Tipe | Keterangan |
|---|---|---|
project_id |
string (Wajib) | ID Project tujuan tempat link akan disisipkan. |
product_name |
string (Wajib) | Nama produk affiliate yang ingin Anda tambahkan. |
main_link |
string (Wajib) | URL/Link affiliate utama (e.g. Shopee Affiliate Link). |
description |
string (Opsional) | Deskripsi penjelas/ulasan singkat produk. |
second_link |
string (Opsional) | Link alternatif (e.g. Tokopedia / Lazada Affiliate Link). |
Example JSON Payload
{
"project_id": "proj_xyz123",
"product_name": "T-Shirt Oversize Premium",
"description": "Bahan katun combed 24s adem nyaman dipakai",
"main_link": "https://shope.ee/oversize-premium",
"second_link": "https://tokopedia.link/oversize"
}
Example Response (200 OK)
{
"success": true,
"message": "New link successfully added to the project",
"sequence_number": 2,
"added_item": {
"id": 2,
"description": "Bahan katun combed 24s adem...",
"productName": "T-Shirt Oversize Premium",
"mainLink": "https://shope.ee/oversize-premium",
"secondLink": "https://tokopedia.link/oversize"
}
}
Interactive Integration Examples
Salin snippet kode di bawah ini untuk memulai integrasi software/bot Anda secara instan:
// 1. Contoh Memanggil List Projects via cURL
curl -X GET "https://affilimate.online/api/v1/?action=list_projects" \
-H "X-API-Key: aff_YOUR_SECRET_API_KEY"
// 2. Contoh Menambah Link Baru (POST) via cURL
curl -X POST "https://affilimate.online/api/v1/?action=add_link" \
-H "X-API-Key: aff_YOUR_SECRET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"project_id": "proj_xyz123",
"product_name": "Speaker Bluetooth JBL",
"description": "Speaker wireless bass mantap tahan air",
"main_link": "https://shope.ee/jbl-speaker",
"second_link": "https://tokopedia.link/jbl-speaker"
}'