# Kimlik API

> Kimlik API (eski adıyla tcdogrula.com), Türkiye'deki şirketlerin TC kimlik doğrulama işini devraldığı bir hizmettir. Yazılımınız TC kimlik no, ad, soyad ve doğum tarihini tek bir API isteğiyle gönderir; doğrulama ekibimiz talebi sizin adınıza doğrular ve sonucu imzalı webhook ile sisteminize iletir. Ekip ayırmadan, manuel kontrol yükü olmadan kimlik doğrulamayı ürününüze eklersiniz. Antandros Teknoloji A.Ş. ürünüdür; KPS başvuru danışmanlığı da sunar. Resmî KPS/NVİ API'si değildir.

## Nasıl entegre edilir

- `POST /v1/verify` ile talebi gönderin (`mode: async`); yanıt anında `202` ve `request_id` döner.
- Sonuç hazır olunca webhook ile gelir (uygulama secret'ı ile HMAC-SHA256 imzalı). Webhook kullanamıyorsanız `GET /v1/requests/{request_id}` ile sorgulayın.
- Çoğu talep birkaç dakika içinde sonuçlanır. Doğrulamayı kayıt akışının önüne koymayın: kullanıcıyı içeri alın, yalnızca doğrulanmış kimlik gerektiren adımları sonuç gelene kadar bekletin.
- Kredi yalnızca eşleşme veya eşleşmeme sonucu üreten sorgularda düşer. Sandbox ücretsiz ve sınırsızdır.

## Docs

- [Overview](https://kimlikapi.com/docs/introduction)
- [Quickstart](https://kimlikapi.com/docs/quickstart)
- [Sandbox](https://kimlikapi.com/docs/sandbox)
- [Integration guide](https://kimlikapi.com/docs/integration-guide)
- [Verify](https://kimlikapi.com/docs/verify)
- [Polling](https://kimlikapi.com/docs/polling)
- [Webhooks](https://kimlikapi.com/docs/webhooks)
- [Data retention](https://kimlikapi.com/docs/data-retention)
- [Errors](https://kimlikapi.com/docs/errors)
- [AI + MCP](https://kimlikapi.com/docs/ai)
- [OpenAPI](https://kimlikapi.com/openapi.yaml)
- [Full text for LLMs](https://kimlikapi.com/llms-full.txt)

## MCP

- Docs-only MCP endpoint: https://kimlikapi.com/mcp (documentation tools only; does not run live verifications)