> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Créer une session Interact
> Démarrer une session de navigateur Interact autonome, pilotée par code (sans scrape préalable).
| En-tête | Valeur |
| --------------- | ------------------ |
| `Authorization` | `Bearer ` |
| `Content-Type` | `application/json` |
## Corps de la requête
| Paramètre | Type | Obligatoire | Valeur par défaut | Description |
| --------------------- | ------- | ----------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ttl` | number | Non | 600 | Durée de vie totale de la session en secondes (30-3600) |
| `activityTtl` | number | Non | 300 | Nombre de secondes d'inactivité avant la destruction de la session (10-3600) |
| `profile` | object | Non | — | Active un stockage persistant d'une session à l'autre. Voir ci-dessous. |
| `profile.name` | string | Oui\* | — | Nom du profil (1-128 caractères). Les sessions portant le même nom partagent le stockage. |
| `profile.saveChanges` | boolean | Non | `true` | Lorsque `true`, l'état du navigateur est enregistré dans le profil à la fermeture. Définissez sur `false` pour charger les données existantes sans écriture. Un seul enregistreur est autorisé à la fois. |
## Réponse
| Champ | Type | Description |
| ------------------------ | ------- | ---------------------------------------------------------------------------- |
| `success` | boolean | Indique si la session a bien été créée |
| `id` | string | Identifiant unique de la session |
| `cdpUrl` | string | URL WebSocket pour les connexions CDP |
| `liveViewUrl` | string | URL pour afficher la session en temps réel |
| `interactiveLiveViewUrl` | string | URL pour interagir avec la session en temps réel (clics, saisie, défilement) |
| `expiresAt` | string | Date d’expiration de la session en fonction du TTL |
### Exemple de requête
```bash theme={null}
curl -X POST "https://api.firecrawl.dev/v2/interact" \
-H "Authorization: Bearer $FIRECRAWL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"ttl": 120
}'
```
### Exemple de réponse
```json theme={null}
{
"success": true,
"id": "550e8400-e29b-41d4-a716-446655440000",
"cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-e29b-41d4-a716-446655440000",
"liveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000",
"interactiveLiveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000?interactive=true"
}
```
> Êtes-vous un agent IA qui a besoin d’une clé API Firecrawl ? Consultez [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) pour obtenir les instructions d’intégration automatisée.
## OpenAPI
````yaml fr/api-reference/v2-openapi.json POST /interact
openapi: 3.0.0
info:
contact:
email: support@firecrawl.dev
name: Firecrawl Support
url: https://firecrawl.dev/support
description: >-
API pour interagir avec les services Firecrawl afin d’effectuer des tâches
de scraping et de crawling web.
title: Firecrawl API
version: v2
servers:
- url: https://api.firecrawl.dev/v2
security:
- bearerAuth: []
paths:
/interact:
post:
tags:
- Interact
summary: Créer une session Interact
operationId: createBrowserSession
requestBody:
content:
application/json:
schema:
properties:
activityTtl:
description: >-
Temps en secondes avant la destruction de la session pour
cause d’inactivité
maximum: 3600
minimum: 10
type: integer
profile:
description: >-
Active le stockage persistant entre les sessions Interact.
Les données enregistrées dans une session peuvent être
chargées dans une session ultérieure en utilisant le même
nom.
properties:
name:
description: >-
Nom du profil. Les sessions portant le même nom
partagent le stockage.
maxLength: 128
minLength: 1
type: string
saveChanges:
default: true
description: >-
Lorsque cette valeur est définie sur true, l’état du
Browser est enregistré dans le profil à la fermeture.
Définissez-la sur false pour charger les données
existantes sans les enregistrer. Plusieurs sessions sans
enregistrement sont autorisées, mais une seule session
avec enregistrement à la fois.
type: boolean
required:
- name
type: object
streamWebView:
default: true
description: Indique s’il faut diffuser une vue en direct du Browser
type: boolean
ttl:
default: 300
description: Durée de vie totale de la session Interact, en secondes
maximum: 3600
minimum: 30
type: integer
type: object
required: true
responses:
'200':
content:
application/json:
schema:
properties:
cdpUrl:
description: URL WebSocket pour accéder au protocole Chrome DevTools
type: string
expiresAt:
description: Date d’expiration de la session selon le TTL
format: date-time
type: string
id:
description: Identifiant unique de la session
type: string
interactiveLiveViewUrl:
description: >-
URL pour Interact avec la session Interact en temps réel
(cliquer, saisir, faire défiler)
type: string
liveViewUrl:
description: URL pour consulter la session Interact en temps réel
type: string
success:
type: boolean
type: object
description: Session Interact créée avec succès
'402':
content:
application/json:
schema:
properties:
error:
example: Payment required to access this resource.
type: string
type: object
description: Paiement requis
security:
- bearerAuth: []
components:
securitySchemes:
bearerAuth:
scheme: bearer
type: http
````