> 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 Phalcon Compliance vous permet d'intégrer le screening d'adresses et la surveillance des transactions directement dans vos applications et flux de travail. Que vous ayez besoin de vérifier un portefeuille unique avant de traiter un retrait ou de surveiller continuellement les transactions sur plusieurs chaînes, l'API fournit un accès programmatique à la même intelligence de risque disponible dans le tableau de bord Phalcon Compliance.

## Ce Que Vous Pouvez Faire

### Address Screening

Analysez les adresses de la blockchain par rapport aux moteurs de risque pour identifier les entités sanctionnées, l'exposition aux fonds illicites et autres risques de conformité.

| Point de terminaison                                                                                              | Description                                                              |
| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [`POST /address/screen`](/fr/api-documentation/address-screening/screen-a-single-address.md)                      | Analyser une seule adresse et obtenir les résultats de risque            |
| [`POST /addresses/screen`](/fr/api-documentation/address-screening/batch-screen-addresses.md)                     | Analyser jusqu'à 100 adresses en une seule demande                       |
| [`GET /addresses/details/{chain_id}/{address}`](/fr/api-documentation/address-screening/get-an-address-detail.md) | Récupérer la ventilation détaillée des risques pour une adresse analysée |
| [`GET /addresses/screen/tasks/{task_id}`](/fr/api-documentation/address-screening/get-a-task-result.md)           | Interroger les résultats des tâches de screening asynchrone              |
| [`PUT /addresses/{chain_id}/{address}`](/fr/api-documentation/address-screening/update-an-address-info.md)        | Mettre à jour les libellés personnalisés ou les notes sur une adresse    |

### Transaction Screening

Surveillez les transactions individuelles ou par lot pour l'exposition aux risques sur tous les transferts impliqués.

| Point de terminaison                                                                                                             | Description                                                                |
| -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| [`POST /transaction/screen`](/fr/api-documentation/transaction-screening/screen-a-single-transaction.md)                         | Analyser une seule transaction                                             |
| [`POST /transactions/screen`](/fr/api-documentation/transaction-screening/batch-screen-transactions.md)                          | Analyser jusqu'à 100 transactions en une seule demande                     |
| [`GET /transactions/screen/tasks/{task_id}`](/fr/api-documentation/transaction-screening/get-a-task-result.md)                   | Interroger les résultats des tâches de screening asynchrone                |
| [`GET /transactions/details/{transfer_id}`](/fr/api-documentation/transaction-screening/get-a-transfer-detail.md)                | Obtenir les informations détaillées de risque pour un transfert spécifique |
| [`GET /transactions/transfers/{chain_id}/{hash}`](/fr/api-documentation/transaction-screening/get-transfers-of-a-transaction.md) | Lister tous les transferts au sein d'une transaction                       |

### Customer Management

Liez les adresses et transactions analysées à des clients spécifiques pour un suivi de conformité organisé.

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

### Blacklist / Whitelist Management

Gérez les listes d'adresses personnalisées pour signaler automatiquement ou ignorer les adresses lors du screening.

| Point de terminaison                                                                                                 | Description                                |
| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| [`POST /blacklists/add`](/fr/api-documentation/blacklist-whitelist-management/add-addresses-to-blacklist.md)         | Ajouter des adresses à la liste noire      |
| [`POST /blacklists/remove`](/fr/api-documentation/blacklist-whitelist-management/remove-addresses-from-blacklist.md) | Supprimer des adresses de la liste noire   |
| [`POST /whitelists/add`](/fr/api-documentation/blacklist-whitelist-management/add-addresses-to-whitelist.md)         | Ajouter des adresses à la liste blanche    |
| [`POST /whitelists/remove`](/fr/api-documentation/blacklist-whitelist-management/remove-addresses-from-whitelist.md) | Supprimer des adresses de la liste blanche |

### Account Management

Interrogez l'utilisation de l'API et le quota de votre projet.

| Point de terminaison                                                                              | Description                                         |
| ------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| [`GET /account/usage/screening`](/fr/api-documentation/account-management/get-screening-usage.md) | Obtenir les statistiques d'utilisation du screening |

## Démarrage Rapide

**1. Obtenez votre clé API** — Allez à **System → API** dans votre espace de travail de projet et cliquez sur **Generate Key**.

**2. Faites votre première demande :**

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

**3. Vérifiez la réponse** — Si le screening se termine en moins de 10 secondes, vous obtenez les résultats directement. Sinon, vous recevez un Task ID pour interroger via `/task/result`.

## Concepts Clés

* **Risk Engines** — Chaque screening s'exécute par rapport à plusieurs moteurs de risque. Les résultats incluent les scores de risque et les indicateurs de risque par moteur. Consultez [Risk Indicator List](/fr/api-documentation/introduction/risk-indicator-list.md) pour tous les indicateurs possibles.
* **Async Tasks** — Les demandes par lot et les screenings lents renvoient un Task ID. Utilisez le point de terminaison `/task/result` pour récupérer les résultats lorsqu'ils sont prêts.
* **Chain IDs** — Chaque blockchain prise en charge a un ID de chaîne numérique (par exemple, Ethereum = `1`, Bitcoin = `-1`). Consultez [Supported Chains](/fr/api-documentation/introduction/supported-chains.md) pour la liste complète.

## Prochaines Étapes

* [Authentication](/fr/api-documentation/introduction/authentication.md) — Comment authentifier vos demandes d'API
* [Rate Limits](/fr/api-documentation/introduction/rate-limits.md) — Limites de débit par défaut par point de terminaison
* [Supported Chains](/fr/api-documentation/introduction/supported-chains.md) — Chaînes et leurs ID
* [Changelog](/fr/api-documentation/introduction/changelog.md) — Mises à jour récentes de l'API