مستندات API

محافظت با رمز عبور

با اضافه کردن فیلد password، لینک با رمز عبور محافظت می‌شود. کاربران قبل از هدایت باید رمز را وارد کنند.

{
    "url": "https://example.com/secret-document",
    "password": "myStrongPassword123"
}

تاریخ انقضا

با اضافه کردن فیلد expires_at می‌توانید تاریخ انقضای لینک را مشخص کنید.

فرمت‌های قابل قبول:

• "7d" - ۷ روز بعد
• "30d" - ۳۰ روز بعد
• "2025-12-31 23:59:59" - تاریخ دقیق

{
    "url": "https://example.com/temporary-link",
    "expires_at": "7d"
}

پایتون (Python)

import requests

API_KEY = "your_api_key_here"

def shorten_url(url, password=None, expires_at=None):
    headers = {
        "X-API-Key": API_KEY,
        "Content-Type": "application/json"
    }
    data = {"url": url}
    if password:
        data["password"] = password
    if expires_at:
        data["expires_at"] = expires_at
    
    response = requests.post(
        "https://webhook.rubka.ir/api.php?action=shorten",
        headers=headers,
        json=data
    )
    return response.json()

# مثال استفاده
result = shorten_url("https://python.org", password="secret123", expires_at="30d")
print(result["data"]["short_url"])

جاوااسکریپت (JavaScript)

const API_KEY = "your_api_key_here";

async function shortenUrl(url, options = {}) {
    const response = await fetch(
        "https://webhook.rubka.ir/api.php?action=shorten",
        {
            method: "POST",
            headers: {
                "X-API-Key": API_KEY,
                "Content-Type": "application/json"
            },
            body: JSON.stringify({ url, ...options })
        }
    );
    return response.json();
}

// مثال استفاده
const result = await shortenUrl("https://example.com", {
    password: "mypass123",
    expires_at: "7d"
});
console.log(result.data.short_url);

PHP

<?php
$apiKey = "your_api_key_here";

function shortenUrl($url, $password = null, $expiresAt = null) {
    global $apiKey;
    $data = ["url" => $url];
    if ($password) $data["password"] = $password;
    if ($expiresAt) $data["expires_at"] = $expiresAt;
    
    $ch = curl_init("https://webhook.rubka.ir/api.php?action=shorten");
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "X-API-Key: $apiKey",
        "Content-Type: application/json"
    ]);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    return json_decode(curl_exec($ch), true);
}

$result = shortenUrl("https://example.com", "mypass123", "7d");
echo $result["data"]["short_url"];
?>