API Integration

Push data programmatisk til din AI SmartTalk vidensbase ved hjælp af vores REST API. Ideel til brugerdefinerede integrationer, automatiserede pipelines og enhver datakilde, der ikke dækkes af vores native connectorer.

---

Oversigt

API-integrationen gør det muligt for dig at:

• Push dokumenter direkte til din vidensbase
• Opdatere indhold programmatisk
• Slette forældede poster
• Bygge brugerdefinerede datapipelines
• Integrere med ethvert system, der kan lave HTTP-anmodninger

---

Forudsætninger

Før du begynder, skal du sikre dig, at du har:

• En aktiv AI SmartTalk-konto
• API-adgang aktiveret (tjek din plan)
• Grundlæggende viden om REST APIs
• Et værktøj til at lave HTTP-anmodninger (curl, Postman eller din applikationskode)

---

Få Dine API-legitimationsoplysninger

Trin 1: Adgang til API-indstillinger

1. Log ind på din AI SmartTalk-konto
2. Naviger til Indstillinger → Integrationer
3. Find API og klik på Konfigurer

Trin 2: Generer API-token

1. Klik på Generer nyt token
2. Kopiér dit Chat Model ID og API-token
3. Opbevar disse sikkert—tokenet vises kun én gang!

⚠️ Sikkerhedsadvarsel: Udsæt aldrig dit API-token i klient-side kode eller offentlige repositories.

---

API Endpoints

Base URL

https://api.aismarttalk.tech/v1

Autentificering

Alle anmodninger kræver dit API-token i headeren:

Authorization: Bearer YOUR_API_TOKEN

---

API Endpoints

Base URL

https://api.aismarttalk.tech/v1

Authentication

Alle anmodninger kræver din API-token i headeren:

Authorization: Bearer YOUR_API_TOKEN

---

Import Documents

Endpoint

POST /documents/import

Request Body

{
  "chatModelId": "your-chat-model-id",
  "documents": [
    {
      "title": "Produktdokumentation",
      "content": "Det fulde indhold af dit dokument går her...",
      "url": "https://example.com/docs/product",
      "metadata": {
        "category": "dokumentation",
        "language": "en"
      }
    }
  ]
}

Parameters

Field	Type	Required	Description
chatModelId	string	✅	Dit unikke chatmodel-identifikator
documents	array	✅	Array af dokumentobjekter
documents[].title	string	✅	Dokumenttitel til identifikation
documents[].content	string	✅	Fuld tekstindhold
documents[].url	string	❌	Kilde-URL (til reference)
documents[].metadata	object	❌	Tilpassede nøgle-værdi-par

Response

{
  "success": true,
  "imported": 1,
  "documents": [
    {
      "id": "doc_abc123",
      "title": "Produktdokumentation",
      "status": "behandler"
    }
  ]
}

Example: 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": "Kom godt i gang guide",
        "content": "Velkommen til vores platform. Her er hvordan du kommer i gang...",
        "url": "https://docs.example.com/getting-started"
      }
    ]
  }'

---

Query Documents

Stil spørgsmål til din vidensbase programmatisk.

Endpoint

POST /chat/query

Request Body

{
  "chatModelId": "your-chat-model-id",
  "query": "Hvordan nulstiller jeg min adgangskode?",
  "options": {
    "maxTokens": 500,
    "temperature": 0.7
  }
}

Response

{
  "success": true,
  "response": "For at nulstille din adgangskode, gå til Indstillinger > Sikkerhed > Skift adgangskode...",
  "sources": [
    {
      "documentId": "doc_abc123",
      "title": "Sikkerhedsguide",
      "relevance": 0.95
    }
  ]
}

---

Retrieve Documents

Hent dokumenter, der matcher en forespørgsel (uden AI-svar).

Endpoint

POST /documents/search

Request Body

{
  "chatModelId": "your-chat-model-id",
  "query": "adgangskode sikkerhed",
  "limit": 10
}

Response

{
  "success": true,
  "documents": [
    {
      "id": "doc_abc123",
      "title": "Bedste praksis for sikkerhed",
      "content": "...",
      "relevance": 0.92
    }
  ]
}

---

Kodeeksempler

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()

# Importer et dokument
result = import_document(
    title="FAQ: Fragt",
    content="Vi tilbyder gratis fragt på ordrer over $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();
}

// Importer et dokument
importDocument(
  'FAQ: Retur',
  'Du kan returnere varer inden for 30 dage efter køb...',
  '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' => 'Produkt specifikationer',
            'content' => 'Vores widget har følgende specifikationer...',
            '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));

---

Anvendelsesscenarier

Tilpasset CMS-integration

Synk indhold fra et proprietært CMS:

• Tilslut til CMS publiceringsbegivenheder
• Push nyt/opdateret indhold til AI SmartTalk
• Fjern slettet indhold

Datapipeline

Importer fra datalagre:

• Eksporter relevant data til JSON
• Batchimport via API
• Planlæg regelmæssige opdateringer

E-handelsprodukter

Synk produktdata fra tilpassede systemer:

• Produktbeskrivelser
• Specifikationer
• Prisinformation

Interne systemer

Forbind interne værktøjer, der ikke understøttes nativt:

• Tilpassede wikis
• Arv databaser
• Proprietære applikationer

---

Rate Limits

Endpoint	Rate Limit
Document Import	100 requests/minute
Query	60 requests/minute
Search	60 requests/minute

Note: Rate limits varierer afhængigt af planen. Kontakt support for højere grænser.

---

Error Handling

Error Response Format

{
  "success": false,
  "error": {
    "code": "INVALID_TOKEN",
    "message": "Den angivne API-token er ugyldig eller udløbet"
  }
}

Common Error Codes

Code	Description	Solution
INVALID_TOKEN	Dårlig eller udløbet token	Regenerer API-token
INVALID_MODEL_ID	Ukendt chatmodel ID	Tjek dit Chat Model ID
RATE_LIMITED	For mange anmodninger	Implementer backoff, prøv senere
INVALID_REQUEST	Fejl i anmodningsindhold	Tjek JSON-strukturen
DOCUMENT_TOO_LARGE	Indholdet overskrider grænsen	Del op i mindre dokumenter
QUOTA_EXCEEDED	Planens grænser nået	Opgrader eller kontakt support

---

Troubleshooting

Authentication Fails

Issue	Solution
401 Unauthorized	Tjek at token er korrekt og aktiv
Token not working	Regenerer token i indstillingerne
Expired token	Tokens udløber ikke, men kan tilbagekaldes

Import Issues

Issue	Solution
Empty response	Tjek at Content-Type er application/json
Document not appearing	Vent på behandling; tjek Knowledge-sektionen
Partial import	Nogle dokumenter kan have valideringsfejl

Performance Issues

Issue	Solution
Slow imports	Batch dokumenter (maks 100 pr. anmodning)
Timeouts	Reducer batchstørrelsen, prøv igen med backoff
Rate limited	Implementer eksponentiel backoff

---

Best Practices

1. Batch imports: Send flere dokumenter pr. anmodning (op til 100)
2. Unique titles: Brug beskrivende, unikke titler for hvert dokument
3. Structured content: Godt formateret indhold forbedrer AI-responser
4. Metadata tagging: Brug metadata til kategorisering og filtrering
5. Secure tokens: Opbevar tokens i miljøvariabler
6. Handle errors: Implementer retry-logik med eksponentiel backoff
7. Monitor usage: Spor API-opkald i forhold til dine plangrænser

---

Related Documentation

• Integrations Overview
• Full API Documentation
• Knowledge Base Management
• SmartFlow Webhooks — Modtag begivenheder