Erster API-Request

Erster API-Request

Erster API-Request ist wichtig, weil FirmAssist ohne eine stabile API-Schicht nicht zuverlässig mit dem Modell sprechen kann.

Jetzt starten Sie FirmAssist: API-Schlüssel, Ordnerstruktur und der erste PHP-Aufruf mit Modellantwort.

Im Detail

Hier bauen Sie den minimalen produktiven Fluss: Konfiguration, HTTP-Aufruf, Antwortverarbeitung und sichere Fehlerbehandlung. Wenn diese Schicht sauber ist, können spätere Chat-, OCR- und RAG-Funktionen in FirmAssist sie wiederverwenden, ohne Code zu duplizieren oder improvisierte Lösungen zu bauen.

Wichtige Punkte

• Geheimnisse bleiben ausschließlich auf dem Server.
• Die Payload muss lesbar und gültig sein.
• HTTP-Status und Body werden getrennt geprüft.
• Timing- und Fehlerlogs helfen beim späteren Debugging.

Praxisbeispiel

Erster PHP-Aufruf an den KI-Provider.

$payload = [
    'model' => 'gpt-4.1-mini',
    'input' => 'Summarize this supplier email in one sentence.',
];

$ch = curl_init('https://api.openai.com/v1/responses');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('OPENAI_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_THROW_ON_ERROR),
    CURLOPT_RETURNTRANSFER => true,
]);

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

Häufiger Fehler

Der Fehler ist, jeden Ausfall hinter einer generischen Meldung zu verstecken.

Zusammenfassung

Nach dieser Lektion können Sie einen stabilen KI-Endpoint bauen, den FirmAssist als Grundlage für spätere Module nutzt.