التحقق من البيانات

نقطة النهاية

البيئة	عنوان URL
الإنتاج	`POST https://api.id.unico.app/lists/{cpf}`
وضع الاختبار	`POST https://api.id.uat.unico.app/lists/{cpf}`

نقطة نهاية منفصلة بتصميم مقصود

هذه النقطة النهائية منفصلة عن إنشاء العملية القياسية (POST /processes/v1). تُرجع قائمة من البيانات — وليس نتيجة تحقق حتمية من الهوية.

الطلب

الترويسات

الترويسة	القيمة
`Authorization`	`Bearer <access_token>` (انظر المصادقة)

معاملات المسار

المعامل	النوع	مطلوب	الوصف
`cpf`	string	نعم	رقم CPF للشخص المراد الاستعلام عنه.

curl -X POST "https://api.id.uat.unico.app/lists/12345678909" \
  -H "Authorization: Bearer $TOKEN"

الاستجابة

المغلّف الجذري

{
  "id": "41c24382-36ce-4bb4-8339-352114f71f78",
  "status": 3,
  "lists": { }
}

الحقل	النوع	الوصف
`id`	string (UUID)	معرّف الطلب الفريد.
`status`	integer	حالة المعالجة.
`lists`	object	الحمولة الرئيسية التي تحتوي على البيانات المستعلَم عنها.

`lists.basicData` — بيانات التسجيل

{
  "basicData": {
    "name": "JOAO DA SILVA",
    "birthCountry": "BRASILEIRA",
    "birthDate": "1990-01-01T00:00:00Z",
    "gender": "M",
    "motherName": "MARIA DA SILVA",
    "fatherName": "",
    "maritalStatus": "",
    "rgNumber": "",
    "rgIssuingAgency": "",
    "rgStateCode": "",
    "financialData": {
      "incomeEstimate": "...",
      "totalAssets": "..."
    },
    "address": {
      "addressMain": "AVENIDA DO ESTADO",
      "number": "123",
      "complement": "ANDAR 1",
      "neighborhood": "CENTRO",
      "zipCode": "12345678",
      "city": "SAO PAULO",
      "state": "SP",
      "country": "BRASIL",
      "type": "WORK"
    },
    "email": "...",
    "phone": "+554799999999"
  }
}

الحقل	النوع	الوصف
`name`	string	الاسم الكامل.
`birthCountry`	string	بلد الميلاد.
`birthDate`	string (ISO 8601)	تاريخ الميلاد.
`gender`	string	الجنس.
`motherName`	string	اسم الأم.
`fatherName`	string	اسم الأب.
`maritalStatus`	string	الحالة الاجتماعية.
`rgNumber`	string	رقم وثيقة RG.
`rgIssuingAgency`	string	الجهة المُصدِرة لوثيقة RG.
`rgStateCode`	string	رمز الولاية في وثيقة RG.
`financialData.incomeEstimate`	string	تقدير الدخل.
`financialData.totalAssets`	string	إجمالي الأصول.
`email`	string	البريد الإلكتروني.
`phone`	string	رقم الهاتف.

basicData.address:

الحقل	النوع	الوصف
`addressMain`	string	اسم الشارع.
`number`	string	الرقم.
`complement`	string	تكملة العنوان.
`neighborhood`	string	الحي.
`zipCode`	string	الرمز البريدي.
`city`	string	المدينة.
`state`	string	رمز الولاية.
`country`	string	البلد.
`type`	string	نوع العنوان (مثال: `WORK`).

`lists.riskData.taxIdValidation` — التحقق من رقم CPF

{
  "taxIdValidation": {
    "taxIdStatus": "REGULAR",
    "taxIdStatusDate": "...",
    "decease": false,
    "under18": false
  }
}

الحقل	النوع	الوصف
`taxIdStatus`	string	حالة تسجيل رقم CPF.
`taxIdStatusDate`	string	تاريخ حالة التسجيل.
`decease`	boolean	يشير إلى الوفاة.
`under18`	boolean	يشير إلى أن عمر الشخص أقل من 18 عاماً.

`lists.riskData.pep` — الشخص المعرَّض سياسياً

{
  "pep": {
    "isCurrentlyPep": true,
    "records": [
      {
        "level": "1",
        "jobTitle": "SENADOR",
        "motive": "FEDERAL EMPLOYEE"
      }
    ],
    "hasRelatedPep": true,
    "related": [
      {
        "taxId": "01253069891",
        "level": "2",
        "jobTitle": "FAMILIAR"
      }
    ]
  }
}

الحقل	النوع	الوصف
`isCurrentlyPep`	boolean	هل الشخص معرَّض سياسياً حالياً.
`records`	array	سجلات التعرض السياسي الخاصة بالشخص.
`records[].level`	string	مستوى التعرض السياسي.
`records[].jobTitle`	string	المسمى الوظيفي.
`records[].motive`	string	سبب التصنيف.
`hasRelatedPep`	boolean	وجود أفراد مرتبطين معرَّضين سياسياً.
`related`	array	قائمة الأفراد المرتبطين المعرَّضين سياسياً.
`related[].taxId`	string	رقم CPF الشخص المرتبط.
`related[].level`	string	مستوى التعرض.
`related[].jobTitle`	string	المسمى الوظيفي للشخص المرتبط.

`lists.riskData.aml` — مكافحة غسيل الأموال (العقوبات)

{
  "aml": {
    "isSanctioned": true,
    "records": [
      {
        "type": "Law Enforcement",
        "source": "interpol",
        "standardizedType": "ARREST WARRANTS",
        "endDate": "..."
      }
    ],
    "hasRelatedSanctioned": false,
    "relatedRecords": []
  }
}

الحقل	النوع	الوصف
`isSanctioned`	boolean	هل الشخص خاضع للعقوبات.
`records`	array	العقوبات الخاصة بالشخص.
`records[].type`	string	نوع العقوبة.
`records[].source`	string	مصدر العقوبة.
`records[].standardizedType`	string	النوع الموحَّد.
`records[].endDate`	string	تاريخ الانتهاء.
`hasRelatedSanctioned`	boolean	وجود أفراد مرتبطين خاضعين للعقوبات.
`relatedRecords`	array	عقوبات الأفراد المرتبطين.

`lists.riskData.sportsRelationship` — العلاقة بالمراهنات الرياضية

{
  "sportsRelationship": {
    "hasSportsRelationship": false,
    "isCurrentlyAthlete": false,
    "isCurrentlySportsCoach": false,
    "isCurrentlySportsClubDirector": false,
    "isCurrentlyReferee": false,
    "isCurrentlyRelatedToFinanceMinistry": false,
    "isCurrentlyBettingCompanyOwner": false,
    "sportsRelationshipMotive": "",
    "sportExposures": []
  }
}

الحقل	النوع	الوصف
`hasSportsRelationship`	boolean	وجود علاقة رياضية.
`isCurrentlyAthlete`	boolean	هل الشخص رياضي نشط.
`isCurrentlySportsCoach`	boolean	هل الشخص مدرب رياضي نشط.
`isCurrentlySportsClubDirector`	boolean	هل الشخص مدير نادٍ رياضي نشط.
`isCurrentlyReferee`	boolean	هل الشخص حكَم نشط.
`isCurrentlyRelatedToFinanceMinistry`	boolean	وجود علاقة بوزارة المالية.
`isCurrentlyBettingCompanyOwner`	boolean	هل الشخص مالك شركة مراهنات.
`sportsRelationshipMotive`	string	سبب العلاقة.
`sportExposures`	array	تفاصيل التعرضات الرياضية.

sportExposures[]:

الحقل	النوع	الوصف
`sportName`	string	اسم الرياضة.
`region`	string	منطقة النشاط.
`totalRelatedEntities`	integer	إجمالي الكيانات المرتبطة.
`relationshipLevel`	string	مستوى العلاقة.
`endDate`	string	تاريخ الانتهاء.

رموز الخطأ

400 Bad Request
403 Forbidden
500 Internal Server Error

الرمز	الرسالة	الوصف
`99989`	The document is invalid.	عندما يكون رقم CPF غير صالح.

الرمز	الرسالة	الوصف
`10501`	The authorization token is invalid.	رمز المصادقة غير صالح.

الرمز	الرسالة	الوصف
`99999`	Internal failure! Try again later	عند حدوث خطأ داخلي.

نقطة النهاية​

الطلب​

الاستجابة​

رموز الخطأ​

نقطة النهاية

الطلب

الاستجابة

رموز الخطأ