> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # عرض سجلات طلبات API > استرجع قائمة مرقّمة صفحيًا من سجلات طلبات API لمساحة العمل. يلخّص كل إدخال طلبًا واحدًا نُفِّذ بـ`pubrio-api-key`، بما يشمل المسار، والطريقة، ورمز الحالة، والمدة، وحجم الاستجابة، وتكلفة الأرصدة. استخدم نقطة [البحث عن تفاصيل السجل](/api-reference/endpoint/api-keys/logs_lookup) لجلب حمولة الطلب/الاستجابة الكاملة لإدخال محدد. ## OpenAPI ````yaml ar-openapi POST /api_keys/logs openapi: 3.0.0 info: description: >- تقدّم واجهة Pubrio API معلومات استخباراتية عن توسع السوق — إشارات في الوقت الفعلي تُعلِم عندما تدخل شركة سوقًا جديدة — إلى جانب بيانات الشركات والأشخاص التي تستند إليها. ابحث، وتحقق، وأثرِ الحسابات وجهات التواصل، واشترك في إشارات تحرك مصنَّفة ومؤرَّخة عبر أكثر من 200 سوق. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ar/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ar/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: معلومات ملف مساحة العمل وإحصاءات الاستخدام - name: Enrichment description: إثراء سجلات الأشخاص والشركات ببيانات B2B مفصّلة - name: Lookalike description: إيجاد شركات مشابهة لشركة معينة - name: Search description: البحث عن أشخاص وشركات ووظائف وأخبار وإعلانات بمرشحات - name: Lookup description: البحث عن معلومات مفصّلة لأشخاص وشركات ووظائف وأخبار وإعلانات وتقنيات محددة - name: LinkedIn description: البحث عن بيانات أشخاص وشركات عبر روابط ملفات LinkedIn - name: Redeem description: استبدال أرصدة لفتح بيانات تواصل الأشخاص (فردي ودفعي) - name: Channels description: إدارة قوالب قنوات التواصل (إنشاء، تحديث، حذف، سرد) - name: Monitor description: إنشاء وإدارة Monitors للبيانات بواجهات webhook، وإحصاءات، ومعالجة - name: Filters description: >- استرجاع قيم المرشحات المتاحة لمعاملات البحث (التقنيات، المواقع، القطاعات، إلخ) - name: API Keys description: سرد وفحص سجلات طلبات API وتحليلات الاستخدام لمفاتيح API - name: Insights description: رؤى إشارات مجمَّعة للشركات (الوظائف، الأخبار، الإعلانات). - name: Export description: تصدير بيانات دفعي (مقيَّد بالأرصدة). - name: Expansion description: >- معلومات استخباراتية عن توسع الشركات في السوق: الإشارات، المراحل، الأسواق، والتصدير. externalDocs: description: >- The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data. url: https://docs.pubrio.com paths: /api_keys/logs: post: tags: - API Keys summary: سرد سجلات طلبات API description: >- استرجع قائمة مرقّمة صفحيًا من سجلات طلبات API لمساحة العمل. يلخّص كل إدخال طلبًا واحدًا نُفِّذ بـ`pubrio-api-key`، بما يشمل المسار، والطريقة، ورمز الحالة، والمدة، وحجم الاستجابة، وتكلفة الأرصدة. استخدم نقطة [البحث عن تفاصيل السجل](/api-reference/endpoint/api-keys/logs_lookup) لجلب حمولة الطلب/الاستجابة الكاملة لإدخال محدد. operationId: api_keys_get_logs requestBody: required: true content: application/json: schema: type: object properties: page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' order_by: type: string enum: - created_at - duration_ms - status_code default: created_at description: الحقل المُستخدَم لترتيب قائمة السجلات. is_ascending_order: type: boolean default: false description: اتجاه الترتيب. `true` تصاعديًا، `false` (افتراضي) تنازليًا. search_term: type: string description: >- بحث نصي حر عبر مسار الطلب، والاسم القياسي لنوع السجل، وجسم الطلب الخام. log_types: type: array items: type: integer description: التصفية حسب معرّفات نوع السجل. log_type_slugs: type: array items: type: string description: >- التصفية حسب الأسماء القياسية لنوع السجل (مثل `people_search`، `company_search`). status_codes: type: array items: type: integer description: التصفية حسب رموز حالة HTTP (مثل `[200, 400, 500]`). methods: type: array items: type: string description: التصفية حسب طرق HTTP (مثل `["POST", "GET"]`). responses: '200': description: استجابة ناجحة تحتوي على سجلات طلبات API مرقّمة صفحيًا. content: application/json: schema: type: object properties: metadata: type: object properties: filters: type: object description: >- عرض لمرشحات الطلب المُستخدَمة لإنتاج هذه الاستجابة، بعد إزالة القيم الفارغة. additionalProperties: true data: type: object properties: pagination: type: object properties: page: type: integer description: رقم الصفحة الحالية. per_page: type: integer description: عدد النتائج لكل صفحة. total_entries: type: integer description: العدد الإجمالي لإدخالات السجل. total_pages: type: integer description: العدد الإجمالي للصفحات. total_display_pages: type: integer description: الحد الأقصى لعدد الصفحات القابلة للعرض لهذه الخطة. is_timeout: type: boolean description: ما إذا انتهت مهلة استعلام العدّ. query_logs: type: array items: type: object properties: query_log_id: type: string format: uuid description: >- المعرّف الفريد لإدخال السجل. مرّره إلى `/api_keys/logs/lookup` لاسترجاع الحمولة الكاملة. created_at: type: string description: الطابع الزمني عند استلام الطلب (UTC). profile_id: type: integer description: معرّف ملف مساحة العمل المرتبط بالطلب. user_id: type: string format: uuid description: معرّف المستخدم المرتبط بمفتاح API. method: type: string description: طريقة HTTP للطلب. path: type: string description: مسار الطلب. status_code: type: integer description: رمز حالة HTTP المُعاد. duration_ms: type: integer description: مدة معالجة الطلب بالمللي ثانية. log_type_id: type: integer description: >- معرّف نوع السجل الداخلي. `0` إن لم يرتبط الطلب بنوع سجل قابل للفوترة. log_type_slug: type: string nullable: true description: >- الاسم القياسي لنوع السجل (مثل `people_search`). `null` للطلبات غير المفوترة. log_type_name: type: string nullable: true description: اسم نوع السجل القابل للقراءة. authentication_type: type: string description: >- آلية المصادقة المُستخدَمة. دائمًا `pubrio-api-key` لطلبات مفتاح API. authentication_type_name: type: string description: اسم نوع المصادقة القابل للقراءة. masked_authentication: type: string description: تمثيل مُخفى لمفتاح API المُستخدَم لهذا الطلب. response_size: type: integer description: حجم نص الاستجابة بالبايت. credits: type: number description: إجمالي الأرصدة المحصَّلة لهذا الطلب. ip: type: string description: عنوان IP للعميل المُستدعي. email: type: string description: بريد المستخدم الذي يملك مفتاح API. nickname: type: string description: الاسم المستعار للمستخدم الذي يملك مفتاح API. user: type: object properties: user_id: type: string format: uuid nickname: type: string email: type: string example: metadata: filters: page: 1 per_page: 3 status_codes: - 200 data: pagination: page: 1 per_page: 3 total_entries: 1109 total_pages: 370 total_display_pages: 250 is_timeout: false query_logs: - query_log_id: fc1ce3dd-39f7-4fbd-9d22-569a17115c11 created_at: '2026-05-14 12:04:32.243' profile_id: 1 user_id: 2981d4b3-f8b1-44d8-9759-889f3bfa2faf method: POST path: /api_keys/usage/daily status_code: 200 duration_ms: 1821 log_type_id: 0 authentication_type: pubrio-api-key masked_authentication: 0••••••••••••••••f39 response_size: 2180 ip: 127.0.0.1 email: you@example.com nickname: Example User user: user_id: 2981d4b3-f8b1-44d8-9759-889f3bfa2faf nickname: Example User email: you@example.com log_type_slug: null credits: 0 log_type_name: null authentication_type_name: API Key '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: page: type: integer example: 1 default: 1 description: >- رقم الصفحة، بدءًا من 1. السقف هو `max_search_page` الخاص باشتراكك (`max_company_search_page` لبحث الشركات)، الذي تُعيده [Profile](/ar/api-reference/endpoint/profile/profile). تجاوزه يُعيد **HTTP 416**. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- السجلات لكل صفحة. القيمة الافتراضية 25، وهي أيضًا السقف في معظم الخطط — الحد هو `max_search_per_page` الخاص باشتراكك، الذي تُعيده [Profile](/ar/api-reference/endpoint/profile/profile). تجاوزه يُعيد **HTTP 416** برمز `41676` (أو `41613` في بحث الشركات والأشخاص)، لا مجموعة نتائج مقتطَعة. responses: general_error: description: >- طلب غير صحيح. كان الطلب مُصاغًا بشكل خاطئ أو يحتوي معاملات غير صالحة. تحقق من رمز الخطأ والرسالة للتفاصيل. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- تم تجاوز حد المعدل. نُفِّذت طلبات كثيرة جدًا خلال فترة زمنية معينة. أعِد المحاولة بعد إعادة ضبط نافذة حد المعدل. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- خطأ خادم داخلي. حدث خطأ غير متوقع في الخادم. تواصل مع الدعم إن استمر الخطأ. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- رمز API فريد يمثّل الإجراءات التي تنفّذها عبر الواجهة والصلاحيات والعمليات المقابلة. يمكنك إنشاءه عبر قسم [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````