راهنمای استفاده از واسط نرم افزاری یون

با استفاده از واسط نرم افزاری ارائه شده میتوانید خدمات سرویس کوتاه کننده لینک یون را در اپلیکیشن ها و وبسایت های خود دریافت نمایید. طراحی این واسط بسیار ساده و یک پارچه بوده و شما میتوانید در کمتر از ۱۰ دقیقه سرویس های خود را به آن متصل نمایید.

ایجاد توکن

جهت اتصال به واسط نرم افزاری سرویس یون شما نیاز به توکن اعتبار سنجی خواهید داشت.

توکن ایجاد شده را جهت اعتبارسنجی باید در هدر درخواست خود قرار دهید.

'X-API-Key: put-your-token-here',

جهت دریافت توکن اختصاصی خود پس از عضویت و ورود به اشتراک خود به بخش توکن ها مراجعه نمایید. جهت مراجعه به این بخش بر روی لینک زیر کلیک کنید.

تولید توکن جدید

ارسال درخواست

پس از تولید و دریافت توکن اختصاصی خود هم اکنون میتوانید درخواست خود را جهت دریافت سرویس ارسال نمایید. در صورتی که درخواست معتبری ارسال نمایید شناسه و لینک مربوط به درخواست شما در پاسخ به شما ارائه میگردد. در صورت نیاز به ارسال درخواست بروزرسانی و یا حذف به این شناسه نیازمند خواهید بود پس آن را در پایگاه داده خود ذخیره نمایید.

مشاهده جزئیات فنی نحوه ارسال درخواست

دریافت فایل پست من

نمونه کد اجرایی

در قسمت زیر یک نمونه کد به زبان پی اچ پی جهت ارسال درخواست کوتاه کردن لینک را مشاهده می نمایید. جهت مشاهده جزییات فنی بیشتر به لینک زیر مراجعه فرمایید.

function __short_url($title, $url)
{
    $data = json_encode([
        "title" => $title,
        "url" => $url,
    ]);

    $ch = curl_init('https://yun.ir/api/v1/urls');
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Content-Type: application/json',
            'X-API-Key: put-your-token-here',
            'Content-Length: ' . strlen($data)
    ]);

    $result = curl_exec($ch);
    return json_decode($result, 1);
}

$result = __short_url('تلگفا', 'http://telegfa.com');
var_dump($result);

/*
array(2) {
  ["id"] => int(24057)
  ["url"] => string(13) "yun.ir/5orqga"
}
*/
            

کوتاه کردن لینک با استفاده از دامنه شخصی

جهت کوتاه کردن لینک با استفاده از دامنه شخصی دلخواه خود به بخش دامنه اختصاصی رفته و دامنه ای ایجاد نمایید، سپس به بخش توکن هامراجعه نمایید.