چگونه از وب‌سرویس پیوند استفاده کنیم؟
پیوند یک وب‌سرویس عمومی برای توسعه‌دهنده‌های عزیز ایرانی آماده کرده که به صورت نامحدود می‌تونند در توسعه محصول نرم‌افزاری خود از آن استفاده کنند؛ در پایین چگونگی استفاده از این وب‌سرویس توضیح داده شده است.
برای استفاده از وب‌سرویس پیوند کافی‌ست با استفاده از نوع POST در پروتکل HTTP به آدرس زیر درخواست دهید. (آدرسی که می‌خواهید کوتاه کنید را با کلید link در بدنه درخواست ارسال کنید.)
https://www.pvnd.io/api/v1/links
یا اگر احتیاج به cURL دارید، مقدار زیر را کپی کرده و در ترمنیال وارد کنید.
curl --location 'https://www.pvnd.io/api/v1/links' \
--header 'Accept: application/json' \
--form 'link="https://google.com"'
در پایان سرور پیوند کوتاه شما را با کد 201 در قالب زیر به شما برمی‌گرداند.
{
"status": "success",
"message": "پیوند کوتاه شما با موفقیت ساخته شد.",
"data": {
"link": "https://pvnd.io/aaaaa"
},
"errors": []
}
توجه کنید که پیوندِ کوتاه شما قابلیت کوتاه شدن دوباره ندارد و در صورت ارسال پیوندِ کوتاه با کد خطای 422 رو به رو می‌شوید.
{
"status": "error",
"message": "این پیوند از پیش کوتاه شده است!",
"data": [],
"errors": {
"link": [
"این پیوند از پیش کوتاه شده است!"
]
}
}
برای اینکه سرویس برای همه پایدار بماند، شمار درخواست‌ها محدود است: ۱۰ درخواست در دقیقه برای هر نشانی اینترنتی، و ۶۰ درخواست در دقیقه اگر با حساب کاربری خود وارد شده باشید. با گذر از این مرز، پاسخ 429 دریافت می‌کنید.
از اینکه از پیوند برای توسعه محصول خود استفاده کردید از شما سپاسگزاریم.