API d’automatisation locale
Ouvrez « API d’automatisation » dans la barre latérale, puis cliquez sur « Démarrer l’API locale ». Prism affiche l’adresse de l’API (un port aléatoire sur 127.0.0.1) et le jeton d’accès de la session ; le jeton n’est affiché qu’une seule fois et devient invalide à l’arrêt de l’API.
| Requête | Fonction |
|---|---|
| GET /v1/status | État du service |
| GET /v1/profiles | Liste des profils : numéro, nom, groupe, étiquettes, état, date de dernière ouverture |
| GET /v1/profiles/{id}/status | État d’un profil |
| POST /v1/profiles/{id}/start | Lancement d’un profil, avec les mêmes vérifications préalables du proxy et limites de simultanéité que l’interface |
| POST /v1/profiles/{id}/close | Fermeture d’un profil |
| POST /v1/profiles | Création d’un profil, avec le nom, le groupe, le proxy et l’empreinte de votre choix (à partir de la 0.3.22) |
| POST /v1/profiles/batch | Création de 1 à 50 profils à la fois, enregistrés seulement si tous sont valides (à partir de la 0.3.22) |
curl -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles
curl -X POST -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles/$PROFILE_ID/start- Seules les requêtes provenant de l’ordinateur local sont acceptées : l’en-tête Host doit correspondre à l’adresse de l’API, et les requêtes comportant un en-tête Origin de navigateur ou des paramètres de requête sont refusées (seuls les points de terminaison de création acceptent un corps JSON) ; une page web ne peut donc pas l’appeler directement.
- 120 requêtes par minute au maximum (quota partagé avec le pont local MCP).
- L’API peut créer, consulter, lancer et fermer des profils ; elle ne peut ni modifier ni supprimer les profils, ni lire les données du navigateur. L’API elle-même ne fournit aucun point de terminaison de débogage Puppeteer / Playwright (la version Windows ouvre un port de débogage aléatoire sur 127.0.0.1 pour son contrôle interne ; ce n’est pas une interface publique).
- « Arrêt d’urgence » ferme les profils lancés par l’API ; les appels sont consignés dans un journal d’audit local.
Pour les règles de requête, les champs de réponse, les codes d’erreur et les exemples Python / Node.js, consultez la référence de l’API locale.
Tâches planifiées locales
| Paramètre | Valeurs possibles |
|---|---|
| Action | Lancer le profil / Fermer le profil |
| Répétition | Une fois / Quotidien / Hebdomadaire (plusieurs jours possibles, du dimanche au samedi) |
| Date et heure d’exécution | Heure et fuseau horaire de l’ordinateur |
| Exécution manquée | Rattraper une fois (dans les 24 heures) / Ignorer cette exécution |
| Nouvelles tentatives en cas d’échec | 0 à 3 fois, avec un intervalle de 1 à 60 minutes |
- Les tâches planifiées ne s’exécutent que lorsque Prism est ouvert, sans processus résident en arrière-plan ; les tâches arrivées à échéance sont vérifiées toutes les 15 secondes, avec 2 exécutions simultanées au maximum.
- Vous pouvez tester une tâche avec « Exécuter maintenant » ; un profil utilisé par une tâche planifiée ne peut être supprimé qu’après avoir été retiré de la tâche.
- Lorsque la licence Pro n’est plus valide, la planification est suspendue ; les tâches sont conservées et peuvent toujours être désactivées ou supprimées.
Exemples de combinaison
Des profils de travail prêts dès l’arrivée au bureau
Lancez vos profils habituels chaque jour à 09:00 et fermez-les avant la fin de la journée : moins de manipulations manuelles et d’ouvertures par erreur.
Lancement et arrêt groupés par script
Dans votre propre script, appelez d’abord GET /v1/profiles pour trouver l’ID des profils, puis lancez-les dans l’ordre : la logique de lancement est la même que dans l’interface.
Laisser l’IA prendre le relais
Une fois les profils lancés, MCP lit les pages et effectue les étapes suivantes dans les profils que vous avez autorisés.
Questions fréquentes
- Peut-on exécuter des scripts personnalisés ou des flux RPA ?
- Les tâches planifiées permettent uniquement de lancer et de fermer des profils, et l’API n’exécute pas de scripts. Pour agir au niveau des pages, utilisez MCP (Pro) ou installez vous-même des extensions dans les profils.
- L’API est-elle compatible avec celles d’autres navigateurs antidétection ?
- Non. Prism utilise sa propre interface locale ; les chemins figurent dans le tableau ci-dessus.
- Les tâches planifiées s’exécutent-elles quand Prism est fermé ?
- Non. Les tâches planifiées nécessitent que Prism soit ouvert ; selon le réglage, une exécution manquée peut être rattrapée une fois dans les 24 heures.