">
وب سرویسها خدمات آنلاینی هستند که به درخواست مشتریان یا کلاینتها سرویس می دهند. کوتاه کننده وی۲ نیز از این امر مستثنی نیست و از چنین ویژگی ای پشتیبانی می کند. یکی از خدمات وب سرویس ما ، کوتاه کننده آدرسهای اینترنتی است. ما به جهت آشنایی و نحوه استفاده از این وب سرویس ادامه بحث را به همراه مثالهایی از زبان PHP پیش می گیریم. هر چند با دانستن آدرس وب سرویس و با مشخص ساختن نوع درخواست با هر زبان برنامه نویسی دیگری نیز میتوانید از این خدمات استفاده کنید.
برای شروع لازم است بدانید جهت ارتباط با سرویس دهنده وی۲ باید چه ورودی هایی را معین نمایید:
حالا همه چیز آماده است! کافیست با توجه به توضیحاتی که در ادامه بیان می کنیم به وب سرویس ما متصل شوید و از خدمات آن استفاده کنید.
حال بعد از ورود به حساب کاربری ، به بخش "API و وب سرویس" رفته و کلید خصوصی خود را دریافت نمایید.
ابتدا یک حساب کاربری ایجاد کنید. برای ایجاد حساب فقط نیاز به یک ایمیل معتبر دارید تا حساب خود را تایید کنید.
جهت دسترسی به وب سرویس ما در زبان php باید از کلاس nusoap استفاده کنید که در بخش آخر قابل دریافت است. پس از دریافت کلاس نیاز به دریافت کلید خصوصی دارید که با ثبت نام یا ورود به حساب کاربری خود در وی۲ ، در صفحه کاربری خود و در بخش "API و وب سرویس" براحتی میتوانید کلید خصوصی خود را دریافت نمایید. این کلید نباید توسط عموم مشاهده شود.
نوع خروجی نیز بسیار ساده است. اگر false قرار دهید یعنی فقط آدرس ایجاد شده را بر می گرداند. و اگر true باشد لینک html با آدرس خروجی بهمراه متن پیشفرض را بر می گرداند. ولی اگر یک رشته یا متن مشخص نمایید یعنی خروجی بصورت لینک html با متن رشته معین شده است.
و در نهایت نیز آدرسی را که میخواهید کوتاه کنید را نیز تایین و همگی را برای وب سرویس ارسال می کنید.
در صورتی که با خروجی زیر مواجه شدید یعنی خطاست و معانی زیر را دارد:
و در نهایت در صورت عدم وجود خطا نتیجه دلخواه خود را بدست می آورید. بعنوان مثال:
<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
$anchor = true ;
خروجی: لینک کوتاه به این صفحه
$anchor = 'لینک کوتاه(Short Link)' ;
خروجی: لینک کوتاه(Short Link)
برای دسترسی به وب سرویس از زبان انگلیسی نیز پشتیبانی می شود. بنابراین آدرسهای دسترسی به وب سرویس بشرح زیر است:
فارسی: English: