"> وب سرویس کوتاه کننده - <?php echo WEBSITE_TITLE ?>


وب سرویس کوتاه کننده - URL Shortener Webservice

لذت نهایت دسترسی!

وب سرویسها خدمات آنلاینی هستند که به درخواست مشتریان یا کلاینتها سرویس می دهند. کوتاه کننده وی۲ نیز از این امر مستثنی نیست و از چنین ویژگی ای پشتیبانی می کند. یکی از خدمات وب سرویس ما ، کوتاه کننده آدرسهای اینترنتی است. ما به جهت آشنایی و نحوه استفاده از این وب سرویس ادامه بحث را به همراه مثالهایی از زبان PHP پیش می گیریم. هر چند با دانستن آدرس وب سرویس و با مشخص ساختن نوع درخواست با هر زبان برنامه نویسی دیگری نیز میتوانید از این خدمات استفاده کنید.

برای شروع لازم است بدانید جهت ارتباط با سرویس دهنده وی۲ باید چه ورودی هایی را معین نمایید:

برای تنظیمات و استفاده چه کنیم؟

استفاده

حالا همه چیز آماده است! کافیست با توجه به توضیحاتی که در ادامه بیان می کنیم به وب سرویس ما متصل شوید و از خدمات آن استفاده کنید.

تنظیمات دریافت کلید عمومی و ثبت دامنه

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

ایجاد حساب کاربری

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

جهت دسترسی به وب سرویس ما در زبان php باید از کلاس nusoap استفاده کنید که در بخش آخر قابل دریافت است. پس از دریافت کلاس نیاز به دریافت کلید خصوصی دارید که با ثبت نام یا ورود به حساب کاربری خود در وی۲ ، در صفحه کاربری خود و در بخش "API و وب سرویس" براحتی میتوانید کلید خصوصی خود را دریافت نمایید. این کلید نباید توسط عموم مشاهده شود.

نوع خروجی نیز بسیار ساده است. اگر false قرار دهید یعنی فقط آدرس ایجاد شده را بر می گرداند. و اگر true باشد لینک html با آدرس خروجی بهمراه متن پیشفرض را بر می گرداند. ولی اگر یک رشته یا متن مشخص نمایید یعنی خروجی بصورت لینک html با متن رشته معین شده است.

و در نهایت نیز آدرسی را که میخواهید کوتاه کنید را نیز تایین و همگی را برای وب سرویس ارسال می کنید.

توجه

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

و در نهایت در صورت عدم وجود خطا نتیجه دلخواه خود را بدست می آورید. بعنوان مثال:

مثال 1:

<meta charset="UTF-8">
<?php
include "nusoap.php" ;
 
//VTwo Account > User Page > API & Webservice > Private Key
$privatekey = 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' ;
 
//1. False   2. True   3. Custom string 
$anchor = false ;
 
//Your address
$address = 'http://example.com/abcdefghABCDEFGH123456789.html' ;
 
//Request
$client = new nusoap_client( '' ) ;
if ( $client->fault ) {
    echo '<h2>Fault</h2>' . $client->getError() ;
} else {
    $result = $client->call( 'URLShortener', array(
        $privatekey,
        $anchor,
        $address ) ) ;
    $error = $client->getError() ;
    if ( $error ) {
        echo '<h2>Error</h2>' . $error ;
    } else {
        echo "<h2>$result</h2>" ;
    }
}
?>

خروجی: http://2wo.ir/xxxxxx

مثال 2:

$anchor = true ;

خروجی: لینک کوتاه به این صفحه

مثال 3:

$anchor = 'لینک کوتاه(Short Link)' ;

خروجی: لینک کوتاه(Short Link)

سایر ویژگیها

زبان

برای دسترسی به وب سرویس از زبان انگلیسی نیز پشتیبانی می شود. بنابراین آدرسهای دسترسی به وب سرویس بشرح زیر است:

فارسی: 

English: 
دانلود nusoap.php.zip
" class="btn-large waves-effect waves-light green">ایجاد حساب کاربری " class="btn-large waves-effect waves-light blue">ورود به حساب خود