چگونه از وب‌سرویس پیوند استفاده کنیم؟

پیوند یک وب‌سرویس عمومی برای توسعه‌دهنده‌های عزیز ایرانی آماده کرده که به صورت نامحدود می‌تونند در توسعه محصول نرم‌افزاری خود از آن استفاده کنند؛ در پایین چگونگی استفاده از این وب‌سرویس توضیح داده شده است.

برای استفاده از وب‌سرویس پیوند کافی‌ست با استفاده از نوع POST در پروتکل HTTP به آدرس زیر درخواست دهید. (آدرسی که می‌خواهید کوتاه کنید را با کلید link در بدنه درخواست ارسال کنید.)

https://pvnd.io/api/v1/links

یا اگر احتیاج به cURL دارید، مقدار زیر را کپی کرده و در ترمنیال وارد کنید.

curl --location 'https://pvnd.io/api/v1/links' \
        --header 'Accept: application/json' \
        --form 'link="https://google.com"'

در پایان سرور پیوند کوتاه شما را با کد 201 در قالب زیر به شما برمی‌گرداند.

{
    "status": "success",
    "message": "پیوند کوتاه شما با موفقیت ساخته شد.",
    "data": {
        "link": "https://pvnd.io/gg"
    },
    "errors": []
}

توجه کنید که پیوندِ کوتاه شما قابلیت کوتاه شدن دوباره ندارد و در صورت ارسال پیوندِ کوتاه با کد خطای 422 رو به رو می‌شوید.

{
    "status": "error",
    "message": "این پیوند از پیش کوتاه شده است!",
    "data": [],
    "errors": []
}

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

پرسش‌های پرتکرار

آیا استفاده از وب‌سرویس پیوند محدودیت دارد؟

خیر؛ در استفاده از وب‌سرویس پیوند هیچ محدودیتی وجود ندارد.