e-Devlet Barkodlu Belge Doğrulama Sistemi
Bu API, e-Devlet Kapısı üzerinden oluşturulan barkodlu belgeleri doğrulamak için kullanılır. Tüm endpoint'ler API Key ile korunmaktadır.
X-API-Key header'ı ile doğrulanır. API Key'inizi her istekte göndermelisiniz.
X-API-Key: your-api-key-here
curl -X POST https://api.example.com/api/verify \
-H "Content-Type: application/json" \
-H "X-API-Key: demo-api-key-12345" \
-d '{
"barcodeNumber": "UDH0325070902182717",
"tcNumber": "12345678901"
}'
{
"success": true,
"data": {
"barcodeNumber": "UDH0325070902182717",
"tcNumber": "123********",
"verificationStatus": "success",
"documentInfo": {
"Belge Türü": "Adli Sicil Kaydı",
"Belge Tarihi": "04.12.2025"
},
"hasDownloadButton": true,
"verifiedAt": "2025-12-04T14:30:00.000Z"
},
"timestamp": "2025-12-04T14:30:00.000Z"
}
{
"success": false,
"error": "Barkod numarası gerekli"
}
{
"success": false,
"error": "Unauthorized - Invalid API key"
}
{
"success": false,
"error": "Belge doğrulama hatası: TC Kimlik Numarası alanı bulunamadı"
}
curl -X GET https://api.example.com/api/history \ -H "X-API-Key: demo-api-key-12345"
{
"success": true,
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"barcode_number": "UDH0325070902182717",
"verification_status": "success",
"document_info": {
"Belge Türü": "Adli Sicil Kaydı"
},
"verified_at": "2025-12-04T14:30:00.000Z",
"ip_address": "192.168.1.1",
"created_at": "2025-12-04T14:30:00.000Z"
}
],
"timestamp": "2025-12-04T14:35:00.000Z"
}
curl -X GET https://api.example.com/health \ -H "X-API-Key: demo-api-key-12345"
{
"status": "ok",
"timestamp": "2025-12-04T14:30:00.000Z"
}
Sistem, aşağıdaki adımları otomatik olarak gerçekleştirir:
Tüm doğrulama kayıtları PostgreSQL veritabanında document_verifications tablosunda saklanır: