> ## 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.
# Lister les modèles de page
> GET /page-template/
Liste les modèles de page, sur l'hôte de l'**API de gestion** (`api.scanova.io`), authentifié avec votre clé d'API de gestion brute.
```
GET https://api.scanova.io/page-template/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
Liste uniquement les propres modèles de l'appelant plutôt que la galerie système — non paginé, les plus récemment modifiés en premier. Vide pour les appels non authentifiés.
Filtre la galerie système aux modèles dont les tags incluent ce slug de catégorie de QR. S'applique uniquement lorsque `mine` n'est pas défini.
Recherche dans le nom/la description du modèle.
Numéro de page.
Résultats par page, 100 maximum.
```bash cURL theme={null}
curl "https://api.scanova.io/page-template/?category=website-url" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
```
```json 200 theme={null}
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3,
"name": "Product Launch",
"slug": "product-launch-a1b2c3",
"description": "A landing page for launches.",
"category": { "id": 5, "slug": "website-url", "name": "Website URL" },
"theme": {
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#0077be", "background": "#f0f8ff" } },
"schema_version": 2,
"category_hints": ["website-url"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
},
"blocks_json": [{ "type": "hero" }],
"filter_tags": ["business", "launch"],
"accent_color": "#0077be",
"preview_bg": "#f0f8ff",
"thumbnail_url": "https://cdn.scanova.io/page-templates/3/thumb.png",
"is_premium": false,
"is_system": true,
"is_favourited": false,
"order": 0
}
]
}
```
Par défaut, il s'agit de la galerie de modèles système (`is_system: true`, 20 par page, triés par favoris d'abord puis par `order`). Passez `?mine=true` pour passer à vos propres modèles à la place — notez que la forme de la réponse reste la même, mais la pagination/le tri diffère comme décrit ci-dessus.
## Voir aussi
* [Créer un modèle de page](/fr/api-reference/management-api/theme-manager/page-template-create) — en enregistrer un nouveau.
* [Lister les tags des modèles de page](/fr/api-reference/management-api/theme-manager/page-template-tags) — voir les valeurs de `category`/tag existant dans la galerie.
* [Ajouter un modèle de page aux favoris](/fr/api-reference/management-api/theme-manager/page-template-favourite) — basculer `is_favourited` pour un modèle.
* [Présentation de l'API de gestion](/fr/api-reference/management-api/overview) — le schéma d'authentification et les règles de quota applicables à cet endpoint.
## OpenAPI
````yaml api-reference/openapi/management-api.json GET /page-template/
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:
/page-template/:
get:
summary: List page templates
description: >-
By default, the system template gallery (`is_system: true`), paginated
20/page, ordered by favourited-first then `order`. Pass `?mine=true` to
instead list the caller's own templates (unpaginated, newest-modified
first) — empty for unauthenticated calls.
operationId: listPageTemplates
parameters:
- name: mine
in: query
required: false
schema:
type: boolean
description: List only the caller's own templates instead of the system gallery.
- name: category
in: query
required: false
schema:
type: string
description: >-
Filter the system gallery to templates whose filter_tags include
this category slug.
- name: search
in: query
required: false
schema:
type: string
description: Search template name/description.
- name: page
in: query
required: false
schema:
type: integer
- name: page_size
in: query
required: false
schema:
type: integer
description: Max 100.
responses:
'200':
description: Paginated list of page templates.
content:
application/json:
example:
count: 1
next: null
previous: null
results:
- id: 3
name: Product Launch
slug: product-launch-a1b2c3
description: A landing page for launches.
category:
id: 5
slug: website-url
name: Website URL
theme:
id: 7
name: Ocean Breeze
slug: user-42-ocean-breeze-a1b2c3
description: A cool blue palette.
config_json:
color:
accent: '#0077be'
background: '#f0f8ff'
font:
heading: Inter
schema_version: 2
category_hints:
- website-url
- vcard
thumbnail_url: https://cdn.scanova.io/themes/7/thumb.png
is_system: false
is_premium: false
order: 0
blocks_json:
- type: hero
filter_tags:
- business
- launch
accent_color: '#0077be'
preview_bg: '#f0f8ff'
thumbnail_url: https://cdn.scanova.io/page-templates/3/thumb.png
is_premium: false
is_system: true
is_favourited: false
order: 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.
````