عرض شركة

GET https://app.alaaqat.com/api/companies/{company_id}

حيث company_id هو قيمة _id للشركة. تُرجع هذه النقطة سجلاً واحداً. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية company-show.

ترويسة الطلب

{
    "Accept": "application/json"
}

الإستجابة

200 OK، ويأتي السجل ضمن data وقيم خصائصه ضمن data.properties. لا تظهر في الاستجابة الخاصية التي لا قيمة لها.

تأتي معرّفات السجلات المرتبطة بالشركة ضمن contact_ids وdeal_ids وما يشبهها، وعددها ضمن contacts_count وdeals_count وما يشبهها. راجع الارتباطات.

{
    "data": {
        "properties": {
            "_id": "6655a1b2c3d4e5f6a7b8c901",
            "name": "Blue Harbor Trading",
            "website_url": "https://blueharbor.example.com",
            "industry": "Wholesale",
            "city": "Amman",
            "country_region": "Jordan",
            "phone": "96265000000",
            "num_employees": 45,
            "lifecycle_stage": "customer",
            "owner": 12,
            "created_by": 12,
            "updated_at": "2026-10-20T09:30:00.000000Z",
            "created_at": "2026-10-20T09:30:00.000000Z",
            "contact_ids": [
                "6650f1a2b3c4d5e6f7a8b901"
            ],
            "contacts_count": 1
        },
        "account_id": 1024
    }
}

الأخطاء

الرمز المعنى
403 السجل موجود، لكن عضو الفريق الذي أنشأ المفتاح لا يرى إلا الشركات التي يملكها هو أو فرقه، وهذا السجل ليس منها.
404 لا يوجد في حسابك سجل بقيمة _id هذه.