Skip to main content
POST
Mettre à jour un moniteur

Autorisations

pubrio-api-key
string
header
requis

Un jeton API unique qui représente les actions que vous effectuez via l'API ainsi que les autorisations et opérations correspondantes. Vous pouvez le créer dans la section Settings.

Corps

application/json
monitor_id
string<uuid>
requis

Identifiant unique du moniteur à mettre à jour.

name
string

Nom du moniteur.

description
string

Description du moniteur.

detection_mode
enum<string>

Mode de détection des signaux. signal_first scanne largement le marché ; company_first suit une liste de comptes nommés et nécessite au moins une entreprise, un domaine ou une URL LinkedIn. Immuable après création — sa modification sur un moniteur existant renvoie 40021. Créez plutôt un nouveau moniteur.

Options disponibles:
company_first,
signal_first
signal_types
enum<string>[]

Types de signaux à surveiller.

Options disponibles:
jobs,
news,
advertisements,
expansions
signal_filters
object[]

Une entrée par flux de signal surveillé par le moniteur.

Exemple:
company_filters
object

Filtres d'entreprise globaux appliqués comme second niveau à tous les types de signaux. Accepte les mêmes paramètres que le point de terminaison Recherche d'entreprises — localisations, effectifs, technologies, secteurs verticaux, etc.

Exemple:
companies
string<uuid>[]

Liste d'UUID domain_search_id d'entreprise. Alternative : utilisez domains ou linkedin_urls.

domains
string[]

Liste de domaines d'entreprise. Alternative à companies.

linkedin_urls
string<uri>[]

Liste d'URL LinkedIn d'entreprise. Alternative à companies.

is_company_enrichment
boolean

Indique s'il faut enrichir les données d'entreprise.

is_people_enrichment
boolean

Indique s'il faut enrichir les données de personnes.

people_enrichment_configs
object[]

Tableau de couches d'enrichissement de personnes. Chaque couche exécute une recherche de personnes indépendante. Contient max_people_to_return (1-25), people_contact_types (tableau — fait référence aux types de contact de Rachat : email-work, email-personal, phone) et filters (mêmes paramètres que le point de terminaison Recherche de personnes).

Exemple:
destination_type
enum<string>

Type de destination de livraison.

Options disponibles:
webhook,
email,
sequences
destination_config
object

Configuration de la destination. Pour un webhook : nécessite webhook_url (chaîne), et facultativement headers (objet) et body (objet). Pour un e-mail : accepte email (chaîne) ou emails (tableau de chaînes). Pour les séquences : nécessite sequence_identifier (chaîne) ainsi qu'au moins l'un des paramètres is_people_search_enrolled / is_company_contact_enrolled défini sur true.

Exemple:
frequency_minute
integer

Fréquence de déclenchement en minutes. Min : 0, Max : 10080, Par défaut : 0.

Plage requise: 0 <= x <= 10080
max_failure_trigger
integer

Nombre maximal d'échecs consécutifs avant la mise en pause. Min : 1, Max : 10, Par défaut : 5.

Plage requise: 1 <= x <= 10
max_daily_trigger
integer

Nombre maximal de déclenchements par jour. Min : 0, Max : 86400, Par défaut : 500.

Plage requise: 0 <= x <= 86400
max_records_per_trigger
integer

Contrôle le nombre maximal d'enregistrements livrés par déclenchement. Des valeurs plus faibles réduisent la taille de la charge utile par livraison, ce qui est recommandé pour les jeux de résultats volumineux ou les intégrations à débit limité. Min : 1, Max : 100, Par défaut : 25. Consultez Configuration des webhooks pour plus d'indications.

Plage requise: 1 <= x <= 100
notification_email
string<email>

E-mail pour les notifications d'échec.

max_retry_per_trigger
integer

Nombre maximal de nouvelles tentatives par déclenchement. Min : 0, Max : 3, Par défaut : 1.

Plage requise: 0 <= x <= 3
retry_delay_second
integer

Délai entre les tentatives, en secondes. Min : 1, Max : 5, Par défaut : 1.

Plage requise: 1 <= x <= 5
status
enum<string>

Statut du cycle de vie à définir. La modification du statut réinitialise le compteur d'échecs.

Options disponibles:
draft,
active,
paused,
inactive

Réponse

Réponse réussie contenant le moniteur mis à jour. La réponse inclut toujours monitor_id, name, detection_mode, destination_type, status, masked_signature et last_modified, ainsi que toutes les autres colonnes ayant fait partie de la mise à jour.

data
object

Le moniteur mis à jour. Toutes les autres colonnes incluses dans la mise à jour sont également renvoyées.