API Integracija

Programatski šaljite podatke u vašu AI SmartTalk bazu znanja koristeći naš REST API. Idealno za prilagođene integracije, automatizovane tokove podataka i bilo koji izvor podataka koji nije pokriven našim nativnim konektorima.

---

Pregled

API integracija vam omogućava da:

• Šaljete dokumente direktno u vašu bazu znanja
• Ažurirate sadržaj programatski
• Brišete zastarele unose
• Kreirate prilagođene tokove podataka
• Integrirate se sa bilo kojim sistemom koji može slati HTTP zahteve

---

Preduslovi

Pre nego što počnete, obavezno imate:

• Aktivni AI SmartTalk nalog
• Omogućen API pristup (proverite svoj plan)
• Osnovno znanje o REST API-ima
• Alat za slanje HTTP zahteva (curl, Postman, ili vaš aplikacioni kod)

---

Dobijanje vaših API kredencijala

Korak 1: Pristupite API podešavanjima

1. Prijavite se na svoj AI SmartTalk nalog
2. Idite na Podešavanja → Integracije
3. Pronađite API i kliknite na Konfiguriši

Korak 2: Generišite API Token

1. Kliknite na Generiši novi token
2. Kopirajte svoj ID modela za chat i API token
3. Čuvajte ih na sigurnom—token se prikazuje samo jednom!

⚠️ Upozorenje o bezbednosti: Nikada ne izlažite svoj API token u kodu na klijentskoj strani ili javnim repozitorijumima.

---

API Endpoints

Osnovni URL

https://api.aismarttalk.tech/v1

Autentifikacija

Svi zahtevi zahtevaju vaš API token u zaglavlju:

Authorization: Bearer YOUR_API_TOKEN

---

API Endpoints

Base URL

https://api.aismarttalk.tech/v1

Authentication

Sve zahteve zahtevaju vaš API token u zaglavlju:

Authorization: Bearer YOUR_API_TOKEN

---

Uvoz Dokumenata

Endpoint

POST /documents/import

Telo Zahteva

{
  "chatModelId": "your-chat-model-id",
  "documents": [
    {
      "title": "Dokumentacija o Proizvodu",
      "content": "Puni sadržaj vašeg dokumenta ide ovde...",
      "url": "https://example.com/docs/product",
      "metadata": {
        "category": "documentation",
        "language": "en"
      }
    }
  ]
}

Parametri

Polje	Tip	Obavezno	Opis
chatModelId	string	✅	Vaš jedinstveni identifikator chat modela
documents	array	✅	Niz objekata dokumenata
documents[].title	string	✅	Naslov dokumenta za identifikaciju
documents[].content	string	✅	Puni tekst sadržaja
documents[].url	string	❌	Izvorni URL (za referencu)
documents[].metadata	object	❌	Prilagođeni parovi ključ-vrednost

Odgovor

{
  "success": true,
  "imported": 1,
  "documents": [
    {
      "id": "doc_abc123",
      "title": "Dokumentacija o Proizvodu",
      "status": "processing"
    }
  ]
}

Primer: cURL

curl -X POST https://api.aismarttalk.tech/v1/documents/import \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "chatModelId": "your-chat-model-id",
    "documents": [
      {
        "title": "Vodič za Početnike",
        "content": "Dobrodošli na našu platformu. Evo kako da počnete...",
        "url": "https://docs.example.com/getting-started"
      }
    ]
  }'

---

Upit za Dokumente

Postavljajte pitanja vašoj bazi znanja programatski.

Endpoint

POST /chat/query

Telo Zahteva

{
  "chatModelId": "your-chat-model-id",
  "query": "Kako da resetujem svoju lozinku?",
  "options": {
    "maxTokens": 500,
    "temperature": 0.7
  }
}

Odgovor

{
  "success": true,
  "response": "Da biste resetovali svoju lozinku, idite na Podešavanja > Bezbednost > Promena lozinke...",
  "sources": [
    {
      "documentId": "doc_abc123",
      "title": "Vodič za Bezbednost",
      "relevance": 0.95
    }
  ]
}

---

Preuzimanje Dokumenata

Dobijte dokumente koji odgovaraju upitu (bez AI odgovora).

Endpoint

POST /documents/search

Telo Zahteva

{
  "chatModelId": "your-chat-model-id",
  "query": "bezbednost lozinke",
  "limit": 10
}

Odgovor

{
  "success": true,
  "documents": [
    {
      "id": "doc_abc123",
      "title": "Najbolje Prakse u Bezbednosti",
      "content": "...",
      "relevance": 0.92
    }
  ]
}

---

Primeri Koda

Python

import requests

API_TOKEN = "your-api-token"
CHAT_MODEL_ID = "your-chat-model-id"

def import_document(title: str, content: str, url: str = None):
    response = requests.post(
        "https://api.aismarttalk.tech/v1/documents/import",
        headers={
            "Authorization": f"Bearer {API_TOKEN}",
            "Content-Type": "application/json"
        },
        json={
            "chatModelId": CHAT_MODEL_ID,
            "documents": [{
                "title": title,
                "content": content,
                "url": url
            }]
        }
    )
    return response.json()

# Uvezi dokument
result = import_document(
    title="FAQ: Dostava",
    content="Nudimo besplatnu dostavu za narudžbine preko $50...",
    url="https://shop.example.com/faq/shipping"
)
print(result)

JavaScript / Node.js

const API_TOKEN = 'your-api-token';
const CHAT_MODEL_ID = 'your-chat-model-id';

async function importDocument(title, content, url = null) {
  const response = await fetch('https://api.aismarttalk.tech/v1/documents/import', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      chatModelId: CHAT_MODEL_ID,
      documents: [{
        title,
        content,
        url
      }]
    })
  });
  return response.json();
}

// Uvezi dokument
importDocument(
  'FAQ: Vraćanje',
  'Možete vratiti artikle u roku od 30 dana od kupovine...',
  'https://shop.example.com/faq/returns'
).then(console.log);

PHP

<?php
$apiToken = 'your-api-token';
$chatModelId = 'your-chat-model-id';

$data = [
    'chatModelId' => $chatModelId,
    'documents' => [
        [
            'title' => 'Specifikacije proizvoda',
            'content' => 'Naš uređaj ima sledeće specifikacije...',
            'url' => 'https://example.com/products/widget'
        ]
    ]
];

$ch = curl_init('https://api.aismarttalk.tech/v1/documents/import');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiToken,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));

---

Upotrebe

Integracija prilagođenog CMS-a

Sinhronizujte sadržaj iz vlasničkog CMS-a:

• Povezivanje sa događajima objavljivanja u CMS-u
• Slanje novog/izmenjenog sadržaja na AI SmartTalk
• Uklanjanje obrisanog sadržaja

Podatkovni tok

Uvoz iz skladišta podataka:

• Izvoz relevantnih podataka u JSON
• Uvoz u serijama putem API-ja
• Planiranje redovnih ažuriranja

E-trgovinski proizvodi

Sinhronizujte podatke o proizvodima iz prilagođenih sistema:

• Opisi proizvoda
• Specifikacije
• Informacije o cenama

Interni sistemi

Povezivanje internih alata koji nisu podržani nativno:

• Prilagođeni viki
• Nasleđene baze podataka
• Vlasničke aplikacije

---

Ograničenja brzine

Endpoint	Ograničenje brzine
Uvoz dokumenata	100 zahteva/minut
Upit	60 zahteva/minut
Pretraga	60 zahteva/minut

Napomena: Ograničenja brzine se razlikuju u zavisnosti od plana. Kontaktirajte podršku za veća ograničenja.

---

Obrada grešaka

Format odgovora na grešku

{
  "success": false,
  "error": {
    "code": "INVALID_TOKEN",
    "message": "The provided API token is invalid or expired"
  }
}

Uobičajeni kodovi grešaka

Kod	Opis	Rešenje
INVALID_TOKEN	Neispravan ili istekao token	Ponovno generišite API token
INVALID_MODEL_ID	Nepoznat ID modela za chat	Proverite svoj ID modela za chat
RATE_LIMITED	Previše zahteva	Implementirajte backoff, pokušajte kasnije
INVALID_REQUEST	Neispravan telo zahteva	Proverite strukturu JSON-a
DOCUMENT_TOO_LARGE	Sadržaj premašuje limit	Podelite na manje dokumente
QUOTA_EXCEEDED	Dostignuta ograničenja plana	Nadogradite ili kontaktirajte podršku

---

Rešavanje problema

Neuspešna autentifikacija

Problem	Rešenje
401 Unauthorized	Proverite da li je token ispravan i aktivan
Token ne radi	Ponovno generišite token u podešavanjima
Istekao token	Tokeni ne isteknu, ali mogu biti opozvani

Problemi sa uvozom

Problem	Rešenje
Prazan odgovor	Proverite da li je Content-Type application/json
Dokument se ne pojavljuje	Sačekajte obradu; proverite deo o znanju
Delimični uvoz	Neki dokumenti mogu imati greške u validaciji

Problemi sa performansama

Problem	Rešenje
Spori uvozi	Grupisanje dokumenata (maksimalno 100 po zahtevu)
Timeout	Smanjite veličinu grupe, pokušajte ponovo sa backoff-om
Ograničenje brzine	Implementirajte eksponencijalni backoff

---

Najbolje prakse

1. Grupni uvozi: Pošaljite više dokumenata po zahtevu (do 100)
2. Jedinstveni naslovi: Koristite opisne, jedinstvene naslove za svaki dokument
3. Strukturirani sadržaj: Dobro formatiran sadržaj poboljšava odgovore AI-a
4. Tagovanje metapodataka: Koristite metapodatke za kategorizaciju i filtriranje
5. Sigurni tokeni: Čuvajte tokene u promenljivim okruženja
6. Obrada grešaka: Implementirajte logiku ponovnog pokušaja sa eksponencijalnim backoff-om
7. Praćenje korišćenja: Pratite API pozive u odnosu na ograničenja vašeg plana

---

Povezana dokumentacija

• Pregled integracija
• Potpuna API dokumentacija
• Upravljanje bazom znanja
• SmartFlow Webhooks — Primajte događaje