KolayAnla API'sini sitenize entegre etmek için teknik rehber
İlk olarak kurumsal@kolayanla.com adresinden iletişime geçerek bir site oluşturun ve API anahtarınızı alın.
X-API-Key: site_xxxxxxxxxxxxxxxxxxxxxxxxFinansal haberinizi POST isteği ile gönderin:
POST https://kolayanla.com/api/kolayanla/interpret
Headers:
Content-Type: application/json
X-API-Key: site_xxxxxxxxxxxxxxxxxxxxxxxx
Body:
{
"title": "TCMB faiz kararı açıklandı",
"content": "Merkez Bankası politika faizini...",
"level": "beginner", // 'beginner' | 'normal' | 'advanced'
"newsId": "unique-id" // opsiyonel
}API basitleştirilmiş içeriği döndürür:
{
"interpretation": {
"title": "Basitleştirilmiş başlık",
"whatHappened": "Ne oldu? (2-3 cümle özet)",
"whyItMatters": "Sana ne? (kişisel finans etkisi)",
"whatToKnow": "Bilmen gerekenler (SPK-uyumlu)"
},
"cached": false,
"requestId": "req_xxxxxx"
}async function simplifyNews(title, content, level = 'normal') {
try {
const response = await fetch('https://kolayanla.com/api/kolayanla/interpret', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'site_xxxxxxxxxxxxxxxxxxxxxxxx'
},
body: JSON.stringify({
title,
content,
level,
newsId: generateNewsId() // kendi ID sisteminiz
})
});
if (!response.ok) {
throw new Error(`API error: ${response.status}`);
}
const data = await response.json();
// Basitleştirilmiş içeriği göster
displaySimplifiedNews(data.interpretation);
return data;
} catch (error) {
console.error('KolayAnla API hatası:', error);
throw error;
}
}
// Kullanım
simplifyNews(
'TCMB faiz kararı açıklandı',
'Merkez Bankası politika faizini %42,5 seviyesinde tuttu...',
'beginner'
);<?php
function simplifyNews($title, $content, $level = 'normal') {
$apiKey = 'site_xxxxxxxxxxxxxxxxxxxxxxxx';
$data = [
'title' => $title,
'content' => $content,
'level' => $level,
'newsId' => uniqid('news_')
];
$ch = curl_init('https://kolayanla.com/api/kolayanla/interpret');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'X-API-Key: ' . $apiKey
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode !== 200) {
throw new Exception("API error: $httpCode");
}
return json_decode($response, true);
}
// Kullanım
$result = simplifyNews(
'TCMB faiz kararı açıklandı',
'Merkez Bankası politika faizini...',
'beginner'
);
echo $result['interpretation']['title'];
?>import requests
import uuid
def simplify_news(title, content, level='normal'):
api_key = 'site_xxxxxxxxxxxxxxxxxxxxxxxx'
response = requests.post(
'https://kolayanla.com/api/kolayanla/interpret',
headers={
'Content-Type': 'application/json',
'X-API-Key': api_key
},
json={
'title': title,
'content': content,
'level': level,
'newsId': str(uuid.uuid4())
}
)
response.raise_for_status()
return response.json()
# Kullanım
result = simplify_news(
'TCMB faiz kararı açıklandı',
'Merkez Bankası politika faizini...',
'beginner'
)
print(result['interpretation']['title'])| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| title | string | Evet | Haberin orijinal başlığı |
| content | string | Evet | Haberin tam içeriği (min 100 karakter) |
| level | enum | Hayır | Basitleştirme seviyesi: 'beginner', 'normal', 'advanced' (varsayılan: normal) |
| newsId | string | Hayır | Benzersiz haber ID'si (cache için önerilir) |
| Alan | Tip | Açıklama |
|---|---|---|
| interpretation.title | string | Basitleştirilmiş başlık |
| interpretation.whatHappened | string | Ne oldu? (2-3 cümle özet) |
| interpretation.whyItMatters | string | Sana ne? (kişisel finans etkisi) |
| interpretation.whatToKnow | string | Bilmen gerekenler (SPK-uyumlu açıklama) |
| cached | boolean | Cache'ten mi döndü |
| requestId | string | İstek takip ID'si |
| Kod | Açıklama | Çözüm |
|---|---|---|
| 401 | Geçersiz veya eksik API anahtarı | X-API-Key header'ını kontrol edin |
| 403 | IP kısıtlaması | Beyaz listeye ekleyin veya destek alın |
| 429 | Rate limit aşıldı | İstekleri sınırlayın veya planınızı yükseltin |
| 400 | Geçersiz parametreler | title ve content zorunludur |
| 500 | Sunucu hatası | Tekrar deneyin veya destek alın |
Aynı haber için tekrar istek göndermek yerine newsId parametresi ile cache'ten yararlanın.
API isteklerinizi sınırlayın. Toplu işlemler için batch endpoint'i kullanın.
API hataları için fallback mekanizması oluşturun. Orijinal haberi göstermeye devam edin.
API çağrılarını asenkron yapın, kullanıcı deneyimini engellemeden basitleştirme sunun.
Teknik sorularınız için ekibimizle iletişime geçin. Entegrasyon desteği, özel ihtiyaçlar ve daha fazlası için hazırız.