> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihive.global/llms.txt
> Use this file to discover all available pages before exploring further.
# Developers
> Developers - AI Hive Documentation
# Developer Documentation (Developers & API)
AIHive provides a powerful toolkit (API & SDK) to help you integrate artificial intelligence into your website, mobile app, or internal management system (ERP/CRM) quickly.
***
## Chat Widget Integration (Web SDK)
This is an "instant" solution (No-code) that allows you to add AIHive to your website with just a simple HTML code snippet.
First, go to the **"AI Setup"** interface, after completing the setup. Click **"Publish"**
` tag of your website:
```html theme={null}
```
### Method 2: Full Page Embed
Transform a sub-page into a dedicated AI chat interface (similar to ChatGPT interface).
Paste the following code into the `` tag:
```html theme={null}
```
### Method 3: iFrame Embed (Fixed Chat Frame)
Embed a chat frame in a fixed position within an article or admin dashboard interface.
```html theme={null}
```
## Chat API (Backend Integration)
Use this API to build a custom chat interface (Custom UI) on Mobile App or send/receive messages from your Server.
### 1. Connection Information
* **Base URL:** `https://api.aihive.global/v1`
* **Endpoint:** `/chat-messages`
* **Method:** `POST`
### 2. Authentication
Go to the Agent setup interface, click "Publish" and copy the API Key here
)' \\
--header 'Authorization: Bearer app-xxxxxxxxxxxxxxxxxxxxxxxx' \\
--header 'Content-Type: application/json' \\
--data-raw '\{
"inputs": \{\},
"query": "Advise me about products",
"response_mode": "blocking",
"conversation_id": "",
"user": "customer-01"
\}'
```
### 5. Response Example (Returned Result)
If the call is successful, the Server will return JSON containing the AI's answer:
```json theme={null}
\{
"event": "message",
"message_id": "99f074xx-xxxx-xxxx",
"conversation_id": "88e912xx-xxxx-xxxx",
"mode": "chat",
"answer": "Hello, how can AIHive help you today?",
"metadata": \{
"usage": \{
"prompt_tokens": 50,
"completion_tokens": 20,
"total_tokens": 70
\}
\},
"created_at": 1705634000
\}
```
## Error Handling
| **Error Code (HTTP Code)** | **Cause** | **Solution** |
| -------------------------- | ------------------------ | ------------------------------------------------------------------------------------------- |
| **401 Unauthorized** | Wrong API Key. | Check the `Authorization` Header to see if the key is correct. |
| **402 Payment Required** | Plan quota expired. | Top up or upgrade your AIHive plan. |
| **404 Not Found** | Wrong API path. | Check if the Base URL is correct: [`https://api.aihive.global`](https://api.oriagent.com/). |
| **429 Too Many Requests** | Sending too fast (Spam). | Limit message sending rate or contact to upgrade your limit. |
### Method 1: Floating Chat Bubble
Displays a chat icon in the corner of the screen. Suitable for Landing Pages or homepages.
Copy the following code and paste it into the `` or `