Advocotek API Hub
Xəbər izləmə, süni intellekt, captcha və spam skoru servislərimizdən vahid REST interfeysi ilə istifadə edin.
Servislər
Servisə klikləyərək action-larını, parametrlərini və nümunə sorğusunu görün.
Axtarışa uyğun servis yoxdur.
VÖEN/şəxsiyyət nömrəsi və ya şirkət adı ilə mətbuat və açıq mənbələrdən xəbər taraması edir, vergi sənədini sorğulayır, konkordato siyahısını təqdim edir. Sorğular növbəyə alınır (create_queue), nəticə query_queue ilə götürülür; haber_sorgula ani tək şirkət taraması başladır.
Kimlik doğrulama
username + api_key (və ya password). Authorization: Bearer <api_key> başlığı da qəbul olunur.
Action-lar və parametrlər
POST rest.php?service=news&action=create_queue
Növbəyə bir və ya bir neçə sorğu qeydi əlavə edir. Hər qeyd üçün queue_id qaytarılır.
| Parametr | Açıqlama | |
|---|---|---|
records | Məcburi | JSON massiv; hər element bir qeyd (request_type, adv_tax_no, adv_national_id, name ...) |
newer_than_datetime | İxtiyari | UTC tarix filtri. Məlumat bu tarixdən təzədirsə birbaşa qayıdır, köhnədirsə yenidən növbəyə düşür |
mode | İxtiyari | preview: tarama tələb etmədən cavablanan qeydləri müəyyən edir; correction: düzəliş axını, kvota işlətmir |
force | İxtiyari | 0|1; gündəlik kvota dolu olduqda da qəbul (yalnız icazəli müştərilər, ayrıca qiymətləndirilir) |
POST rest.php?service=news&action=query_queue
Növbə vəziyyətini sorğulayır; tamamlandıqda hesab və əlaqəli məlumatları qaytarır.
| Parametr | Açıqlama | |
|---|---|---|
queue_id | Məcburi | create_queue cavabındakı qeyd nömrəsi |
POST rest.php?service=news&action=haber_sorgula
Tək şirkət üçün ani xəbər taraması başladır və dərhal cavab verir. Nəticə query_queue ilə alınır (tarama 1-2 dəq çəkə bilər).
| Parametr | Açıqlama | |
|---|---|---|
adv_tax_no | İxtiyari | VÖEN (şirkət kimliyi) |
name | İxtiyari | VÖEN yoxdursa şirkət adı (şəhər/rayon ilə) |
POST rest.php?service=news&action=vergilevhasi_query
Vergi sənədi sorğusu başladır.
| Parametr | Açıqlama | |
|---|---|---|
vergi_no | Məcburi | VÖEN və ya şəxsiyyət nömrəsi |
vergi_dairesi | İxtiyari | Vergi idarəsi |
POST rest.php?service=news&action=check_quota
Sorğu tipi üçün bugünkü (UTC) kvota vəziyyətini qaytarır.
| Parametr | Açıqlama | |
|---|---|---|
request_type | Məcburi | Sorğu tipi |
POST rest.php?service=news&action=reprocess_queue
Mövcud qeydi kvota işlətmədən yenidən qiymətləndirir.
| Parametr | Açıqlama | |
|---|---|---|
queue_id | Məcburi | create_queue cavabındakı qeyd nömrəsi |
POST rest.php?service=news&action=inbox
“Mənim üçün nəsə var?”: müştəriyə təhvil veriləcək qeydləri (xəta, tamamlanan, qayda, düzəliş) server müəyyən edir.
| Parametr | Açıqlama | |
|---|---|---|
request_type | İxtiyari | Sorğu tipi |
POST rest.php?service=news&action=inbox_ack
inbox ilə alınan qeydlərin işləndiyini təsdiqləyir.
| Parametr | Açıqlama | |
|---|---|---|
queue_ids | Məcburi | Təsdiqlənəcək qeyd nömrələri |
POST rest.php?service=news&action=returnCorrections
Düzəliş işarəli qeydləri 200-lük paketlərlə qaytarır.
Parametr qəbul etmir.
POST rest.php?service=news&action=confirmReturnCorrections
İşlənmiş düzəliş qeydlərini təsdiqləyir.
| Parametr | Açıqlama | |
|---|---|---|
queue_ids | Məcburi | Təsdiqlənəcək qeyd nömrələri |
POST rest.php?service=news&action=konkordato_list
Konkordato siyahısının hamısını qaytarır.
Parametr qəbul etmir.
POST rest.php?service=news&action=haber_account_list
Xəbəri toplanmış şirkətlərin kimlik siyahısı (yalnız sizin sorğuladığınız şirkətlər, şəxsiyyət nömrəsi maskalı).
Parametr qəbul etmir.
POST rest.php?service=news&action=haber_kaynak_gecersiz
“Yanlış şirkət/şəxs uyğunluğu” bildirişi; xəbər mənbəyini və ya tək xəbəri etibarsız edir.
| Parametr | Açıqlama | |
|---|---|---|
kaynak_kayit_id veya haber_id | Məcburi | İşlənəcək mənbə və ya xəbər |
POST rest.php?service=news&action=haber_kaynak_onay
“Düzgün müştəri” bildirişi; mənbəni təsdiqləyir, etibarsızdırsa yenidən açır.
| Parametr | Açıqlama | |
|---|---|---|
kaynak_kayit_id veya haber_id | Məcburi | İşlənəcək mənbə və ya xəbər |
Nümunə sorğu
curl -X POST 'https://<API_UNVANI>/rest.php?service=news&action=haber_sorgula' \
-H 'Authorization: Bearer <api_key>' \
-d 'username=<istifadeci>' -d 'adv_tax_no=1234567890'Nümunə cavab
{ "queue_id": 12345, "status": "queued" }API ünvanı və açarınız müqavilədən sonra təqdim olunur.
OpenAI chat/completions formatında sorğu qəbul edir və eyni formatda cavab verir; mövcud OpenAI müştəriləri yalnız ünvanı dəyişməklə işləyir. Model serverlərimizdə işləyir, sorğu və cavab mətni saxlanmır.
Kimlik doğrulama
username + api_key. Authorization: Bearer <api_key> başlığı dəstəklənir.
Action-lar və parametrlər
POST rest.php?service=llm&action=chat_completions
Söhbət tamamlama. Cavab başlıqları: X-Quota-Limit, X-Quota-Used, X-Quota-Remaining. Müştəri başına ən çox 2 eyni vaxtlı sorğu.
| Parametr | Açıqlama | |
|---|---|---|
messages | Məcburi | {role: system|user|assistant, content} massivi; ən çox 50 element, cəmi 60000 simvol |
model | İxtiyari | Yalnız yerli model qəbul edilir |
max_tokens | İxtiyari | 1-4096, susmaya görə 1024 |
temperature | İxtiyari | 0-2 |
top_p | İxtiyari | 0-1 |
stop | İxtiyari | string və ya ən çox 4 string |
seed | İxtiyari | Tam ədəd |
response_format | İxtiyari | {"type":"text"} və ya {"type":"json_object"} |
thinking | İxtiyari | true|false (susmaya görə false); true olarsa model düşünür, cavab uzanır |
tools, stream, n>1 | İxtiyari | Dəstəklənmir (400 qaytarır) |
POST rest.php?service=llm&action=check_quota
Bugünkü (UTC) sorğu kvotası: limit, used, remaining, concurrent_limit.
Parametr qəbul etmir.
POST rest.php?service=llm&action=ping
Kimlik və servis girişini yoxlayır.
Parametr qəbul etmir.
Nümunə sorğu
curl -X POST 'https://<API_UNVANI>/rest.php?service=llm&action=chat_completions' \
-H 'Content-Type: application/json' -H 'Authorization: Bearer <api_key>' \
-d '{"username":"<istifadeci>","messages":[{"role":"user","content":"Salam"}],"max_tokens":256}'Nümunə cavab
{ "choices": [ { "message": { "role": "assistant", "content": "..." } } ], "usage": { ... } }API ünvanı və açarınız müqavilədən sonra təqdim olunur.
Captcha şəklini əvvəl yerli süni intellekt modeli həll edir; nəticə boş və ya səhvdirsə ehtiyat servisə keçilir. Əməliyyat captcha-larında (11+4) həm əməliyyat, həm nəticə qaytarılır. Şəkil saxlanmır.
Kimlik doğrulama
Yalnız api_key (username + api_key və ya Bearer).
Action-lar və parametrlər
POST rest.php?service=captcha_resolution&action=solve
Şəkli həll edir. captcha_calculated saytın xanasına yazılacaq dəyərdir.
| Parametr | Açıqlama | |
|---|---|---|
image | Məcburi | Base64 şəkil (png/jpg/gif/webp, ən çox 1 MB; data:image prefiksi ola bilər) |
hint | İxtiyari | math, text və ya auto (susmaya görə) |
POST rest.php?service=captcha_resolution&action=report_failed
Həll sayt tərəfindən rədd edilibsə bildirilir; eyni şəkil ehtiyat servislə yenidən həll olunur. Qeyd başına bir dəfə.
| Parametr | Açıqlama | |
|---|---|---|
id | Məcburi | solve cavabındakı id |
image | Məcburi | Base64 şəkil (png/jpg/gif/webp, ən çox 1 MB; data:image prefiksi ola bilər) |
hint | İxtiyari | math, text və ya auto (susmaya görə) |
POST rest.php?service=captcha_resolution&action=check_quota
Bugünkü (UTC) sorğu kvotası.
Parametr qəbul etmir.
POST rest.php?service=captcha_resolution&action=ping
Kimlik və servis girişini yoxlayır.
Parametr qəbul etmir.
Nümunə sorğu
curl -X POST 'https://<API_UNVANI>/rest.php?service=captcha_resolution&action=solve' \
-H 'Content-Type: application/json' -H 'Authorization: Bearer <api_key>' \
-d '{"username":"<istifadeci>","image":"<base64>","hint":"auto"}'Nümunə cavab
{ "id": "...", "captcha_resolved": "11+4", "captcha_calculated": "15", "solver": "internal" }API ünvanı və açarınız müqavilədən sonra təqdim olunur.
E-poçt məzmununu SpamAssassin ilə qiymətləndirir; qaydalar siyahısı və hədd dəyəri ilə qayıdır. İstəyə görə SPF, DKIM, DMARC, MX, PTR və qara siyahı yoxlaması edir. Mesaj məzmunu saxlanmır.
Kimlik doğrulama
Yalnız api_key (username + api_key və ya Bearer).
Action-lar və parametrlər
POST rest.php?service=spam_score&action=check
Mesajı qiymətləndirir. Cavab: is_spam, score, required, rules, deliverability (istənərsə).
| Parametr | Açıqlama | |
|---|---|---|
from_addr | Məcburi | Göndərənin e-poçt ünvanı |
subject | Məcburi | Mövzu |
body_html / body_text | Məcburi | HTML və ya düz mətn gövdə (cəmi ən çox 1 MB) |
from_name, to_addr, reply_to_addr, reply_to_name | İxtiyari | Əlavə başlıq sahələri |
sending_host / sending_ip | İxtiyari | Göndərən server; SPF uyğunluğu, PTR və qara siyahı yoxlaması üçün |
dkim_selector | İxtiyari | DKIM selector adı (yoxdursa geniş yayılmışlar yoxlanılır) |
deliverability | İxtiyari | 1 olarsa göndərən domen üçün SPF/DKIM/DMARC/MX yoxlaması da aparılır |
raw_message_b64 / raw_message | İxtiyari | Tam xam məktub (.eml, ən çox 2 MB); verilərsə digər sahələr tələb olunmur |
compat | İxtiyari | 1 olarsa köhnə service.php cavab formatı |
POST rest.php?service=spam_score&action=check_quota
Bugünkü (UTC) sorğu kvotası.
Parametr qəbul etmir.
POST rest.php?service=spam_score&action=ping
Kimlik və servis girişini yoxlayır.
Parametr qəbul etmir.
Nümunə sorğu
curl -X POST 'https://<API_UNVANI>/rest.php?service=spam_score&action=check' \
-H 'Content-Type: application/json' -H 'Authorization: Bearer <api_key>' \
-d '{"username":"<istifadeci>","from_addr":"[email protected]","subject":"Movzu","body_html":"<p>Salam</p>"}'Nümunə cavab
{ "is_spam": false, "score": 1.2, "required": 5.0, "rules": [ ... ] }API ünvanı və açarınız müqavilədən sonra təqdim olunur.