> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API'ye genel bakış

> Macaly API'si ile web uygulamalarını programatik olarak oluşturun ve dağıtın

Macaly API'si, harici uygulamaların sohbet oturumları oluşturmasına, yapay zeka ile web uygulamaları geliştirmesine ve bunları programatik olarak üretime dağıtmasına olanak tanır.

<Callout icon="user">
  Yalnızca [**Ajans planında**](/docs/tr/welcome/pricing) kullanılabilir
</Callout>

## Temel URL

```
https://www.macaly.com
```

## Hızlı başlangıç

1. **API anahtarı alın** - Bkz. [Kimlik doğrulama](/docs/tr/api/authentication)
2. **Sohbet oluşturun** - Geliştirmeye başlamak için bir istem gönderin
3. **İlerlemeyi takip edin** - Yapay zekanın işini bitirmesini bekleyin
4. **Dağıtın** - Uygulamanızı üretime yayınlayın

## Mevcut endpoint'ler

| Metot | Endpoint | Açıklama |
| - | - | - |
| POST | [`/api/chat`](/docs/tr/api/create-chat) | Yeni bir sohbet oluşturma ve geliştirmeye başlama |
| POST | [`/api/chat/{chatId}/publish`](/docs/tr/api/publish-message) | Mevcut bir sohbete mesaj gönderme |
| POST | [`/api/client-app/assets/upload`](/docs/tr/api/upload-asset) | Dosya yükleme ve kalıcı bir CDN URL'si alma |
| GET | [`/api/chat/{chatId}/status`](/docs/tr/api/get-status) | İşlem durumunu takip etme |
| GET | [`/api/chat/{chatId}/subscribe`](/docs/tr/api/subscribe-stream) | Gerçek zamanlı stream'e abone olma |
| POST | [`/api/chat/{chatId}/deploy`](/docs/tr/api/deploy) | Sohbeti üretime dağıtma |
| GET | [`/api/chat/{chatId}/deployment`](/docs/tr/api/get-deployment) | Dağıtım durumunu alma |

## İstek limitleri ve krediler

* API istekleri, ekibinizin bakiyesinden kredi harcar
* Her sohbet oluşturma, web arayüzünü kullanmakla aynı maliyettedir
* Başarısız API anahtarı denemeleri sınırlandırılır (IP başına dakikada 5)
* Kullanımınızı **Ayarlar → Kullanım ve Sınırlar** bölümünden takip edin

## Hata yönetimi

Tüm hatalar, `error` alanı içeren bir JSON döndürür:

```json theme={null}
{
  "error": "Error message here"
}
```

### HTTP durum kodları

| Kod | Açıklama |
| - | - |
| 400 | Bad Request - Geçersiz istek gövdesi |
| 401 | Unauthorized - Geçersiz veya eksik API anahtarı |
| 402 | Payment Required - Yetersiz kredi |
| 403 | Forbidden - Yetki yok veya yanlış ekip |
| 404 | Not Found - Kaynak bulunamadı |
| 422 | Unprocessable Entity - Doğrulama hatası |
| 429 | Too Many Requests - İstek limiti aşıldı |
| 500 | Internal Server Error - Sunucu taraflı hata |
| 503 | Service Unavailable - Sunucu meşgul, daha sonra tekrar deneyin |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.