استبدال الأشخاص

واجهة Redeem People تحوّل people_search_id (أو رابط LinkedIn) إلى المجموعة الكاملة من بيانات التواصل الموثَّقة — بريد العمل، البريد الشخصي، الهاتف — لذلك الشخص. أنت تنفق أرصدة فقط عندما تُعاد بيانات تواصل فعلية.

curl -X POST https://api.pubrio.com/redeem/people \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
    "people_contact_types": ["email-work", "phone"]
  }'

متى تستخدم Redeem

استخدم Redeem عندما تعرف بالفعل هوية الشخص وتحتاج إلى بيانات التواصل الخاصة به:

شغّلت People Search وتريد فتح بيانات التواصل للنتائج المطابقة
لديك رابط ملف LinkedIn وتريد التواصل مع الشخص
لديك people_search_id من استجابة سابقة لـ Pubrio

إن كان لديك بدلًا من ذلك بريد إلكتروني أو هاتف وتريد إيجاد الشخص المطابق، استخدم البحث عن بيانات التواصل لشخص — فهو الاتجاه المعاكس وبتكلفة رصيد واحد لكل تطابق.

ثلاثة أنماط للاستدعاء

النقطة الطرفية	استخدمها عندما	السلوك
`POST /redeem/people`	شخص واحد في كل مرة	متزامن. تُعاد بيانات التواصل ضمن الاستجابة.
`POST /redeem/people/batch`	من 2 إلى N شخص دفعة واحدة	غير متزامن. تُعاد `redeem_query_id` فورًا.
`POST /redeem/people/batch/query`	استعلام دوري عن نتائج الدفعة	تُعاد مجموعة النتائج الكاملة عند اكتمال الدفعة.

مسار الدفعة هو النمط المناسب لأي سير عمل قائم على قائمة — رفع ملفات CSV، تسجيل ضمن تسلسل تواصل، مزامنة CRM — لأنه يوازي عمل حل بيانات التواصل من جهة الخادم.

بداية سريعة — استبدال فردي

curl -X POST https://api.pubrio.com/redeem/people \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
    "people_contact_types": ["email-work", "phone"]
  }'

const res = await fetch("https://api.pubrio.com/redeem/people", {
  method: "POST",
  headers: {
    "pubrio-api-key": process.env.PUBRIO_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    people_search_id: "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
    people_contact_types: ["email-work", "phone"],
  }),
});
const { data } = await res.json();

import os, requests

res = requests.post(
    "https://api.pubrio.com/redeem/people",
    headers={"pubrio-api-key": os.environ["PUBRIO_API_KEY"]},
    json={
        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
        "people_contact_types": ["email-work", "phone"],
    },
)
data = res.json()["data"]

الاستجابة:

{
  "data": {
    "profile": {
      "credit": 450376,
      "topup_credit": 235237,
      "total_credit_cost": 15
    },
    "peoples": [
      {
        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
        "emails": [
          { "value": "[email protected]", "type": "email-work", "status": "Verified" }
        ],
        "phones": [
          { "value": "+15551234567", "type": "phone", "status": null }
        ]
      }
    ]
  }
}

يعكس profile رصيدك بعد الخصم والأرصدة التي كلّفها هذا الاستدعاء، حتى تتمكن من تحديث مقياس داخل تطبيقك دون استدعاء إضافي إلى /profile/usage.

المعرّفات

يمكنك تحديد الشخص المراد استبداله بطريقتين:

المعرّف	الوصف
`people_search_id`	معرّف UUID تُرجعه أي نقطة بحث/查找 من Pubrio. الأرخص والأكثر موثوقية — دون خطوة حل إضافية.
`linkedin_url`	رابط ملف LinkedIn (مثل `https://www.linkedin.com/in/jane-doe-123`). يحوّله Pubrio أولًا إلى `people_search_id`؛ وإن كان الملف جديدًا، قد يشمل ذلك خطوة إثراء خارجية تُنفَّذ مرة واحدة.

people_contact_types هو العقد الذي يحدد ما تريد استرجاعه. امزج أيًا من email-work وemail-personal وphone — تُفرَض عليك الرسوم حسب النوع المُعاد فعليًا، لا حسب النوع المطلوب. طلب ["email-work", "phone"] والحصول على email-work فقط يُحصّل رسومًا على البريد الإلكتروني فقط.

استبدال دفعي (نمط غير متزامن)

لأكثر من شخص واحد، استخدم مسار الدفعة. فهو ينفّذ كل عملية استبدال بالتوازي من جهة الخادم ويتجنب تكلفة الرحلة ذهابًا وإيابًا لكل طلب. الخطوة 1 — الإرسال:

curl -X POST https://api.pubrio.com/redeem/people/batch \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "peoples": [
      "540574d1-ff74-475b-aea2-f8ae643b806d",
      "e37ccf38-ea8f-422e-9874-cb23b15e8fe4"
    ],
    "people_contact_types": ["email-work", "phone"]
  }'

{
  "data": {
    "redeem_query_id": "a046c1da-b3d4-4ca1-aca6-1dd8c8055701",
    "is_completed": false,
    "estimated_time": 6,
    "estimated_time_type": "second"
  }
}

الخطوة 2 — الاستعلام الدوري:

curl -X POST https://api.pubrio.com/redeem/people/batch/query \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "redeem_query_id": "a046c1da-b3d4-4ca1-aca6-1dd8c8055701" }'

عندما تكون is_completed بقيمة true، تحتوي الاستجابة على مصفوفة peoples الكاملة ببيانات التواصل المحلولة وإجمالي تكلفة الأرصدة للدفعة.

استعلم بالوتيرة التي يبلغ عنها estimated_time. الاستعلام بوتيرة أضيق من التقدير يهدر رحلات الشبكة فقط — فالعمل لم يكتمل بعد.

تكاليف الأرصدة

تُخصم الأرصدة لكل جهة تواصل مُعادة، لا لكل طلب. التسعير لكل سجل:

نوع بيانات التواصل	أرصدة لكل سجل
`email-work` / `email-personal`	5
`phone`	10

إن لم يكن لدى الشخص بريد عمل وطلبت email-work فقط، فلن تُفرَض عليك أي رسوم لذلك السجل. وإن طلبت بريدًا إلكترونيًا وهاتفًا معًا وأعاد Pubrio كليهما، فستُحصّل رسوم عليهما معًا. راجع جدول الأسعار الكامل للاطلاع على المعدلات الخاصة بكل خطة.

أنماط شائعة

مسار البحث ثم الاستبدال

شغّل People Search، ودع المستخدم يختار صفوفًا في واجهتك، ثم أرسل معرّفات people_search_id المختارة عبر /redeem/people/batch. لن تُحصّل رسوم إلا على ما يُستخدم فعليًا.

تدفق لصق روابط LinkedIn

اقبل قائمة روابط LinkedIn من تصدير CRM أو إضافة متصفح. أرسلها عبر /redeem/people (فردي) أو أنشئ غلافًا دفعيًا بسيطًا.

تسجيل ضمن تسلسل تواصل

قبل إضافة جهات التواصل إلى وتيرة تواصل صادرة، استبدل email-work فقط — يبقي التكلفة قابلة للتوقع بينما يزوّد أداة الإرسال لديك بعناوين قابلة للتسليم.

إثراء CRM

اربط سجلات CRM القائمة بـ people_search_id (عبر People Lookup)، ثم نفّذ الاستبدال دفعيًا وفق جدولة.

الأسئلة الشائعة

هل سيتم تحصيل رسوم إن لم توجد بيانات تواصل؟

لا. تُخصم الأرصدة لكل سجل مُعاد. إن لم يتوفر بريد عمل لشخص ما، فلن تدفع شيئًا مقابل ذلك النوع من بيانات التواصل — حتى إن كنت قد طلبته.

ماذا لو ظهر نفس الشخص مرتين في دفعتي؟

تُزال التكرارات من جهة الخادم. تُحصَّل الرسوم مرة واحدة فقط.

ماذا يحدث إن كان رابط LinkedIn غير معروف لدى Pubrio؟

يحاول Pubrio حلًا خارجيًا لمرة واحدة. إن أمكن حلّ الملف الشخصي، يُطبَّق تسعير الاستبدال المعتاد. وإن تعذّر ذلك، لا تُحصّل أي أرصدة.

ما مدى حداثة بيانات التواصل؟

يعيد Pubrio التحقق من سجلات البريد الإلكتروني والهاتف بشكل دوري متجدد. يأتي كل سجل تواصل مصحوبًا بحقل status (Verified، أو null، إلخ) بحيث يمكنك تصفية السجلات الموثَّقة فقط من جهتك.

هل يمكنني استبدال الهاتف فقط، أو البريد فقط، أو البريد الشخصي فقط؟

نعم — people_contact_types مصفوفة. مرّر بالضبط الأنواع التي تريدها؛ ستُحصَّل رسوم فقط على ما يُعاد فعليًا.

دفعي مقابل فردي — متى يتفوق النمط غير المتزامن؟

عند تجاوز نحو 3 سجلات، تتفوق الدفعة من حيث زمن الاستجابة وموثوقية كل سجل. تنفّذ نقطة الدفعة التوزيع داخليًا وتوازي أي رحلات إثراء خارجية، بحيث تقترب دفعة من 50 سجلًا من زمن إجمالي قدره 5 ثوانٍ بدل 50 رحلة طلب منفردة.

صفحات ذات صلة

البحث عن بيانات التواصل لشخص

بحث عكسي: أوجد شخصًا من بريد إلكتروني أو هاتف أو اسم + نطاق. رصيد واحد لكل تطابق.

People Search

ابحث عن أشخاص يطابقون ملفًا معينًا (المنصب، الموقع، حجم الشركة، التقنيات، إلخ).

People Lookup

احصل على الملف الكامل لشخص واحد من معرّف — دون فتح بيانات التواصل.

الأسعار

تكاليف الأرصدة عبر جميع النقاط الطرفية، حسب فئة الخطة.

Monitor

البحث

المرشحات

الأشخاص

التوسع

متى تستخدم Redeem

ثلاثة أنماط للاستدعاء

بداية سريعة — استبدال فردي

المعرّفات

استبدال دفعي (نمط غير متزامن)

تكاليف الأرصدة

أنماط شائعة

مسار البحث ثم الاستبدال

تدفق لصق روابط LinkedIn

تسجيل ضمن تسلسل تواصل

إثراء CRM

الأسئلة الشائعة

صفحات ذات صلة

البحث عن بيانات التواصل لشخص

People Search

People Lookup

الأسعار

​متى تستخدم Redeem

​ثلاثة أنماط للاستدعاء

​بداية سريعة — استبدال فردي

​المعرّفات

​استبدال دفعي (نمط غير متزامن)

​تكاليف الأرصدة

​أنماط شائعة

مسار البحث ثم الاستبدال

تدفق لصق روابط LinkedIn

تسجيل ضمن تسلسل تواصل

إثراء CRM

​الأسئلة الشائعة

​صفحات ذات صلة

البحث عن بيانات التواصل لشخص

People Search

People Lookup

الأسعار

متى تستخدم Redeem

ثلاثة أنماط للاستدعاء

بداية سريعة — استبدال فردي

المعرّفات

استبدال دفعي (نمط غير متزامن)

تكاليف الأرصدة

أنماط شائعة

الأسئلة الشائعة

صفحات ذات صلة