> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/introduction.md).

# Introduction

L’API REST de Phalcon Compliance vous permet d’intégrer le filtrage des adresses et la surveillance des transactions directement dans vos applications et vos workflows. Que vous ayez besoin de vérifier un portefeuille avant de traiter un retrait ou de surveiller en continu des transactions sur plusieurs chaînes, l’API vous donne accès par programmation aux mêmes informations sur les risques que celles disponibles dans le tableau de bord Phalcon Compliance.

## Ce que vous pouvez faire

### Filtrage des adresses

Filtrez les adresses blockchain avec le moteur de risque pour identifier les entités sanctionnées, l’exposition à des fonds illicites et d’autres risques de conformité.

| Point de terminaison                                                                                                                                          | Description                                                          |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [`POST /address/screen`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/address-screening/screen-a-single-address.md)                      | Filtrer une seule adresse et obtenir les résultats du risque         |
| [`POST /addresses/screen`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/address-screening/batch-screen-addresses.md)                     | Filtrer jusqu’à 100 adresses dans une seule requête                  |
| [`GET /addresses/details/{chain_id}/{address}`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/address-screening/get-an-address-detail.md) | Récupérer une analyse détaillée des risques pour une adresse filtrée |
| [`GET /addresses/screen/tasks/{task_id}`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/address-screening/get-a-task-result.md)           | Vérifier les résultats d’une tâche de filtrage asynchrone            |
| [`PUT /addresses/{chain_id}/{address}`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/address-screening/update-an-address-info.md)        | Mettre à jour les libellés ou les notes personnalisés d’une adresse  |

### Filtrage des transactions

Surveillez l’exposition au risque d’une transaction individuelle ou d’un lot de transactions, y compris tous les transferts associés.

| Point de terminaison                                                                                                                                                         | Description                                                                      |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| [`POST /transaction/screen`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/transaction-screening/screen-a-single-transaction.md)                         | Filtrer une seule transaction                                                    |
| [`POST /transactions/screen`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/transaction-screening/batch-screen-transactions.md)                          | Filtrer jusqu’à 100 transactions dans une seule requête                          |
| [`GET /transactions/screen/tasks/{task_id}`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/transaction-screening/get-a-task-result.md)                   | Vérifier les résultats d’une tâche de filtrage asynchrone                        |
| [`GET /transactions/details/{transfer_id}`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/transaction-screening/get-a-transfer-detail.md)                | Obtenir des informations détaillées sur les risques pour un transfert spécifique |
| [`GET /transactions/transfers/{chain_id}/{hash}`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/transaction-screening/get-transfers-of-a-transaction.md) | Répertorier tous les transferts d’une transaction                                |

### Gestion des clients

Associez les adresses et les transactions filtrées à des clients spécifiques afin d’organiser le suivi de la conformité.

| Point de terminaison                                                                                                                                         | Description                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------ |
| [`GET /customers/details/{customer_id}`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/customer/get-a-customer-detail.md)                | Obtenir les détails d’un client spécifique |
| [`POST /customers/{customer_id}/addresses`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/customer/add-addresses-to-a-customer.md)       | Ajouter des adresses à un client           |
| [`POST /customers/{customer_id}/transactions`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/customer/add-transactions-to-a-customer.md) | Ajouter des transactions à un client       |

### Gestion des listes de blocage et d’autorisation

Gérez des listes d’adresses personnalisées pour signaler ou ignorer automatiquement les adresses pendant le filtrage.

| Point de terminaison                                                                                                                                             | Description                                       |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| [`POST /blacklists/add`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/blacklist-whitelist-management/add-addresses-to-blacklist.md)         | Ajouter des adresses à la liste de blocage        |
| [`POST /blacklists/remove`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/blacklist-whitelist-management/remove-addresses-from-blacklist.md) | Supprimer des adresses de la liste de blocage     |
| [`POST /whitelists/add`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/blacklist-whitelist-management/add-addresses-to-whitelist.md)         | Ajouter des adresses à la liste d’autorisation    |
| [`POST /whitelists/remove`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/blacklist-whitelist-management/remove-addresses-from-whitelist.md) | Supprimer des adresses de la liste d’autorisation |

### Gestion du compte

Consultez l’utilisation de l’API et le quota de votre projet.

| Point de terminaison                                                                                                                          | Description                                        |
| --------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| [`GET /account/usage/screening`](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/account-management/get-screening-usage.md) | Obtenir les statistiques d’utilisation du filtrage |

## Démarrage rapide

**1. Obtenez votre clé API** — Dans l’espace de travail de votre projet, accédez à **System → API**, puis cliquez sur **Generate Key**.

**2. Envoyez votre première requête :**

```bash
curl -X POST {BASE_URL}/address/screen \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_API_KEY" \
  -d '{
    "chainId": 1,
    "address": "0x..."
  }'
```

**3. Vérifiez la réponse** — Si le filtrage se termine en moins de 10 secondes, vous recevrez directement le résultat. Sinon, vous recevrez un Task ID à vérifier via `/addresses/screen/tasks/{task_id}` (ou via `/transactions/screen/tasks/{task_id}` pour le filtrage des transactions).

## Concepts clés

* **Moteurs de risque** — Chaque filtrage est effectué par plusieurs moteurs de risque. Les résultats comprennent le score de risque et les indicateurs de risque pour chaque moteur. Consultez la [liste des indicateurs de risque](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/introduction/risk-indicator-list.md) pour connaître tous les indicateurs possibles.
* **Tâches asynchrones** — Les requêtes par lot et les filtrages lents renvoient un Task ID. Une fois les résultats prêts, récupérez-les via `/addresses/screen/tasks/{task_id}` ou `/transactions/screen/tasks/{task_id}`.
* **Chain ID** — Chaque blockchain prise en charge possède un identifiant numérique de chaîne (par exemple, Ethereum = `1`, Bitcoin = `-1`). Consultez les [chaînes prises en charge](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/introduction/supported-chains.md) pour obtenir la liste complète.

## Étapes suivantes

* [Authentification](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/introduction/authentication.md) — Comment authentifier vos requêtes API
* [Limites de débit](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/introduction/rate-limits.md) — Limites de débit par défaut pour chaque point de terminaison
* [Chaînes prises en charge](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/introduction/supported-chains.md) — Chaînes et leurs ID
* [Journal des modifications](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/introduction/changelog.md) — Mises à jour récentes de l’API
