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

# سرد الإطارات المخصصة

> GET /qr-assets/custom-frame/

يسرد إطارات QR المخصصة الخاصة بهذا الحساب، على مضيف **Management API** (‏`api.scanova.io`‏)، مع المصادقة باستخدام مفتاح Management API الخام الخاص بك.

```
GET https://api.scanova.io/qr-assets/custom-frame/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```

<Note>
  للسرد فقط — لا توجد نقطة نهاية لإنشاء أو تحديث أو حذف الإطارات المخصصة في Management API؛ تُرفع عبر لوحة التحكم. على عكس معظم نقاط النهاية الأخرى في هذه الوحدة، لا يوجد حاجز حصة خطة على نقطة النهاية هذه.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.scanova.io/qr-assets/custom-frame/" \
    -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
      {
        "id": 4,
        "svg": "https://cdn.scanova.io/upload/frames/4.svg",
        "primary_color": "#000000",
        "secondary_color": "#ffffff",
        "text_color": "#000000",
        "bg_color": "#ffffff",
        "top": 0,
        "left": 0
      }
    ]
  }
  ```
</ResponseExample>

`top`/`left` هما إزاحتا موضع بالبكسل تُستخدمان عند عرض الإطار حول رمز QR.

## ذات صلة

* [سرد قوالب تصميم رموز QR](/ar/api-reference/management-api/qr-assets/template-list) — أين يُستخدم معرّف الإطار بعد اختياره.
* [نظرة عامة على Management API](/ar/api-reference/management-api/overview) — مخطط المصادقة وقواعد الحصة المطبّقة على نقطة النهاية هذه.


## OpenAPI

````yaml api-reference/openapi/management-api.json GET /qr-assets/custom-frame/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
    shared users & roles), plus the token-creation and usage-stats endpoints
    used to authenticate against it. Every path and request/response shape below
    was verified live against a real API key and the actual running backend
    (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://api.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /qr-assets/custom-frame/:
    get:
      summary: List custom frames
      description: >-
        List-only, no create/update/delete endpoint in the Management API. No
        plan quota gate on this endpoint, unlike most of this app's other list
        views.
      operationId: listCustomFrames
      responses:
        '200':
          description: Paginated list of custom frames.
          content:
            application/json:
              example:
                count: 1
                next: null
                previous: null
                results:
                  - id: 4
                    svg: https://cdn.scanova.io/upload/frames/4.svg
                    primary_color: '#000000'
                    secondary_color: '#ffffff'
                    text_color: '#000000'
                    bg_color: '#ffffff'
                    top: 0
                    left: 0
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. api.scanova.io) — the same key sent to the
        regular API host will not authenticate.

````