code
API Dokumentácia
Symptio Platform REST API
info
Základné informácie
Symptio API umožňuje prístup k zdravotníckym AI modelom pre diagnostiku, analýzu symptómov a odporúčania.
Base URL:
Autentifikácia: API Key v headeri
https://api.symptio.com/v1Autentifikácia: API Key v headeri
Authorization: Bearer YOUR_API_KEY
API Endpointy
Získanie diagnostického hodnotenia na základe poskytnutých symptómov.
Endpoint URL
GET https://api.symptio.com/v1/diagnoza
Query parametre
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
| symptomy | string |
Áno | Zoznam symptómov oddelených čiarkou (napr. "horúčka,bolesť hlavy,únava") |
| vek | integer |
Nie | Vek pacienta v rokoch |
| pohlavie | string |
Nie | Pohlavie pacienta ("muz" alebo "zena") |
| model | string |
Nie | AI model pre diagnostiku (default: "diagnostic-ai-v2") |
Príklad requestu
curl -X GET "https://api.symptio.com/v1/diagnoza?symptomy=hor%C3%BA%C4%8Dka,boles%C5%A5%20hlavy&vek=35&pohlavie=muz" \ -H "Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc" \ -H "Content-Type: application/json"
Príklad odpovede
{
"success": true,
"data": {
"diagnoza": [
{
"nazov": "Chrípka",
"pravdepodobnost": 0.82,
"popis": "Vírusové ochorenie dýchacích ciest",
"odporucania": [
"Odpočinok a dostatok tekutín",
"Lieky na zníženie horúčky",
"Ak príznaky pretrvávajú viac ako 7 dní, navštívte lekára"
]
},
{
"nazov": "Prechladnutie",
"pravdepodobnost": 0.65,
"popis": "Miernejšia infekcia horných dýchacích ciest",
"odporucania": [
"Odpočinok",
"Teplé nápoje",
"Vitamín C"
]
}
],
"model": "diagnostic-ai-v2.4",
"confidence": 0.89,
"processing_time_ms": 234
}
}
Response polia
| Pole | Typ | Popis |
|---|---|---|
| success | boolean |
Indikátor úspešnosti requestu |
| data.diagnoza | array |
Zoznam možných diagnóz zoradených podľa pravdepodobnosti |
| data.diagnoza[].nazov | string |
Názov diagnózy |
| data.diagnoza[].pravdepodobnost | float |
Pravdepodobnosť diagnózy (0-1) |
| data.model | string |
Použitý AI model |
| data.confidence | float |
Celková spoľahlivosť výsledku |
HTTP Status kódy
200
OK
Request bol úspešne spracovaný
400
Bad Request
Chýbajúce alebo nevalidné parametre
401
Unauthorized
Neplatný alebo chýbajúci API kľúč
429
Too Many Requests
Prekročený rate limit
Získanie zoznamu všetkých dostupných AI modelov pre diagnostiku a analýzu.
Endpoint URL
GET https://api.symptio.com/v1/modely
Query parametre
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
| kategoria | string |
Nie | Filtrovať modely podľa kategórie ("diagnostika", "symptomy", "odporucania") |
| status | string |
Nie | Filtrovať podľa statusu ("active", "deprecated") |
Príklad requestu
curl -X GET "https://api.symptio.com/v1/modely?kategoria=diagnostika&status=active" \ -H "Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc" \ -H "Content-Type: application/json"
Príklad odpovede
{
"success": true,
"data": {
"modely": [
{
"id": "diagnostic-ai-v2.4",
"nazov": "Diagnostický AI v2.4",
"kategoria": "diagnostika",
"status": "active",
"presnost": 0.94,
"popis": "Pokročilý model pre diagnostiku chorôb",
"verzia": "2.4.0",
"datum_vydania": "2025-01-15"
},
{
"id": "symptom-analyzer-v1.8",
"nazov": "Analyzátor symptómov v1.8",
"kategoria": "symptomy",
"status": "active",
"presnost": 0.91,
"popis": "Analýza a kategorizácia symptómov",
"verzia": "1.8.2",
"datum_vydania": "2025-01-10"
}
],
"celkovy_pocet": 5,
"processing_time_ms": 42
}
}
Response polia
| Pole | Typ | Popis |
|---|---|---|
| success | boolean |
Indikátor úspešnosti requestu |
| data.modely | array |
Zoznam dostupných AI modelov |
| data.modely[].id | string |
Unikátny identifikátor modelu |
| data.modely[].presnost | float |
Presnosť modelu (0-1) |
| data.celkovy_pocet | integer |
Celkový počet aktívnych modelov |
HTTP Status kódy
200
OK
Request bol úspešne spracovaný
401
Unauthorized
Neplatný alebo chýbajúci API kľúč
Získanie detailného zdravotného záznamu pacienta vrátane histórie diagnóz a odporúčaní.
Endpoint URL
GET https://api.symptio.com/v1/zdravotny-zaznam/{pacient_id}
Path parametre
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
| pacient_id | string |
Áno | Unikátny identifikátor pacienta |
Query parametre
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
| od_datumu | string |
Nie | Filtrovať záznamy od dátumu (formát: YYYY-MM-DD) |
| do_datumu | string |
Nie | Filtrovať záznamy do dátumu (formát: YYYY-MM-DD) |
| limit | integer |
Nie | Maximálny počet záznamov (default: 50) |
Príklad requestu
curl -X GET "https://api.symptio.com/v1/zdravotny-zaznam/pac_1a2b3c4d?od_datumu=2025-01-01&limit=10" \ -H "Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc" \ -H "Content-Type: application/json"
Príklad odpovede
{
"success": true,
"data": {
"pacient_id": "pac_1a2b3c4d",
"meno": "Ján Novák",
"vek": 35,
"pohlavie": "muz",
"zaznamy": [
{
"datum": "2025-01-15",
"typ": "diagnoza",
"symptomy": ["horúčka", "bolesť hlavy", "únava"],
"diagnoza": "Chrípka",
"pravdepodobnost": 0.82,
"model": "diagnostic-ai-v2.4",
"odporucania": [
"Odpočinok a dostatok tekutín",
"Lieky na zníženie horúčky"
],
"lekar": "Dr. Mária Kováčová"
},
{
"datum": "2025-01-10",
"typ": "kontrola",
"poznamka": "Kontrolné vyšetrenie - stav stabilný",
"lekar": "Dr. Peter Slovenský"
}
],
"celkovy_pocet_zaznamov": 24,
"processing_time_ms": 156
}
}
Response polia
| Pole | Typ | Popis |
|---|---|---|
| success | boolean |
Indikátor úspešnosti requestu |
| data.pacient_id | string |
Unikátny identifikátor pacienta |
| data.zaznamy | array |
Zoznam zdravotných záznamov pacienta |
| data.zaznamy[].datum | string |
Dátum záznamu |
| data.zaznamy[].typ | string |
Typ záznamu (diagnoza, kontrola, etc.) |
| data.celkovy_pocet_zaznamov | integer |
Celkový počet záznamov pacienta |
HTTP Status kódy
200
OK
Request bol úspešne spracovaný
401
Unauthorized
Neplatný alebo chýbajúci API kľúč
404
Not Found
Pacient s daným ID nebol nájdený
403
Forbidden
Nemáte oprávnenie na prístup k tomuto záznamu
Ako začať
-
Získajte API kľúč
Zaregistrujte sa na symptio.com a vygenerujte si API kľúč v sekcii "Nastavenia" -
Nastavte autentifikáciu
Pridajte headerAuthorization: Bearer YOUR_API_KEYdo všetkých requestov -
Vykonajte svoj prvý request
Použite príklad requestu vyššie a nahraďte API kľúč svojim vlastným -
Spracujte odpoveď
Parsujte JSON odpoveď a zobrazte výsledky vo svojej aplikácii