Introduction

Implio needs to query your site in the following cases:

• Image requests: to retrieve the images referenced in the ads you send for moderation.
• Webhook requests: to deliver moderation results to you via a webhook you have registered

To avoid any potential problem, you should ensure that those requests are not subject to being blocked, throttled or restricted in any way by your servers, firewalls, or Content Delivery Network (CDN).

Image requests

Implio will perform a query for each image referenced in the ads you send to the API for moderation, using the URL you have specified.

This will allow images to be processed via automation, and subsequently served to Implio users (moderators) via the user interface.

Images are crawled once, and then stored in Implio. They should remain available for 72 hours on your servers (in case there are issues fetching your images and requests need to be retried), after which they can safely be deleted. 

All image requests made by Implio have the User-Agent header set to ImplioCrawler/[Version], where [Version] contains the version of the Implio service performing the request.

Webhook requests

Implio offers two ways for retrieving moderation results. One of them is to register a webhook which Implio will query to return moderation results to you.
For more information about webhooks and how to use them, please refer to this section or our API documentation.

All webhook requests made by Implio have the User-Agent header set to ImplioWebhook/[Version], where [Version] contains the version of the Implio service performing the request.

Authenticating Webhook Requests:

To ensure the authenticity of webhook requests, Implio supports the following methods:

1. API Key Authentication
   Each request includes an X-Api-Key header. You can validate this value against your configured key to confirm the request originates from Implio.
   Please refer to this section of our API documentation for more information.

2. Webhook Token (New)
   Implio now provides a webhook token when you register your webhook. This token can be used to verify that incoming requests are sent by Implio.

   The token is unique to your webhook and should be stored securely. It is included with each request in a dedicated header, and can be used on your end to confirm that the request is trusted.

IP-level filtering

Implio users on a paid plan can optionally have Implio perform requests using specific IP addresses:

• 99.80.37.153
• 63.34.124.141 

Both of these IP addresses resolve to the outgoing.implio.com hostname.

Please reach out to our customer support to enable this feature. You will then need to whitelist these IP addresses (or hostname) so they can access your servers.