Categorize API
Généralités
L'API de catégorisation d'Olfeo OEM vous permet en une requête d'obtenir la catégorie d'une ou plusieurs URL ou IP et d'obtenir des informations utiles pour prendre des décisions éclairées à leur propos (filtrage, modération, routage, analyse etc.)
Catégories de domaines, URL ou IP
La base de données d'Olfeo OEM contient plus de 100 catégories de classement réparties dans 10 thèmes, offrant ainsi une granularité optimale pour vos analyses, contrôles, filtrage etc.
Appartenance à une application SaaS
Lors de la catégorisation d'une URL/domaine/IP, si le service trouve au moins une correspondance avec une applications SaaS, l'application_id est retourné, ce qui permet ensuite d'obtenir des informations supplémentaires via les points de terminaison dédiés.
Utiliser l'API Categorize
S'authentifier sur l'API Categorize
L'ensemble des points de terminaison de l'API Categorize requièrent une authentification fournie via une clé d'API (format Bearer token) écupérable depuis l'API Authenticate.
Catégorisation simple ou avancée
Deux points de terminaison principaux permettent de catégoriser une URL/domaine/IP :
GetCategory(): retourne des informations détaillées. Utilisez ce point de terminaison si vous souhaitez catégoriser des IP (à passer dans le champhost) ou si vous souhaitez catégoriser des URL entières : en plus de la catégorisation du nom de domaine complet (host), des informations de classement alternatifs fondés sur le chemin (path) pourront être fournies le cas échéant.GetSimpleCategory(): retourne la catégorie estimée la plus pertinente, sans détails supplémentaires. Simple et efficace si vous ne disposez que du FQDN.
Performances et limitation de débit
Veuillez noter que nous appliquons une 50 réq/sec limitation de l'API Categorize.
Dans ce cas, vous devriez obtenir un HTTP 429 Client resources exhausted code d'état.
Tutoriel sur l'interface Swagger
Un tutoriel est mis à votre disposition, si vous souhaitez apprendre à utiliser cet interface Swagger.