• مدیر سایت
• آگوست 18, 2019

راهنمای کامل API دریافت اطلاعات تمام لینک های کوتاه

مدیریت تعداد زیادی لینک کوتاه در کمپین‌های مختلف می‌تواند چالش‌برانگیز باشد. وقتی نیاز به بررسی عملکرد، به‌روزرسانی یا دسته‌بندی لینک‌ها دارید، دسترسی دستی به آن‌ها بسیار زمان‌بر است. اما یک راه حل قدرتمند وجود دارد. وب سرویس یا API دریافت اطلاعات تمام لینک های کوتاه این فرآیند را کاملاً خودکار می‌کند.

در این راهنمای جامع، ما به شما نشان می‌دهیم که چگونه از این API استفاده کنید. شما یاد می‌گیرید که چطور به سادگی لیستی کامل از تمام لینک‌های کوتاه خود را دریافت نمایید. همچنین کاربردها و مزیت‌های کلیدی آن را بررسی خواهیم کرد. در نتیجه، می‌توانید مدیریت لینک‌های خود را به سطح بالاتری ببرید.

چرا به API دریافت اطلاعات تمام لینک‌های کوتاه نیاز داریم؟ (مزیت‌ها)

استفاده از این وب سرویس فقط یک انتخاب فنی نیست؛ بلکه یک مزیت استراتژیک است. این ابزار به شما کمک می‌کند تا کنترل کاملی بر روی دارایی‌های دیجیتال خود داشته باشید. در ادامه به مهم‌ترین مزایای آن می‌پردازیم.

• 📊 دسترسی یکپارچه به داده‌ها: به جای جستجو در پنل‌های مختلف، تمام اطلاعات لینک‌ها را در یک پاسخ JSON دریافت کنید.
• ⏱️ صرفه‌جویی در زمان و هزینه: فرآیندهای دستی را حذف کنید. این کار باعث کاهش خطای انسانی و افزایش بهره‌وری تیم شما می‌شود.
• ⚙️ اتوماسیون فرآیندهای گزارش‌گیری: گزارش‌های دوره‌ای از عملکرد لینک‌ها را به صورت خودکار تولید کنید. این قابلیت برای تحلیل کمپین‌ها عالی است.
• 🔗 مدیریت متمرکز لینک‌ها: به راحتی لینک‌های قدیمی را پیدا کنید. همچنین می‌توانید آن‌ها را بایگانی یا به‌روزرسانی نمایید.
• 💡 ایجاد داشبوردهای تحلیلی سفارشی: با دریافت داده‌ها، داشبوردهای مدیریتی خود را بسازید. این داشبوردها دید بهتری از وضعیت کمپین‌ها به شما می‌دهند.

کاربردهای کلیدی وب سرویس مدیریت لینک‌های کوتاه

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

• 📈 ساخت داشبوردهای مدیریتی: تیم‌های بازاریابی می‌توانند با استفاده از این API، داشبوردی برای رصد زنده‌ی آمار کلیک تمام لینک‌ها بسازند.
• 🗂️ انتقال و بایگانی داده‌ها (Migration): اگر قصد دارید از یک سرویس کوتاه کننده لینک به سرویس دیگری مهاجرت کنید، این API بهترین ابزار برای استخراج تمام لینک‌های شماست.
• 🔍 تحلیل جامع عملکرد: به راحتی تمام لینک‌های مربوط به یک کمپین خاص را فیلتر کنید. سپس می‌توانید بازدهی کلی آن را بسنجید.
• 🔄 همگام‌سازی با سایر نرم‌افزارها: اطلاعات لینک‌ها را با نرم‌افزارهای CRM یا پلتفرم‌های اتوماسیون بازاریابی خود همگام‌سازی کنید.

شروع کار: راهنمای گام به گام استفاده از API

استفاده از این وب سرویس بسیار ساده است. این API به صورت RESTful طراحی شده است. به همین دلیل، تمام درخواست‌ها و پاسخ‌ها با فرمت استاندارد JSON ردوبدل می‌شوند. بیایید مراحل را با هم طی کنیم.

گام اول: ثبت‌نام و دریافت کلید API

قبل از هر کاری، شما به یک کلید API یا توکن اعتبارسنجی (Authorization Token) نیاز دارید. این کلید هویت شما را برای سرور تایید می‌کند.

1. ابتدا به پنل کاربری مراجعه کنید. برای این کار از لینک p.api.ir استفاده نمایید.
2. پس از ثبت‌نام و ورود، به بخش «کلیدهای API» بروید.
3. کلید اختصاصی خود را کپی کنید. این کلید محرمانه است؛ آن را با دیگران به اشتراک نگذارید.

گام دوم: ساختار درخواست (Request Structure)

برای دریافت لیست لینک‌ها، باید یک درخواست از نوع GET به آدرس زیر ارسال کنید.

Endpoint:

GET https://p.api.ir/v1/urls

فراموش نکنید که هدرهای (Headers) زیر را در درخواست خود قرار دهید. کلید API شما باید به جای YOUR_TOKEN_HERE جایگزین شود.

• Accept: application/json
• Content-Type: application/json
• Authorization: Bearer YOUR_TOKEN_HERE

گام سوم: نمونه کد اجرایی (PHP)

در اینجا یک نمونه کد با استفاده از cURL در PHP برای ارسال درخواست آورده شده است. شما می‌توانید از این الگو در زبان‌های برنامه‌نویسی دیگر نیز استفاده کنید.

<?php

// توکن اعتبارسنجی خود را در اینجا قرار دهید
$apiToken = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://p.api.ir/v1/urls",
  CURLOPT_RETURNTRANSFER => true, // پاسخ را به صورت رشته برمی‌گرداند
  CURLOPT_TIMEOUT => 30,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "accept: application/json",
    "authorization: Bearer " . $apiToken,
    "content-type: application/json"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  // پاسخ را به صورت یک آرایه یا آبجکت PHP نمایش می‌دهد
  print_r(json_decode($response, true));
}

تحلیل پاسخ دریافتی از API

پس از ارسال درخواست موفق، سرور پاسخی با فرمت JSON به شما برمی‌گرداند. این پاسخ شامل لیستی از لینک‌های کوتاه شما به همراه جزئیات کامل است.

نمونه پاسخ (JSON):

{
  "data": [
    {
      "hash": "app",
      "title": "لینک اپلیکیشن موبایل",
      "long_url": "https://play.google.com/store/apps/details?id=com.example.app",
      "clicks": 250,
      "created_at": "2026-05-20 11:07:57",
      "short_url": "https://p.api.ir/app",
      "key": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "public_stats": "https://p.api.ir/stats/app"
    },
    {
      "hash": "blog",
      "title": "مقاله جدید وبلاگ",
      "long_url": "https://example.com/blog/new-post",
      "clicks": 15,
      "created_at": "2026-05-19 09:30:59",
      "short_url": "https://p.api.ir/blog",
      "key": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
      "public_stats": "https://p.api.ir/stats/blog"
    }
  ],
  "code": 200,
  "success": true,
  "next_page_url": "https://p.api.ir/v1/urls?page=2"
}

نکته مهم (صفحه‌بندی): پاسخ‌ها به صورت صفحه‌بندی شده (Paginated) ارسال می‌شوند. اگر لینک‌های بیشتری برای نمایش وجود داشته باشد، فیلد next_page_url در پاسخ مقداردهی می‌شود. برای دریافت صفحه بعد، کافی است درخواستی به این آدرس جدید ارسال کنید.

جمع‌بندی

وب سرویس دریافت اطلاعات تمام لینک های کوتاه یک ابزار ضروری برای مدیریت هوشمندانه لینک‌هاست. این API به شما امکان می‌دهد تا داده‌ها را به صورت یکپارچه دریافت کنید. در نتیجه می‌توانید فرآیندهای خود را خودکار کرده و تحلیل‌های دقیقی انجام دهید. با دنبال کردن این راهنما، شما آماده‌اید تا از تمام پتانسیل این ابزار قدرتمند استفاده کنید.

شما چه کاربردهای دیگری برای این API در نظر دارید؟ نظرات و سوالات خود را در بخش دیدگاه‌ها با ما به اشتراک بگذارید. 💬

• برچسب ها:
• api دریافت لینک کوتاه
• دریافت لینک های کوتاه
• وب سرویس
• وب سرویس کوتاه کننده
• وب سرویس کوتاه کننده لینک