Dokumentation

{
  "message": "Hast du Bilder von dir?",
  "platform": "telegram",
  "platform_id": "123456789",
  "name": "Max Mustermann"
}

{
  "message": "Was siehst du auf diesem Bild?",
  "image": "https://example.com/photo.jpg",
  "platform": "telegram",
  "platform_id": "123456789",
  "name": "Max Mustermann"
}

curl -X POST https://bothosting.io/api/v1/chat/send \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hey, wie gehts?",
    "platform": "telegram",
    "platform_id": "987654321"
  }'

{
  "success": true,
  "response": "Hey! Mir geht's gut 😊 Und dir?",
  "wallet": "47.35",
  "cost": "0.000123",
  "charged_cost": "0.02",
  "customer": {
    "id": 42,
    "platform": "telegram",
    "platform_id": "123456789",
    "name": "Max Mustermann"
  }
}

{
  "success": true,
  "response": "Hier ist ein Bild für dich! 😘",
  "content": {
    "url": "https://cdn.example.com/content/image_123.jpg",
    "type": "image",
    "category": "body"
  },
  "wallet": "47.13",
  "cost": "0.000145",
  "charged_cost": "0.02",
  "customer": {
    "id": 42,
    "platform": "telegram",
    "platform_id": "123456789",
    "name": "Max Mustermann"
  }
}

{
  "success": false,
  "error": "empty_message",
  "message": "Bitte sende eine Nachricht oder ein Bild."
}

{
  "error": "Invalid token",
  "message": "The provided token is invalid or expired"
}

{
  "success": false,
  "error": "insufficient_funds",
  "message": "Kein Guthaben mehr vorhanden. Bitte Wallet aufladen.",
  "wallet": "0.00"
}

{
  "success": false,
  "error": "internal_error",
  "message": "Ein technischer Fehler ist aufgetreten. Bitte versuche es erneut."
}

{
  "success": true,
  "data": {
    "memories": [
      {
        "id": 1,
        "memory_key": "name",
        "memory_value": "Max",
        "category": "personal",
        "created_at": "2026-02-01T10:30:00Z"
      },
      {
        "id": 2,
        "memory_key": "favorite_color",
        "memory_value": "blau",
        "category": "preferences",
        "created_at": "2026-02-05T14:22:00Z"
      }
    ],
    "total": 2
  }
}

{
  "success": true,
  "message": "Kunde erfolgreich gewechselt",
  "data": {
    "customer_id": 42,
    "name": "Max Mustermann"
  }
}

{
  "success": true,
  "data": {
    "content": [
      {
        "id": 15,
        "type": "image",
        "category": "body",
        "url": "https://cdn.example.com/content/img_123.jpg",
        "description": "Ganzkörper-Foto in schwarzem Kleid",
        "price": 5.99,
        "is_free": false
      }
    ],
    "total": 1
  }
}

{
  "success": true,
  "message": "Content erfolgreich hochgeladen",
  "data": {
    "id": 23,
    "type": "image",
    "category": "lingerie",
    "url": "https://cdn.example.com/content/img_456.jpg",
    "description": "Rote Spitze",
    "price": 7.99,
    "is_free": false,
    "created_at": "2026-02-09T15:30:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Das Feld 'message' ist erforderlich",
    "details": {
      "field": "message",
      "validation": "required"
    }
  }
}

const sendMessage = async (message) => {
  try {
    const response = await fetch('https://api.chatbot.example/v1/chat/send', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer YOUR_API_TOKEN',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ message })
    });

    const data = await response.json();
    console.log('Bot Antwort:', data.data.message);

    if (data.data.content) {
      console.log('Content erhalten:', data.data.content);
    }
  } catch (error) {
    console.error('Fehler:', error);
  }
};

sendMessage('Hallo Bot!');

import requests

API_TOKEN = 'YOUR_API_TOKEN'
BASE_URL = 'https://api.chatbot.example/v1'

def send_message(message):
    headers = {
        'Authorization': f'Bearer {API_TOKEN}',
        'Content-Type': 'application/json'
    }

    payload = {'message': message}

    response = requests.post(
        f'{BASE_URL}/chat/send',
        headers=headers,
        json=payload
    )

    data = response.json()
    print('Bot Antwort:', data['data']['message'])

    if data['data']['content']:
        print('Content erhalten:', data['data']['content'])

send_message('Hallo Bot!')

<?php

$apiToken = 'YOUR_API_TOKEN';
$baseUrl = 'https://api.chatbot.example/v1';

function sendMessage($message, $apiToken, $baseUrl) {
    $ch = curl_init($baseUrl . '/chat/send');

    $headers = [
        'Authorization: Bearer ' . $apiToken,
        'Content-Type: application/json'
    ];

    $payload = json_encode(['message' => $message]);

    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

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

    $data = json_decode($response, true);
    echo 'Bot Antwort: ' . $data['data']['message'] . "\n";

    if (!empty($data['data']['content'])) {
        echo 'Content erhalten: ' . print_r($data['data']['content'], true);
    }
}

sendMessage('Hallo Bot!', $apiToken, $baseUrl);