> 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/tr/api-documentation/introduction.md).

# Giriş

Phalcon Compliance REST API, adres taramasını ve işlem izlemeyi doğrudan uygulamalarınıza ve iş akışlarınıza entegre etmenizi sağlar. İster bir para çekme işlemini gerçekleştirmeden önce tek bir cüzdanı kontrol etmeniz, ister birden fazla zincirdeki işlemleri sürekli izlemeniz gereksin, API, Phalcon Compliance panosunda bulunan risk istihbaratına programatik erişim sağlar.

## Yapabilecekleriniz

### Adres Taraması

Yaptırıma tabi varlıkları, yasa dışı fonlara maruziyeti ve diğer uyumluluk risklerini belirlemek için blockchain adreslerini risk motoruna göre tarayın.

| Endpoint                                                                                                                                                      | Açıklama                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| [`POST /address/screen`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/address-screening/screen-a-single-address.md)                      | Tek bir adresi tarayın ve risk sonuçlarını alın         |
| [`POST /addresses/screen`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/address-screening/batch-screen-addresses.md)                     | Tek bir istekte en fazla 100 adresi tarayın             |
| [`GET /addresses/details/{chain_id}/{address}`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/address-screening/get-an-address-detail.md) | Taranmış bir adresin ayrıntılı risk dökümünü alın       |
| [`GET /addresses/screen/tasks/{task_id}`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/address-screening/get-a-task-result.md)           | Eşzamansız bir tarama görevinin sonuçlarını sorgulayın  |
| [`PUT /addresses/{chain_id}/{address}`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/address-screening/update-an-address-info.md)        | Bir adres için özel etiketleri veya notları güncelleyin |

### İşlem Taraması

İlişkili tüm transferler de dahil olmak üzere tek bir işlemin veya bir işlem grubunun risk maruziyetini izleyin.

| Endpoint                                                                                                                                                                     | Açıklama                                                  |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| [`POST /transaction/screen`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/transaction-screening/screen-a-single-transaction.md)                         | Tek bir işlemi tarayın                                    |
| [`POST /transactions/screen`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/transaction-screening/batch-screen-transactions.md)                          | Tek bir istekte en fazla 100 işlemi tarayın               |
| [`GET /transactions/screen/tasks/{task_id}`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/transaction-screening/get-a-task-result.md)                   | Eşzamansız bir tarama görevinin sonuçlarını sorgulayın    |
| [`GET /transactions/details/{transfer_id}`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/transaction-screening/get-a-transfer-detail.md)                | Belirli bir transfer için ayrıntılı risk bilgilerini alın |
| [`GET /transactions/transfers/{chain_id}/{hash}`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/transaction-screening/get-transfers-of-a-transaction.md) | Bir işlemdeki tüm transferleri listeleyin                 |

### Müşteri Yönetimi

Düzenli uyumluluk takibi için taranan adresleri ve işlemleri belirli müşterilerle ilişkilendirin.

| Endpoint                                                                                                                                                     | Açıklama                                       |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------- |
| [`GET /customers/details/{customer_id}`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/customer/get-a-customer-detail.md)                | Belirli bir müşteriyle ilgili ayrıntıları alın |
| [`POST /customers/{customer_id}/addresses`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/customer/add-addresses-to-a-customer.md)       | Bir müşteriye adres ekleyin                    |
| [`POST /customers/{customer_id}/transactions`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/customer/add-transactions-to-a-customer.md) | Bir müşteriye işlem ekleyin                    |

### Kara/Beyaz Liste Yönetimi

Tarama sırasında adresleri otomatik olarak işaretlemek veya atlamak için özel adres listelerini yönetin.

| Endpoint                                                                                                                                                         | Açıklama                      |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| [`POST /blacklists/add`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/blacklist-whitelist-management/add-addresses-to-blacklist.md)         | Kara listeye adres ekleyin    |
| [`POST /blacklists/remove`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/blacklist-whitelist-management/remove-addresses-from-blacklist.md) | Kara listeden adres kaldırın  |
| [`POST /whitelists/add`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/blacklist-whitelist-management/add-addresses-to-whitelist.md)         | Beyaz listeye adres ekleyin   |
| [`POST /whitelists/remove`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/blacklist-whitelist-management/remove-addresses-from-whitelist.md) | Beyaz listeden adres kaldırın |

### Hesap Yönetimi

Projenizin API kullanımını ve kotasını sorgulayın.

| Endpoint                                                                                                                                      | Açıklama                              |
| --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| [`GET /account/usage/screening`](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/account-management/get-screening-usage.md) | Tarama kullanım istatistiklerini alın |

## Hızlı Başlangıç

**1. API anahtarınızı alın** — Proje çalışma alanınızda **Sistem → API** bölümüne gidin ve ardından **Anahtar Oluştur**'a tıklayın.

**2. İlk isteğinizi gönderin:**

```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. Yanıtı kontrol edin** — Tarama 10 saniye içinde tamamlanırsa sonucu doğrudan alırsınız. Aksi takdirde, `/addresses/screen/tasks/{task_id}` üzerinden (işlem taraması için `/transactions/screen/tasks/{task_id}` üzerinden) sorgulayabileceğiniz bir Task ID alırsınız.

## Temel Kavramlar

* **Risk Motorları** — Her tarama birden fazla risk motoruyla yürütülür. Sonuçlar, her motor için risk puanını ve risk göstergelerini içerir. Tüm olası göstergeler için [Risk Göstergeleri Listesi](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/introduction/risk-indicator-list.md) sayfasına bakın.
* **Eşzamansız Görevler** — Toplu istekler ve uzun süren taramalar bir Task ID döndürür. Sonuçlar hazır olduğunda, bunları `/addresses/screen/tasks/{task_id}` veya `/transactions/screen/tasks/{task_id}` kullanarak alın.
* **Chain ID** — Desteklenen her blockchain'in sayısal bir Chain ID değeri vardır (örneğin, Ethereum = `1`, Bitcoin = `-1`). Tam liste için [Desteklenen Zincirler](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/introduction/supported-chains.md) sayfasına bakın.

## Sonraki Adımlar

* [Kimlik Doğrulama](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/introduction/authentication.md) — API isteklerinizin kimliğini nasıl doğrulayacağınız
* [İstek Sınırları](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/introduction/rate-limits.md) — Her endpoint için varsayılan istek sınırları
* [Desteklenen Zincirler](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/introduction/supported-chains.md) — Zincirler ve bunların ID değerleri
* [Değişiklik Günlüğü](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/introduction/changelog.md) — Yakın tarihli API güncellemeleri
