> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# عدد القوالب البيومترية API

> عدد قوالب الوجه البيومترية الخالية من الصور المحفوظة عبر Didit، باستخدام نفس فلاتر endpoint القائمة. GET /v3/biometric-templates/count/

تُرجع عدد القوالب التي تطابق نفس عوامل التصفية المستخدمة في [قائمة القوالب البيومترية](https://docs.didit.me/ar/management-api/biometric-templates/list.md). لا تُحتسب القوالب التي تم حذفها نهائيًا.

```bash theme={null}
curl -X GET "https://verification.didit.me/v3/biometric-templates/count/?status=active" \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
{ "count": 128 }
```

استخدمه لعرض الإجمالي على لوحة التحكم، أو للتحقق مما سيشمله [الحذف الجماعي](https://docs.didit.me/ar/management-api/biometric-templates/batch-purge.md) المطبَّق على النتائج المُصفّاة مع `delete_all: true` قبل تشغيله.


## OpenAPI

````yaml ar/openapi-25.json GET /v3/biometric-templates/count/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API التحقق من الهوية. قم بالمصادقة باستخدام الرأس x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/biometric-templates/count/:
    get:
      tags:
        - Biometric Templates
      summary: عدد القوالب البيومترية المحتفظ بها
      description: >-
        يحتفظ التطبيق المشترك بقالب بيومتري واحد للوجه مُدار بشكل منفصل وخالٍ من
        الصور ومرتبط بالمستخدم عند حذف الجلسة (راجع `DELETE
        /v3/session/{sessionId}/delete/`). تُعد القوالب بيانات بيومترية ذات
        `expires_at` محدد؛ ولا تحتوي مطلقاً على صور أو بيانات جلسة أو حقول هوية،
        وتُحذف نهائياً عند حذف المستخدم أو محو البيانات للخصوصية أو انتهاء
        الصلاحية أو الحذف النهائي الصريح. تقبل هذه الـ endpoints مفاتيح API
        للتطبيق (`x-api-key`) فقط؛ ويتم رفض رموز مستخدمي Business Console بالرمز
        `403`.


        يُرجع عدد القوالب المطابقة لنفس عوامل التصفية المستخدمة في endpoint
        القائمة. استخدمه للتحقق مما سيشمله الحذف النهائي المجمّع والمصفى
        باستخدام `delete_all: true`.
      operationId: count_biometric_templates
      parameters:
        - in: query
          name: vendor_data
          required: false
          description: >-
            تطابق لسلسلة فرعية غير حساس لحالة الأحرف في `vendor_data` الحالي
            للمستخدم المالك.
          schema:
            type: string
        - in: query
          name: vendor_user_uuid
          required: false
          description: تطابق تام في المستخدم المالك.
          schema:
            type: string
            format: uuid
        - in: query
          name: status
          required: false
          description: حالة دورة الحياة. لا يتم إدراج القوالب التي تم حذفها نهائياً.
          schema:
            type: string
            enum:
              - pending
              - active
              - expired
              - held_out_of_use
              - purge_pending
              - purge_failed
        - in: query
          name: source_type
          required: false
          description: كيفية إنشاء القالب.
          schema:
            type: string
            enum:
              - session_delete
              - automatic_retention
              - backfill
        - in: query
          name: retained_from
          required: false
          description: القوالب التي تم الاحتفاظ بها في هذا الوقت أو بعده.
          schema:
            type: string
            format: date-time
        - in: query
          name: retained_to
          required: false
          description: >-
            القوالب التي تم الاحتفاظ بها في هذا الوقت أو قبله. يجب ألا يسبق
            `retained_from` (`400`).
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: العدد.
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                    minimum: 0
              examples:
                Count:
                  value:
                    count: 128
        '400':
          description: >-
            قيمة تصفية غير صالحة، أو `retained_to` يسبق `retained_from`. أخطاء
            التحقق من الصحة مفهرسة حسب الحقل.
          content:
            application/json:
              examples:
                Bad range:
                  value:
                    retained_to:
                      - Must be on or after retained_from.
        '403':
          description: >-
            token مستخدم Console، أو مفتاح API غير مسموح به. تقبل هذه endpoints
            مفاتيح API الخاصة بالتطبيق فقط.
          content:
            application/json:
              examples:
                Forbidden:
                  value:
                    detail: You do not have permission to perform this action.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            'https://verification.didit.me/v3/biometric-templates/count/?status=active'
            \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.biometric_templates.count()
            print(result)
        - lang: javascript
          label: Node.js
          source: |-
            import Didit from "@didit-protocol/sdk-node";

            // Reads DIDIT_API_KEY.
            const didit = new Didit();

            const result = await didit.biometricTemplates.count();
            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.BiometricTemplates.Count(ctx, didit.BiometricTemplatesCountParams{})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: |-
            import me.didit.Didit;

            // Reads DIDIT_API_KEY.
            Didit client = new Didit();

            var result = client.biometricTemplates().count();
            System.out.println(result);
        - lang: php
          label: PHP
          source: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY.
            $didit = new DiditClient();

            $result = $didit->biometricTemplates->count();
            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY.
            didit = Didit::Client.new

            result = didit.biometric_templates.count
            puts result.to_h
        - lang: csharp
          label: .NET
          source: |-
            using System;
            using System.Text.Json;
            using Didit;

            // Reads DIDIT_API_KEY.
            using var client = new DiditClient();

            var result = await client.BiometricTemplates.CountAsync();
            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console.
        يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا
        شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات
        المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن
        المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم
        إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو
        الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير
        404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة
        بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL
        للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك
        إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع
        https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.