# אויטענטיפיקאציע און API שליסלען

שאפט, האלט, באגרעניצט און פארבייט API שליסלען זיכער

Canonical: https://alef-bot.top/yi/developers/guides/authentication

Updated: 2026-07-13

## שאפט א שליסל

דער באשיצטער דעשבארד איז דער איינציקער ארט צו פירן שליסלען. עפנט די [API שליסל איינשטעלונגען](/dashboard?modal=settings&tab=public-api), קלייבט Test אדער Live און גיט נאר די נויטיגע רעכטן

> **באשיצט דעם סוד.** דער שליסל ווערט געוויזן נאר איינמאל. האלט עס נישט אין בראוזער קאד, URL אדרעסן, אנאליטיקס געשעענישן, לאגס אדער מקור קאד

## שיקט דעם שליסל

שיקט דעם שליסל אין יעדן פארלאנג מיט `Authorization: Bearer <api-key>`. פארלאנגען אן א גילטיגן שליסל געבן א סטאבילן JSON טעות סטרוקטור

### cURL

```bash
curl https://alef-bot.top/api/v1/account \
  --header "Authorization: Bearer $ALEFBOT_API_KEY" \
  --header "Accept: application/json"
```

### JavaScript

```javascript
const response = await fetch("https://alef-bot.top/api/v1/account", {
  headers: {
    Authorization: `Bearer ${process.env.ALEFBOT_API_KEY}`,
    Accept: "application/json",
  },
});

if (!response.ok) throw new Error(`AlefBot request failed: ${response.status}`);
const account = await response.json();
```

### Python

```python
import os
import requests

response = requests.get(
    "https://alef-bot.top/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['ALEFBOT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
account = response.json()
```

## רעכטן און פארבייטן שליסלען

- נוצט read_only נאר פאר נאכפאלגן און באריכטן
- נוצט full_access נאר אין סיסטעמען וואס לאדן ארויף מעדיע אדער שאפן ארבעטן
- שאפט א נייעם שליסל, שטעלט עס אריין, באשטעטיקט אז די סיסטעם נוצט עס און ערשט דאן בטלט דעם אלטן

## Machine-readable sources

- [OpenAPI JSON](https://alef-bot.top/api/v1/openapi.json)

- [OpenAPI YAML](https://alef-bot.top/api/v1/openapi.yaml)

- [Arazzo workflow](https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml)