Airisto Public REST API v1 — Geliştirici Portalı
Üniversite OBS sistemleri, dergi yönetim platformları ve kurumsal yazılımlarınız için yüksek performanslı RESTful doküman analizi servisi.
DOCX formatındaki akademik dokümanları gönderin; yapay zekâ oranını saptayın, asenkron Webhook bildirimleri alın ve resmi analiz PDF raporunu tek bir entegrasyonla indirin.
Asenkron mimari, anlık Webhook çağrıları ve REST standartlarında JSON yanıtlar.
# 1. Analiz Başlat (DOCX Gönder + Opsiyonel Webhook)
curl -X POST https://airisto.ai/api/v1/analyses \
-H "X-API-Key: air_live_your_secret_key_here" \
-F "file=@makale.docx" \
-F "title=Yapay Zeka ve Makale Tespiti" \
-F "webhookUrl=https://sisteminiz.com/api/webhook" \
-F "externalReferenceId=MAKALE_#4912"
# Yanıt (HTTP 202 Accepted):
# { "success": true, "data": { "jobId": "job_7f971b75546d4ffeb42ff62419a1848e", "status": "queued", "statusUrl": "https://airisto.ai/api/v1/analyses/job_7f971b75546d4ffeb42ff62419a1848e" } }
# -----------------------------------------------------------------
# Yöntem A: Anlık Webhook Bildirimi (Önerilen)
# Analiz bittiğinde Airisto webhookUrl adresinize anında POST ile veri gönderir:
# { "event": "analysis.completed", "jobId": "job_7f971b75...", "aiPercent": 62.02, "reportUrl": "..." }
# Yöntem B: Manuel Polling Sorgusu (Webhook yoksa)
curl -X GET https://airisto.ai/api/v1/analyses/job_7f971b75546d4ffeb42ff62419a1848e \
-H "X-API-Key: air_live_your_secret_key_here"
curl -X GET https://airisto.ai/api/v1/analyses/job_7f971b75546d4ffeb42ff62419a1848e/report \
-H "X-API-Key: air_live_your_secret_key_here" \
-o airisto_rapor.pdf{
"success": true,
"data": {
"jobId": "job_7f971b75546d4ffeb42ff62419a1848e",
"status": "completed",
"createdAt": "2026-08-26T12:00:00.000Z",
"completedAt": "2026-08-26T12:00:18.420Z",
"summary": {
"aiPercent": 62.02,
"humanPercent": 37.98,
"totalPages": 14,
"wordCount": 4280
},
"reportUrl": "https://airisto.ai/api/v1/analyses/job_7f971b75546d4ffeb42ff62419a1848e/report"
}
}Büyük boyutlu akademik tez ve makaleler kesintisiz kuyruk mimarisiyle işlenir.
Adım 1
DOCX (.docx) dosyanızı multipart/form-data ile gönderin. Sunucu anında HTTP 202 Accepted ile jobId ve sorgulama URL'ini döner.
Adım 2
Analiz tamamlandığında Airisto hedef webhookUrl adresinize anında HTTP POST bildirimi gönderir veya durum GET sorgusuyla takip edilir.
Adım 3
İşlem tamamlandığında benzerlik oranı (aiPercent) döner ve detaylı renkli işaretlemeler içeren resmi analiz PDF raporu doğrudan indirilir.
Kurumsal verileriniz uluslararası güvenlik standartlarıyla korunur.
Kurumunuza özel üretilen air_live_... gizli API anahtarı ile tüm çağrılar sunucunuz üzerinden (backend-to-backend) güvenle yapılır.
Dakikada 40 istek (RPM) limit ve kurum başına eşzamanlı 2 analiz kuyruğu. X-RateLimit-* HTTP başlıkları ile anlık kota takibi.
Analiz edilen metinler sunucularda kalıcı olarak depolanmaz, üçüncü taraflarla paylaşılmaz ve yapay zeka model eğitiminde asla kullanılmaz.
Canlı Swagger arayüzü üzerinden uç noktaları hemen test edin veya kurumsal entegrasyon ekibimizle iletişime geçin.