Offres et limites
Ce qu'une licence peut télécharger et récupérer par jour, ce qui se passe au-delà d'une limite et comment rester en dessous. Les prix et le contenu de chaque offre se trouvent sur la page Tarifs.
En bref
- Téléchargements de la version sous licence : 20 par minute et 30 par 24 heures pour une même version. Les lancements qui trouvent la version dans leur cache ne comptent jamais.
- Personas différentes par jour : 750 avec l'offre gratuite, 1,000,000 avec les offres payantes. Relancer une seed déjà utilisée aujourd'hui ne coûte rien.
- Au-delà d'une limite, vous recevez HTTP 429. Gardez le cache du navigateur sur un volume et réutilisez un ensemble fixe de seeds.
Limites de téléchargement
Les téléchargements de la version sous licence sont limités par licence, pour qu'une configuration qui récupère l'archive complète à chaque démarrage ne s'emballe pas. Un lancement qui trouve la version dans son cache ne télécharge rien et ne compte jamais : seuls les vrais téléchargements comptent.
| Limite | S'applique à | Ce qui compte |
|---|---|---|
| 20 téléchargements par minute et 30 par 24 heures | Chaque licence, par version (numéro de version + OS) | Téléchargements de l'archive d'une même version. Une nouvelle version repart avec un quota neuf. |
| 10 versions différentes par 24 heures | Licences gratuites | Versions distinctes récupérées. Une version déjà téléchargée aujourd'hui ne coûte plus rien. |
| 60 vérifications par minute | Par adresse IP | La vérification de version que chaque lancement fait auprès de /api/v1/download/pro, en cache ou non. |
Au-delà d'une limite, le SDK reçoit HTTP 429 avec un corps JSON (code vaut DOWNLOAD_RATE_LIMITED (quota par version) ou DOWNLOAD_LIMIT_EXCEEDED (offre gratuite)) et un en-tête Retry-After : le nombre de secondes avant que la limite se réinitialise. Les lancements dont la version est déjà en cache continuent de fonctionner. Depuis le SDK 0.62.0, un lancement qui ne peut pas télécharger une nouvelle version démarre, au lieu d'échouer, la version la plus récente de la même version de Chromium déjà dans son cache, et attend Retry-After avant de retenter ce téléchargement. Un lancement épinglé à une révision exacte (r50) reçoit toujours cette version ou une erreur.
Vous atteignez ces limites quand beaucoup de machines ou de conteneurs neufs démarrent en même temps, chacun avec un cache vide. Téléchargez chaque version une fois par machine plutôt qu'à chaque démarrage : les démarrages sont aussi plus rapides, sans téléchargement d'environ 460 Mo :
- Gardez le cache sur un volume. Pointez
CLEARCOTE_CACHEvers un dossier qui survit aux redémarrages. Les démarrages qui le partagent attendent le premier téléchargement et le réutilisent. - Intégrez le navigateur à votre image. Lancez
clearcote installau moment du build, pour que chaque conteneur démarre avec la version en place. Reconstruisez l'image lors d'une mise à jour.
# 1. a shared, persistent cache
docker run -v clearcote-cache:/clearcote-cache -e CLEARCOTE_CACHE=/clearcote-cache …
# 2. or in your Dockerfile: download once while the image is built (the key stays out of the layers)
ENV CLEARCOTE_CACHE=/opt/clearcote-cache
RUN --mount=type=secret,id=clearcote_key \
CLEARCOTE_LICENSE_KEY="$(cat /run/secrets/clearcote_key)" clearcote installNeed a higher limit? Tell us how you run Clearcote and we'll raise it for your licence.
Chat with usLimites de personas
Chaque lancement récupère sa persona (l’empreinte que décrivent la seed et les options) auprès du service de personas. Chaque licence peut récupérer un nombre défini de personas différentes par jour. Récupérer une persona déjà utilisée aujourd’hui ne coûte rien : un ensemble fixe de profils peut donc être relancé aussi souvent que vous le voulez.
| Offre | Personas différentes par jour |
|---|---|
| Gratuite | 750 |
| Pro et autres offres payantes | 1,000,000 |
Une persona correspond à une seed avec un ensemble d’options d’empreinte (marque, plateforme, etc.) : la même seed en Chrome et en Edge compte donc deux fois. Le compteur est remis à zéro à 00:00 UTC. Au-delà de la limite, le lancement échoue avec HTTP 429 renvoyé par le service de personas (daily persona quota reached) jusqu’à la remise à zéro.
Vous atteignez cette limite quand chaque lancement utilise une seed aléatoire toute neuve. Réutilisez plutôt un ensemble fixe de seeds, par exemple une liste de quelques centaines de noms que vous faites tourner : chacune garde la même empreinte à chaque démarrage, et la relancer n’est jamais recomptée.