Advocotek API Hub
Haber izleme, yapay zeka, captcha ve spam skoru servislerimizi tek REST arayüzünden kullanın.
Servisler
Bir servise tıklayarak action'larını, parametrelerini ve örnek isteğini görün.
Aramayla eşleşen servis yok.
VKN/TCKN ya da firma adıyla basın ve kamu kaynaklarından haber taraması yapar, vergi levhası sorgular, konkordato listesini verir. İstekler kuyruğa alınır (create_queue), sonuç query_queue ile alınır; anlık tek firma taraması için haber_sorgula kullanılır.
Kimlik doğrulama
username + api_key (ya da password). Authorization: Bearer <api_key> başlığı da kabul edilir.
Action'lar ve parametreler
POST rest.php?service=news&action=create_queue
Kuyruğa bir ya da birden çok sorgu kaydı ekler. Yanıtta her kayıt için queue_id döner.
| Parametre | Açıklama | |
|---|---|---|
records | Zorunlu | JSON dizi; her eleman bir kayıt (request_type, adv_tax_no, adv_national_id, name ...) |
newer_than_datetime | Opsiyonel | UTC tarih filtresi. Veri bu tarihten yeniyse doğrudan döner, eskiyse yeniden kuyruğa girer |
mode | Opsiyonel | preview: scrap gerekmeden yanıtlanabilecek kayıtları belirler; correction: düzeltme akışı, kota tüketmez |
force | Opsiyonel | 0|1; günlük kota doluyken de kabul (yalnızca izinli müşteriler, ayrıca ücretlendirilir) |
POST rest.php?service=news&action=query_queue
Kuyruk durumunu sorgular; tamamlandıysa hesap ve ilişkili verileri döndürür.
| Parametre | Açıklama | |
|---|---|---|
queue_id | Zorunlu | create_queue yanıtındaki kayıt numarası |
POST rest.php?service=news&action=haber_sorgula
Tek firma için anlık haber taraması başlatır ve hemen döner. Sonuç query_queue ile alınır (tarama 1-2 dk sürebilir).
| Parametre | Açıklama | |
|---|---|---|
adv_tax_no | Opsiyonel | VKN (firma kimliği) |
name | Opsiyonel | VKN yoksa firma adı (il/ilçe ile birlikte) |
POST rest.php?service=news&action=vergilevhasi_query
Vergi levhası sorgusu başlatır.
| Parametre | Açıklama | |
|---|---|---|
vergi_no | Zorunlu | VKN ya da TCKN |
vergi_dairesi | Opsiyonel | Vergi dairesi |
POST rest.php?service=news&action=check_quota
İstek tipi için günlük (UTC) kota durumunu döndürür.
| Parametre | Açıklama | |
|---|---|---|
request_type | Zorunlu | Kotası sorgulanacak istek tipi |
POST rest.php?service=news&action=reprocess_queue
Mevcut kaydı kota tüketmeden yeniden değerlendirir.
| Parametre | Açıklama | |
|---|---|---|
queue_id | Zorunlu | Yeniden değerlendirilecek kayıt |
POST rest.php?service=news&action=inbox
“Benim için bir şey var mı?”: istemciye teslim edilecek kayıtları (hata, tamamlanan, kural, düzeltme) sunucu belirler.
| Parametre | Açıklama | |
|---|---|---|
request_type | Opsiyonel | Yalnızca bu tipteki kayıtlar |
POST rest.php?service=news&action=inbox_ack
inbox ile alınan kayıtların işlendiğini onaylar.
| Parametre | Açıklama | |
|---|---|---|
queue_ids | Zorunlu | Onaylanacak kayıt numaraları |
POST rest.php?service=news&action=returnCorrections
Düzeltme işaretli kayıtları 200'lük paketler halinde döndürür.
Parametre almaz.
POST rest.php?service=news&action=confirmReturnCorrections
İşlenen düzeltme kayıtlarını onaylar.
| Parametre | Açıklama | |
|---|---|---|
queue_ids | Zorunlu | Onaylanacak kayıt numaraları |
POST rest.php?service=news&action=konkordato_list
Konkordato listesinin tamamını döndürür.
Parametre almaz.
POST rest.php?service=news&action=haber_account_list
Haberi toplanmış firmaların kimlik listesi (yalnızca sizin sorguladığınız firmalar, TCKN maskeli).
Parametre almaz.
POST rest.php?service=news&action=haber_kaynak_gecersiz
“Yanlış firma/kişi eşleşmesi” bildirimi; haber kaynağını ya da tek haberi geçersiz yapar.
| Parametre | Açıklama | |
|---|---|---|
kaynak_kayit_id veya haber_id | Zorunlu | Geçersiz yapılacak kaynak ya da haber |
POST rest.php?service=news&action=haber_kaynak_onay
“Doğru müşteri” bildirimi; kaynağı onaylar, geçersizse geri açar.
| Parametre | Açıklama | |
|---|---|---|
kaynak_kayit_id veya haber_id | Zorunlu | Onaylanacak kaynak ya da haber |
Örnek istek
curl -X POST 'https://<API_ADRESI>/rest.php?service=news&action=haber_sorgula' \
-H 'Authorization: Bearer <api_key>' \
-d 'username=<kullanici>' -d 'adv_tax_no=1234567890'Örnek yanıt
{ "queue_id": 12345, "status": "queued" }API adresi ve anahtarınız sözleşme sonrası iletilir.
OpenAI chat/completions biçiminde istek alır ve aynı biçimde yanıt döner; mevcut OpenAI istemcileri yalnızca adresi değiştirerek çalışır. Model sunucularımızda çalışır, istek ve yanıt metni kaydedilmez.
Kimlik doğrulama
username + api_key. Authorization: Bearer <api_key> başlığı desteklenir.
Action'lar ve parametreler
POST rest.php?service=llm&action=chat_completions
Sohbet tamamlama. Yanıt başlıkları: X-Quota-Limit, X-Quota-Used, X-Quota-Remaining. Müşteri başına en çok 2 eşzamanlı istek.
| Parametre | Açıklama | |
|---|---|---|
messages | Zorunlu | {role: system|user|assistant, content} dizisi; en çok 50 eleman, toplam 60000 karakter |
model | Opsiyonel | Yalnızca yerel model kabul edilir |
max_tokens | Opsiyonel | 1-4096, varsayılan 1024 |
temperature | Opsiyonel | 0-2 |
top_p | Opsiyonel | 0-1 |
stop | Opsiyonel | string ya da en çok 4 string |
seed | Opsiyonel | Tamsayı |
response_format | Opsiyonel | {"type":"text"} ya da {"type":"json_object"} |
thinking | Opsiyonel | true|false (varsayılan false); true ise model düşünür, yanıt uzar |
tools, stream, n>1 | Opsiyonel | Desteklenmez (400 döner) |
POST rest.php?service=llm&action=check_quota
Bugünkü (UTC) istek kotası: limit, used, remaining, concurrent_limit.
Parametre almaz.
POST rest.php?service=llm&action=ping
Kimlik ve servis erişimini doğrular.
Parametre almaz.
Örnek istek
curl -X POST 'https://<API_ADRESI>/rest.php?service=llm&action=chat_completions' \
-H 'Content-Type: application/json' -H 'Authorization: Bearer <api_key>' \
-d '{"username":"<kullanici>","messages":[{"role":"user","content":"Merhaba"}],"max_tokens":256}'Örnek yanıt
{ "choices": [ { "message": { "role": "assistant", "content": "..." } } ], "usage": { ... } }API adresi ve anahtarınız sözleşme sonrası iletilir.
Captcha görselini önce yerel yapay zeka modeli çözer; sonuç boş ya da hatalıysa yedek servise geçilir. İşlem captcha'larında (11+4) hem işlem hem sonuç döner. Görsel saklanmaz.
Kimlik doğrulama
Yalnızca api_key (username + api_key ya da Bearer).
Action'lar ve parametreler
POST rest.php?service=captcha_resolution&action=solve
Görseli çözer. captcha_calculated sitenin kutusuna yazılacak değerdir.
| Parametre | Açıklama | |
|---|---|---|
image | Zorunlu | Base64 görsel (png/jpg/gif/webp, en çok 1 MB; data:image önekli olabilir) |
hint | Opsiyonel | math (işlem), text (harf/rakam) ya da auto (varsayılan) |
POST rest.php?service=captcha_resolution&action=report_failed
Çözüm site tarafından reddedildiyse bildirilir; aynı görsel yedek servisle yeniden çözülür. Kayıt başına bir kez.
| Parametre | Açıklama | |
|---|---|---|
id | Zorunlu | solve yanıtındaki id |
image | Zorunlu | Aynı görsel (base64) |
hint | Opsiyonel | math | text | auto |
POST rest.php?service=captcha_resolution&action=check_quota
Bugünkü (UTC) istek kotası.
Parametre almaz.
POST rest.php?service=captcha_resolution&action=ping
Kimlik ve servis erişimini doğrular.
Parametre almaz.
Örnek istek
curl -X POST 'https://<API_ADRESI>/rest.php?service=captcha_resolution&action=solve' \
-H 'Content-Type: application/json' -H 'Authorization: Bearer <api_key>' \
-d '{"username":"<kullanici>","image":"<base64>","hint":"auto"}'Örnek yanıt
{ "id": "...", "captcha_resolved": "11+4", "captcha_calculated": "15", "solver": "internal" }API adresi ve anahtarınız sözleşme sonrası iletilir.
E-posta içeriğini SpamAssassin ile skorlar; kural listesi ve eşik değeriyle döner. İsteğe bağlı olarak SPF, DKIM, DMARC, MX, PTR ve kara liste kontrolü yapar. İleti içeriği saklanmaz.
Kimlik doğrulama
Yalnızca api_key (username + api_key ya da Bearer).
Action'lar ve parametreler
POST rest.php?service=spam_score&action=check
İletiyi skorlar. Yanıt: is_spam, score, required, rules, deliverability (istenirse).
| Parametre | Açıklama | |
|---|---|---|
from_addr | Zorunlu | Gönderen e-posta adresi |
subject | Zorunlu | Konu |
body_html / body_text | Zorunlu | HTML ya da düz metin gövde (toplam en çok 1 MB) |
from_name, to_addr, reply_to_addr, reply_to_name | Opsiyonel | Ek başlık alanları |
sending_host / sending_ip | Opsiyonel | Gönderen sunucu; SPF eşleşmesi, PTR ve kara liste kontrolü için |
dkim_selector | Opsiyonel | DKIM selector adı (yoksa yaygın olanlar denenir) |
deliverability | Opsiyonel | 1 ise gönderen domain için SPF/DKIM/DMARC/MX kontrolü de yapılır |
raw_message_b64 / raw_message | Opsiyonel | Tam ham mail (.eml, en çok 2 MB); verilirse diğer alanlar gerekmez |
compat | Opsiyonel | 1 ise eski service.php yanıt biçimi |
POST rest.php?service=spam_score&action=check_quota
Bugünkü (UTC) istek kotası.
Parametre almaz.
POST rest.php?service=spam_score&action=ping
Kimlik ve servis erişimini doğrular.
Parametre almaz.
Örnek istek
curl -X POST 'https://<API_ADRESI>/rest.php?service=spam_score&action=check' \
-H 'Content-Type: application/json' -H 'Authorization: Bearer <api_key>' \
-d '{"username":"<kullanici>","from_addr":"[email protected]","subject":"Konu","body_html":"<p>Merhaba</p>"}'Örnek yanıt
{ "is_spam": false, "score": 1.2, "required": 5.0, "rules": [ ... ] }API adresi ve anahtarınız sözleşme sonrası iletilir.