social-agent-cli 1.0.0

package/knowledge/mastodon.md

@@ -0,0 +1,1291 @@
+# Mastodon Platform Bilgi Dosyasi
+
+> Mastodon acik kaynakli, merkeziyetsiz (federated) bir sosyal ag platformudur. Her sunucu (instance) bagimsiz calisir ancak birbirleriyle iletisim kurabilir (federation). API tamamen ucretsizdir ve rate limit disinda herhangi bir kisitlama yoktur. Otomasyon icin API kullanimi birincil yontemdir.
+
+---
+
+## 1. Kimlik Dogrulama (Authentication)
+
+### 1.1. OAuth 2.0 Akisi
+
+Mastodon standart OAuth 2.0 protokolunu kullanir. Tum API istekleri icin once uygulama kaydedilmeli, sonra kullanici yetkilendirmesi alinmalidir.
+
+**Adim 1: Uygulama Kaydi**
+
+```
+POST /api/v1/apps
+```
+
+| Parametre | Tip | Zorunlu | Aciklama |
+|-----------|-----|---------|----------|
+| `client_name` | String | Evet | Uygulama adi |
+| `redirect_uris` | String/Array | Evet | Yonlendirme URL'si veya `urn:ietf:wg:oauth:2.0:oob` (kodu dogrudan gosterir) |
+| `scopes` | String | Hayir | Boslukla ayrilmis izin listesi (varsayilan: `read`) |
+| `website` | String | Hayir | Uygulama web sitesi |
+
+Yanit: `client_id`, `client_secret`, `id`, `name`, `scopes`, `redirect_uris` dondurur.
+
+> ONEMLI: `client_id` ve `client_secret` degerlerini sifre gibi saklayin. Sifrelenerek cache'lenmelidir.
+
+**Adim 2: Kullanici Yetkilendirmesi**
+
+```
+GET /oauth/authorize
+```
+
+| Parametre | Tip | Zorunlu | Aciklama |
+|-----------|-----|---------|----------|
+| `response_type` | String | Evet | `code` olmali |
+| `client_id` | String | Evet | Uygulama kaydindan alinan client_id |
+| `redirect_uri` | String | Evet | Kayit sirasinda belirtilen URI |
+| `scope` | String | Evet | Istenen izinler |
+| `state` | String | Hayir | CSRF korumasi icin rastgele deger |
+| `code_challenge` | String | Hayir | PKCE destegi (yalnizca S256) |
+| `code_challenge_method` | String | Hayir | `S256` olmali |
+| `force_login` | Boolean | Hayir | Yeniden giris zorla |
+| `lang` | String | Hayir | ISO 639-1 dil kodu |
+
+Kullanici yetkilendirme sonrasi `redirect_uri`'ye `code` parametresiyle yonlendirilir.
+
+**Adim 3: Token Degisimi**
+
+```
+POST /oauth/token
+```
+
+| Parametre | Tip | Zorunlu | Aciklama |
+|-----------|-----|---------|----------|
+| `grant_type` | String | Evet | `authorization_code` (kullanici) veya `client_credentials` (uygulama) |
+| `code` | String | Evet* | Yetkilendirme kodu (*authorization_code icin) |
+| `client_id` | String | Evet | Uygulama client_id |
+| `client_secret` | String | Evet | Uygulama client_secret |
+| `redirect_uri` | String | Evet | Kayit sirasinda belirtilen URI |
+| `code_verifier` | String | Hayir | PKCE kullaniliyorsa zorunlu |
+
+Yanit: `access_token`, `token_type`, `scope`, `created_at` dondurur.
+
+**Token Kullanimi**
+
+Tum API isteklerinde header olarak eklenir:
+```
+Authorization: Bearer <access_token>
+```
+
+**Token Iptali**
+
+```
+POST /oauth/revoke
+```
+
+Idempotent islemdir - birden fazla cagri ayni sonucu verir.
+
+### 1.2. OAuth Kapsam (Scope) Yapisi
+
+**Ana Kapsamlar:**
+- `read` - Tum okuma islemleri
+- `write` - Tum yazma islemleri
+- `follow` - Takip islemleri (eski uyumluluk)
+- `push` - Web Push bildirimleri
+- `profile` - Profil bilgilerine erisim (OpenID Connect)
+
+**Detayli Read Kapsamlari:**
+`read:accounts`, `read:blocks`, `read:bookmarks`, `read:favourites`, `read:filters`, `read:follows`, `read:lists`, `read:mutes`, `read:notifications`, `read:search`, `read:statuses`
+
+**Detayli Write Kapsamlari:**
+`write:accounts`, `write:blocks`, `write:bookmarks`, `write:conversations`, `write:favourites`, `write:filters`, `write:follows`, `write:lists`, `write:media`, `write:mutes`, `write:notifications`, `write:reports`, `write:statuses`
+
+**Admin Kapsamlari:**
+`admin:read`, `admin:write` ve bunlarin alt kapsamlari (accounts, reports, domain_allows, domain_blocks, ip_blocks)
+
+### 1.3. Uygulama Dogrulama
+
+```
+GET /api/v1/apps/verify_credentials
+```
+- Yetkilendirme: `Authorization: Bearer <app_token>`
+- Uygulama bilgilerini dondurur
+- 401: Gecersiz token
+
+### 1.4. Kullanici Bilgisi (OpenID Connect)
+
+```
+GET /oauth/userinfo
+```
+- Kapsam: `profile`
+- Kullanici adi, profil URL'si, resmi dondurur
+
+### 1.5. OAuth Metadata
+
+```
+GET /.well-known/oauth-authorization-server
+```
+- RFC 8414 uyumlu
+- Desteklenen kapsamlar, endpoint'ler, grant turleri
+
+---
+
+## 2. API Endpoint'leri
+
+### 2.1. Gonderi (Status) Islemleri
+
+#### Gonderi Olusturma
+
+```
+POST /api/v1/statuses
+```
+- Yetkilendirme: Kullanici token + `write:statuses`
+
+| Parametre | Tip | Zorunlu | Aciklama |
+|-----------|-----|---------|----------|
+| `status` | String | Evet* | Gonderi metni (*media_ids yoksa zorunlu) |
+| `media_ids[]` | Array | Hayir | Medya ekleri (onceden yuklenenmis, max 4) |
+| `poll[options][]` | Array | Hayir | Anket secenekleri |
+| `poll[expires_in]` | Integer | Anketse evet | Anket suresi (saniye) |
+| `poll[multiple]` | Boolean | Hayir | Coklu secim izni |
+| `poll[hide_totals]` | Boolean | Hayir | Toplam oylari gizle |
+| `in_reply_to_id` | String | Hayir | Yanitlanan gonderinin ID'si |
+| `sensitive` | Boolean | Hayir | Hassas icerik olarak isaretle |
+| `spoiler_text` | String | Hayir | Icerik uyarisi (Content Warning) metni |
+| `visibility` | String | Hayir | `public`, `unlisted`, `private`, `direct` |
+| `language` | String | Hayir | ISO 639-1 dil kodu |
+| `scheduled_at` | Datetime | Hayir | Zamanlama (en az 5 dakika sonrasi) |
+| `quoted_status_id` | String | Hayir | Alinti yapilan gonderi ID'si |
+
+Yanit: Status entity (zamanlanmissa ScheduledStatus entity) dondurur.
+
+> ONEMLI: `status` veya `media_ids[]` parametrelerinden en az biri zorunludur. Gonderi bos olamaz.
+
+#### Gonderi Goruntuleme
+
+```
+GET /api/v1/statuses/:id
+```
+- Public gonderiler icin kimlik dogrulama gerekmez
+- Ozel gonderiler icin: Kullanici token + `read:statuses`
+
+#### Coklu Gonderi Goruntuleme
+
+```
+GET /api/v1/statuses
+```
+- Parametre: `id[]` - Gonderi ID'leri dizisi
+
+#### Gonderi Silme
+
+```
+DELETE /api/v1/statuses/:id
+```
+- Yetkilendirme: Kullanici token + `write:statuses`
+- Parametre: `delete_media` (Boolean) - Medyayi hemen sil
+- Yanit: Kaynak metin ve medya bilgileriyle birlikte Status dondurur
+
+#### Gonderi Duzenleme
+
+```
+PUT /api/v1/statuses/:id
+```
+- Yetkilendirme: Kullanici token + `write:statuses`
+- Parametreler: `status`, `spoiler_text`, `sensitive`, `language`, `media_ids[]`, `media_attributes[][]`, `poll[*]`
+- NOT: Anket duzenlenirse oylar sifirlanir
+
+#### Gonderi Baglami (Context)
+
+```
+GET /api/v1/statuses/:id/context
+```
+- Public: 40 ust + 60 alt gonderi
+- Kimlik dogrulanmis: 4096 ust + 4096 alt gonderi (sinir yok)
+- Yanit: `ancestors` ve `descendants` dizileri
+
+#### Gonderi Gecmisi
+
+```
+GET /api/v1/statuses/:id/history
+```
+- Tum duzenleme versiyonlarini dondurur (StatusEdit dizisi)
+
+#### Gonderi Kaynagi
+
+```
+GET /api/v1/statuses/:id/source
+```
+- Kapsam: `read:statuses`
+- Ham metin ve spoiler_text dondurur
+
+#### Gonderi Ceviri
+
+```
+POST /api/v1/statuses/:id/translate
+```
+- Kapsam: `read:statuses`
+- Parametre: `lang` (ISO 639-1 hedef dil)
+- Yalnizca public/unlisted gonderiler cevrileblir
+
+### 2.2. Gonderi Etkilesim Endpoint'leri
+
+#### Begeni (Favourite)
+
+```
+POST /api/v1/statuses/:id/favourite      # Begen
+POST /api/v1/statuses/:id/unfavourite    # Begeniyi kaldir
+```
+- Kapsam: `write:favourites`
+- Yanit: `favourited` alani guncellenmis Status
+
+#### Boost (Reblog)
+
+```
+POST /api/v1/statuses/:id/reblog         # Boost et
+POST /api/v1/statuses/:id/unreblog       # Boost'u kaldir
+```
+- Kapsam: `write:statuses`
+- Boost parametresi: `visibility` (public/unlisted/private)
+- Yanit: Orijinal gonderiyi `reblog` ozelliginde saran Status
+
+#### Yer Imi (Bookmark)
+
+```
+POST /api/v1/statuses/:id/bookmark       # Yer imine ekle
+POST /api/v1/statuses/:id/unbookmark     # Yer iminden cikar
+```
+- Kapsam: `write:bookmarks`
+
+#### Susturma (Mute Conversation)
+
+```
+POST /api/v1/statuses/:id/mute           # Konusmayi sustur
+POST /api/v1/statuses/:id/unmute         # Susturmayi kaldir
+```
+- Kapsam: `write:mutes`
+- NOT: Kullanici konusma katilimcisi olmali
+
+#### Sabitleme (Pin)
+
+```
+POST /api/v1/statuses/:id/pin            # Sabitle
+POST /api/v1/statuses/:id/unpin          # Sabitlemeyi kaldir
+```
+- Kapsam: `write:accounts`
+- Yalnizca kendi gonderilerinizi sabitleyebilirsiniz
+- Sunucu basina sabitlenebilir gonderi limiti vardir (genellikle 5)
+
+### 2.3. Gonderi Kesif Endpoint'leri
+
+#### Boost Edenleri Gor
+
+```
+GET /api/v1/statuses/:id/reblogged_by
+```
+- Parametre: `limit` (max 80, varsayilan 40)
+- Yanit: Account dizisi
+
+#### Begeni Yapanlari Gor
+
+```
+GET /api/v1/statuses/:id/favourited_by
+```
+- Parametre: `limit` (max 80, varsayilan 40)
+- Yanit: Account dizisi
+
+#### Alintilari Gor
+
+```
+GET /api/v1/statuses/:id/quotes
+```
+- Kapsam: `read:statuses`
+- Parametre: `limit` (max 40, varsayilan 20)
+
+### 2.4. Medya Islemleri
+
+#### Medya Yukleme (v2 - Asenkron)
+
+```
+POST /api/v2/media
+```
+- Kapsam: `write:media`
+
+| Parametre | Tip | Zorunlu | Aciklama |
+|-----------|-----|---------|----------|
+| `file` | Multipart | Evet | Medya dosyasi (MIME tipiyle birlikte) |
+| `thumbnail` | Multipart | Hayir | Ozel kucuk resim |
+| `description` | String | Hayir | Erisebilirlik metni (alt text, max 1500 karakter) |
+| `focus` | String | Hayir | Odak noktasi koordinatlari (x,y) -1.0 ile 1.0 arasi |
+
+Yanit Kodlari:
+- `200 OK`: Kucuk resimler aninda islenir, `url` dolu gelir
+- `202 Accepted`: Buyuk medya islenmeye devam ediyor, `url` null olabilir, `preview_url` mevcut
+- `422`: Gecersiz dosya tipi
+
+#### Medya Durumu Kontrol
+
+```
+GET /api/v1/media/:id
+```
+- `200 OK`: Isleme tamamlandi
+- `206 Partial Content`: Hala isleniyor
+- `404`: Bulunamadi veya sizin deginiz
+
+#### Medya Guncelleme
+
+```
+PUT /api/v1/media/:id
+```
+- Parametreler: `thumbnail`, `description`, `focus`
+- Gonderi olusturmadan once metadata guncellenebilir
+
+#### Medya Silme
+
+```
+DELETE /api/v1/media/:id
+```
+- Bos yanit dondurur
+
+#### Desteklenen Medya Formatlari
+
+**Resim:** JPEG, PNG, GIF, WebP, HEIC, HEIF, AVIF
+**Video:** WebM, MP4, QuickTime, Ogg
+**Ses:** WAV, FLAC, AAC, M4A, MP3, Ogg
+
+#### Medya Boyut Limitleri (Varsayilan Instance Ayarlari)
+
+| Tur | Limit |
+|-----|-------|
+| Resim dosya boyutu | 16 MB (16,777,216 byte) |
+| Video dosya boyutu | ~99 MB (103,809,024 byte) |
+| Resim piksel limiti | 33,177,600 piksel (orn. ~5760x5760) |
+| Video piksel limiti | 8,294,400 piksel (orn. 3840x2160) |
+| Video kare hizi limiti | 120 fps |
+| Gonderi basina medya | 4 adet |
+| Aciklama (alt text) | 1500 karakter |
+
+### 2.5. Hesap Islemleri
+
+#### Hesap Bilgisi
+
+```
+GET /api/v1/accounts/:id                    # Tek hesap
+GET /api/v1/accounts                        # Coklu hesap (id[] parametresi)
+GET /api/v1/accounts/verify_credentials     # Kendi hesabini dogrula
+GET /api/v1/accounts/lookup                 # Kullanici adi ile ara (acct parametresi)
+```
+
+#### Hesap Arama
+
+```
+GET /api/v1/accounts/search
+```
+
+| Parametre | Tip | Zorunlu | Aciklama |
+|-----------|-----|---------|----------|
+| `q` | String | Evet | Arama sorgusu |
+| `limit` | Integer | Hayir | Sonuc limiti |
+| `offset` | Integer | Hayir | Atlama |
+| `resolve` | Boolean | Hayir | Uzak hesaplari WebFinger ile cozumle |
+| `following` | Boolean | Hayir | Yalnizca takip edilenler |
+
+#### Profil Guncelleme
+
+```
+PATCH /api/v1/accounts/update_credentials
+```
+- Kapsam: `write:accounts`
+
+| Parametre | Tip | Aciklama |
+|-----------|-----|----------|
+| `display_name` | String | Gorunen ad |
+| `note` | String | Biyografi |
+| `avatar` | Multipart | Profil resmi |
+| `header` | Multipart | Kapak resmi |
+| `locked` | Boolean | Hesabi kilitle (takip onay gerektir) |
+| `bot` | Boolean | Bot hesabi olarak isaretle |
+| `discoverable` | Boolean | Kesif'te gorunur |
+| `hide_collections` | Boolean | Takipci/takip listesini gizle |
+| `indexable` | Boolean | Arama motorlarina izin ver |
+| `fields_attributes` | Array | Profil alanlari (anahtar-deger ciftleri) |
+
+#### Takip Islemleri
+
+```
+POST /api/v1/accounts/:id/follow           # Takip et
+POST /api/v1/accounts/:id/unfollow         # Takibi birak
+POST /api/v1/accounts/:id/remove_from_followers  # Takipcilerden cikar
+```
+
+Follow parametreleri:
+| Parametre | Tip | Aciklama |
+|-----------|-----|----------|
+| `reblogs` | Boolean | Boost'lari goster |
+| `notify` | Boolean | Yeni gonderi bildirimi al |
+| `languages[]` | Array | Yalnizca belirli dillerdeki gonderileri goster |
+
+Kapsam: `write:follows`
+
+#### Takipci/Takip Listesi
+
+```
+GET /api/v1/accounts/:id/followers          # Takipciler
+GET /api/v1/accounts/:id/following          # Takip edilenler
+```
+- Parametre: `limit` (max 80)
+
+#### Engelleme
+
+```
+POST /api/v1/accounts/:id/block             # Engelle
+POST /api/v1/accounts/:id/unblock           # Engeli kaldir
+```
+- Kapsam: `write:blocks`
+
+#### Susturma
+
+```
+POST /api/v1/accounts/:id/mute              # Sustur
+POST /api/v1/accounts/:id/unmute            # Susturmayi kaldir
+```
+- Kapsam: `write:mutes`
+- Mute parametreleri: `notifications` (Boolean), `duration` (Integer, saniye)
+
+#### One Cikarma (Endorse)
+
+```
+POST /api/v1/accounts/:id/endorse           # One cikar
+POST /api/v1/accounts/:id/unendorse         # One cikarmadan kaldir
+```
+- Kapsam: `write:accounts`
+- Oncelikle takip ediyor olmalisiniz
+
+#### Iliski Sorgulama
+
+```
+GET /api/v1/accounts/relationships
+```
+- Parametre: `id[]` (hesap ID dizisi), `with_suspended` (Boolean)
+- Kapsam: `read:follows`
+- Yanit: Relationship dizisi (following, followed_by, blocking, muting, vb.)
+
+#### Tanidik Takipciler
+
+```
+GET /api/v1/accounts/familiar_followers
+```
+- Parametre: `id[]`
+- Kapsam: `read:follows`
+
+#### Hesap Gonderileri
+
+```
+GET /api/v1/accounts/:id/statuses
+```
+
+| Parametre | Tip | Aciklama |
+|-----------|-----|----------|
+| `max_id` | String | Ust sinir |
+| `since_id` | String | Alt sinir |
+| `min_id` | String | Ileri sayfalama |
+| `limit` | Integer | Max 40 |
+| `only_media` | Boolean | Yalnizca medyali gonderiler |
+| `exclude_replies` | Boolean | Yanitlari haric tut |
+| `exclude_reblogs` | Boolean | Boost'lari haric tut |
+| `pinned` | Boolean | Yalnizca sabitlenmis gonderiler |
+| `tagged` | String | Belirli etiketle filtrele |
+
+#### Ozel Not
+
+```
+POST /api/v1/accounts/:id/note
+```
+- Parametre: `comment` (bos string ile temizlenir)
+- Kapsam: `write:accounts`
+
+### 2.6. Zaman Cizelgesi (Timeline) Endpoint'leri
+
+#### Ana Sayfa Zaman Cizelgesi
+
+```
+GET /api/v1/timelines/home
+```
+- Kapsam: `read:statuses`
+- Takip edilen hesap ve etiketlerin gonderilerini gosterir
+
+#### Genel (Public) Zaman Cizelgesi
+
+```
+GET /api/v1/timelines/public
+```
+- Kimlik dogrulama: Public (instance ayarina bagli olarak `read:statuses` gerekebilir)
+
+| Parametre | Tip | Aciklama |
+|-----------|-----|----------|
+| `local` | Boolean | Yalnizca yerel gonderiler |
+| `remote` | Boolean | Yalnizca uzak gonderiler |
+| `only_media` | Boolean | Yalnizca medyali gonderiler |
+
+#### Etiket (Hashtag) Zaman Cizelgesi
+
+```
+GET /api/v1/timelines/tag/:hashtag
+```
+
+| Parametre | Tip | Aciklama |
+|-----------|-----|----------|
+| `:hashtag` | String | Etiket adi (# isareti olmadan) |
+| `any[]` | Array | Ek etiketlerden herhangi biri (max 4) |
+| `all[]` | Array | Tum ek etiketler bulunmali |
+| `none[]` | Array | Bu etiketler haric |
+| `local` | Boolean | Yalnizca yerel |
+| `remote` | Boolean | Yalnizca uzak |
+| `only_media` | Boolean | Yalnizca medyali |
+
+#### Liste Zaman Cizelgesi
+
+```
+GET /api/v1/timelines/list/:list_id
+```
+- Kapsam: `read:lists`
+
+#### Baglanti Zaman Cizelgesi
+
+```
+GET /api/v1/timelines/link?url=:url
+```
+- Trend olan bir makaleye baglanti veren gonderileri gosterir
+
+#### Tum Timeline'lar Icin Ortak Sayfalama Parametreleri
+
+| Parametre | Tip | Aciklama |
+|-----------|-----|----------|
+| `max_id` | String | Bu ID'den onceki sonuclar |
+| `since_id` | String | Bu ID'den sonraki sonuclar |
+| `min_id` | String | Ileri yonde sayfalama imeci |
+| `limit` | Integer | Varsayilan 20, max 40 |
+
+### 2.7. Arama
+
+```
+GET /api/v2/search
+```
+- Kapsam: `read:search` (veya public sinirli erisim)
+
+| Parametre | Tip | Zorunlu | Aciklama |
+|-----------|-----|---------|----------|
+| `q` | String | Evet | Arama sorgusu |
+| `type` | String | Hayir | `accounts`, `hashtags`, `statuses` |
+| `resolve` | Boolean | Hayir | WebFinger ile uzak hesaplari cozumle |
+| `following` | Boolean | Hayir | Yalnizca takip edilenler |
+| `account_id` | String | Hayir | Belirli hesabin gonderileri |
+| `exclude_unreviewed` | Boolean | Hayir | Incelenmemis etiketleri filtrele |
+| `min_id` | String | Hayir | Sayfalama |
+| `max_id` | String | Hayir | Sayfalama |
+| `limit` | Integer | Hayir | Varsayilan 20, max 40 |
+| `offset` | Integer | Hayir | Atlama (`type` parametresi gerektirir) |
+
+Yanit: `accounts`, `statuses`, `hashtags` dizileri iceren Search entity
+
+### 2.8. Bildirimler
+
+#### Tum Bildirimleri Listele
+
+```
+GET /api/v1/notifications
+```
+- Kapsam: `read:notifications`
+
+| Parametre | Tip | Aciklama |
+|-----------|-----|----------|
+| `max_id`, `since_id`, `min_id` | String | Sayfalama |
+| `limit` | Integer | Varsayilan 40, max 80 |
+| `types[]` | Array | Dahil edilecek bildirim turleri |
+| `exclude_types[]` | Array | Haric tutulacak bildirim turleri |
+| `account_id` | String | Belirli hesaptan bildirimler |
+| `include_filtered` | Boolean | Filtrelenmis bildirimleri dahil et |
+
+#### Bildirim Turleri
+
+| Tur | Aciklama |
+|-----|----------|
+| `mention` | Bahsetme |
+| `status` | Takip edilen hesabin yeni gonderisi |
+| `reblog` | Boost |
+| `follow` | Yeni takipci |
+| `follow_request` | Takip istegi |
+| `favourite` | Begeni |
+| `poll` | Katildiginiz anket sona erdi |
+| `update` | Duzenlenmis gonderi |
+| `admin.sign_up` | Yeni kullanici kaydi (admin) |
+| `admin.report` | Yeni rapor (admin) |
+
+#### Tek Bildirim
+
+```
+GET /api/v1/notifications/:id
+```
+
+#### Bildirimi Kapat
+
+```
+POST /api/v1/notifications/:id/dismiss
+```
+- Kapsam: `write:notifications`
+
+#### Tum Bildirimleri Temizle
+
+```
+POST /api/v1/notifications/clear
+```
+- Kapsam: `write:notifications`
+
+### 2.9. Zamanlanmis Gonderiler
+
+#### Zamanlanmis Gonderileri Listele
+
+```
+GET /api/v1/scheduled_statuses
+```
+- Kapsam: `read:statuses`
+- Sayfalama: `max_id`, `since_id`, `min_id`, `limit` (max 40, varsayilan 20)
+
+#### Tek Zamanlanmis Gonderi
+
+```
+GET /api/v1/scheduled_statuses/:id
+```
+
+#### Zamanlama Guncelle
+
+```
+PUT /api/v1/scheduled_statuses/:id
+```
+- Parametre: `scheduled_at` (en az 5 dakika sonrasi olmali)
+- Kapsam: `write:statuses`
+
+#### Zamanlanmis Gonderi Iptal
+
+```
+DELETE /api/v1/scheduled_statuses/:id
+```
+- Kapsam: `write:statuses`
+
+### 2.10. Listeler
+
+#### Liste CRUD
+
+```
+GET /api/v1/lists                          # Tum listeleri gor
+GET /api/v1/lists/:id                      # Tek liste
+POST /api/v1/lists                         # Liste olustur
+PUT /api/v1/lists/:id                      # Liste guncelle
+DELETE /api/v1/lists/:id                   # Liste sil
+```
+
+Olusturma/Guncelleme parametreleri:
+| Parametre | Tip | Zorunlu | Aciklama |
+|-----------|-----|---------|----------|
+| `title` | String | Evet | Liste adi |
+| `replies_policy` | String | Hayir | `followed`, `list`, `none` |
+| `exclusive` | Boolean | Hayir | Ozel liste (ana timeline'dan cikar) |
+
+#### Liste Hesap Yonetimi
+
+```
+GET /api/v1/lists/:id/accounts             # Listedeki hesaplar
+POST /api/v1/lists/:id/accounts            # Hesap ekle
+DELETE /api/v1/lists/:id/accounts          # Hesap cikar
+```
+- Parametre: `account_ids[]` (hesap ID dizisi)
+- NOT: Listeye eklemek icin hesabi takip ediyor olmalisiniz
+- Liste goruntuleme limiti: max 80, varsayilan 40
+
+### 2.11. Begeniler ve Yer Imleri Listeleme
+
+#### Begenilen Gonderiler
+
+```
+GET /api/v1/favourites
+```
+- Kapsam: `read:favourites`
+- Sayfalama: HTTP `Link` header ile (Bookmark ID'leri API'de gosterilmez)
+- Parametre: `limit` (varsayilan 20, max 40)
+
+#### Yer Imine Alinan Gonderiler
+
+```
+GET /api/v1/bookmarks
+```
+- Kapsam: `read:bookmarks`
+- Sayfalama: HTTP `Link` header ile
+- Parametre: `limit` (varsayilan 20, max 40)
+
+### 2.12. Konusmalar (Conversations)
+
+```
+GET /api/v1/conversations                  # Tum konusmalari listele
+DELETE /api/v1/conversations/:id           # Konusmayi sil
+POST /api/v1/conversations/:id/read        # Okundu olarak isaretle
+```
+- Listele kapsamlari: `read:statuses`
+- Yazma kapsamlari: `write:conversations`
+- Parametre: `limit` (varsayilan 20, max 40)
+
+### 2.13. Takip Istekleri
+
+```
+GET /api/v1/follow_requests                            # Bekleyen istekler
+POST /api/v1/follow_requests/:account_id/authorize     # Onayla
+POST /api/v1/follow_requests/:account_id/reject        # Reddet
+```
+- Okuma kapsami: `read:follows` veya `follow`
+- Yazma kapsami: `write:follows` veya `follow`
+- Parametre: `limit` (varsayilan 40, max 80)
+
+### 2.14. Trendler
+
+```
+GET /api/v1/trends/tags                    # Trend etiketler
+GET /api/v1/trends/statuses               # Trend gonderiler
+GET /api/v1/trends/links                   # Trend baglantilar
+```
+- Kimlik dogrulama gerekmez (Public)
+- Parametreler: `limit`, `offset`
+- Tags/Links: varsayilan 10, max 20
+- Statuses: varsayilan 20, max 40
+- NOT: Sonuclar ic puanlama algoritmasina gore siralanir, kronolojik degildir
+
+### 2.15. Oneriler (Suggestions)
+
+```
+GET /api/v2/suggestions                    # Takip onerileri
+DELETE /api/v1/suggestions/:account_id     # Oneriyi kaldir
+```
+- Kapsam: `read`
+- Parametre: `limit` (varsayilan 40, max 80)
+
+### 2.16. Filtreler (v2)
+
+```
+GET /api/v2/filters                        # Tum filtreler
+GET /api/v2/filters/:id                    # Tek filtre
+POST /api/v2/filters                       # Filtre olustur
+PUT /api/v2/filters/:id                    # Filtre guncelle
+DELETE /api/v2/filters/:id                 # Filtre sil
+```
+
+Olusturma parametreleri:
+| Parametre | Tip | Zorunlu | Aciklama |
+|-----------|-----|---------|----------|
+| `title` | String | Evet | Filtre adi |
+| `context[]` | Array | Evet | `home`, `notifications`, `public`, `thread`, `account` |
+| `filter_action` | String | Hayir | `warn`, `hide`, `blur` |
+| `expires_in` | Integer | Hayir | Sure (saniye) |
+| `keywords_attributes[]` | Array | Hayir | Anahtar kelimeler |
+
+### 2.17. Anketler (Polls)
+
+```
+GET /api/v1/polls/:id                      # Anketi gor
+POST /api/v1/polls/:id/votes              # Oy ver
+```
+
+Oy verme parametresi: `choices[]` (0 tabanli indeks dizisi)
+
+Anket Konfigurasyonu (varsayilan):
+| Ayar | Deger |
+|------|-------|
+| Max secenek | 4 |
+| Secenek basina karakter | 50 |
+| Min sure | 300 saniye (5 dakika) |
+| Max sure | 2,629,746 saniye (~30 gun) |
+
+### 2.18. Instance Bilgileri
+
+```
+GET /api/v2/instance                       # Sunucu bilgileri (guncel)
+GET /api/v1/instance                       # Sunucu bilgileri (eski, kullanmayin)
+```
+
+Instance endpoint'i sunucu konfigurasyonunu dondurur:
+- Karakter limitleri
+- Medya limitleri
+- Anket limitleri
+- Desteklenen dosya turleri
+- Kayit ayarlari
+- Ceviri destegi
+- VAPID public key (push bildirimleri icin)
+
+### 2.19. Streaming API (Canli Akis)
+
+#### HTTP Server-Sent Events (SSE)
+
+```
+GET /api/v1/streaming/health               # Saglik kontrolu
+GET /api/v1/streaming/user                  # Ana sayfa + bildirimler
+GET /api/v1/streaming/user/notification     # Yalnizca bildirimler
+GET /api/v1/streaming/public               # Federe zaman cizelgesi
+GET /api/v1/streaming/public/local         # Yerel zaman cizelgesi
+GET /api/v1/streaming/public/remote        # Yalnizca uzak sunucular
+GET /api/v1/streaming/hashtag              # Etiket akisi (tag parametresi gerekli)
+GET /api/v1/streaming/hashtag/local        # Yerel etiket akisi
+GET /api/v1/streaming/list                 # Liste akisi (list parametresi gerekli)
+GET /api/v1/streaming/direct               # Direkt mesajlar
+```
+
+#### WebSocket Baglantisi
+
+```
+wss://mastodon.example/api/v1/streaming
+```
+- JSON formatinda subscribe/unsubscribe mesajlari destekler
+- Coklu akis tek baglantida multiplexing yapilabilir
+
+#### Akis Turleri
+
+`user`, `public`, `public:local`, `public:remote`, `hashtag`, `list`, `direct`
+
+Medya varyantlari: `public:media`, `public:local:media`, `public:remote:media`
+
+Ozel: `user:notification`
+
+#### Olay Turleri
+
+| Olay | Aciklama |
+|------|----------|
+| `update` | Yeni gonderi |
+| `delete` | Gonderi silindi |
+| `notification` | Yeni bildirim |
+| `status.update` | Gonderi duzenlendi |
+| `conversation` | Konusma guncellendi |
+| `filters_changed` | Filtreler degisti |
+| `announcement` | Yeni duyuru |
+| `announcement.reaction` | Duyuruya reaksiyon |
+| `announcement.delete` | Duyuru silindi |
+
+### 2.20. Web Push Bildirimleri
+
+```
+POST /api/v1/push/subscription             # Abone ol
+GET /api/v1/push/subscription              # Mevcut aboneligi gor
+PUT /api/v1/push/subscription              # Abonelik ayarlarini guncelle
+DELETE /api/v1/push/subscription           # Aboneligi sil
+```
+- Kapsam: `push`
+- Web Push API standardini kullanir
+- Parametreler: endpoint URL, sifreleme anahtarlari (p256dh, auth), uyari tercihleri
+
+---
+
+## 3. Gorunurluk Seviyeleri (Visibility)
+
+| Seviye | Aciklama | Davranis |
+|--------|----------|----------|
+| `public` | Herkese acik | Tum zaman cizelgelerinde gorunur, federe edilir |
+| `unlisted` | Listelenmemis | Profilde gorunur ama genel zaman cizelgesinde gorulmez |
+| `private` | Yalnizca takipciler | Sadece takipciler gorebilir, boost edilemez |
+| `direct` | Direkt mesaj | Yalnizca bahsedilen kullanicilar gorebilir |
+
+> NOT: `direct` gorunurluk aslinda bir DM sistemi degildir, bahsedilen kullanicilara gorunur bir gonderidir. Mastodon 4.x ile "Mentions" olarak yeniden adlandirilmistir.
+
+---
+
+## 4. URL Yapisi
+
+### 4.1. Instance URL Kaliplari
+
+Mastodon merkeziyetsiz oldugu icin her instance'in kendi domain'i vardir. Tum URL'ler instance domain'ine goredir.
+
+```
+https://{instance_domain}                           # Ana sayfa
+https://{instance_domain}/home                      # Ana zaman cizelgesi (giris yapilmis)
+https://{instance_domain}/public                    # Genel zaman cizelgesi (federe)
+https://{instance_domain}/public/local              # Yerel zaman cizelgesi
+https://{instance_domain}/public/remote             # Uzak zaman cizelgesi
+```
+
+### 4.2. Profil URL'leri
+
+```
+https://{instance_domain}/@{kullanici_adi}                        # Profil sayfasi
+https://{instance_domain}/@{kullanici_adi}/followers              # Takipciler
+https://{instance_domain}/@{kullanici_adi}/following              # Takip edilenler
+https://{instance_domain}/@{kullanici_adi}/with_replies           # Yanitlarla birlikte
+https://{instance_domain}/@{kullanici_adi}/media                  # Medya gonderileri
+https://{instance_domain}/@{kullanici_adi}/tagged/{etiket}        # Etiketli gonderiler
+```
+
+Uzak kullanicilar icin WebFinger adresi: `@kullanici@uzak_instance.com`
+
+### 4.3. Gonderi URL'leri
+
+```
+https://{instance_domain}/@{kullanici_adi}/{gonderi_id}           # Tek gonderi
+```
+
+### 4.4. Arama ve Kesif
+
+```
+https://{instance_domain}/search                    # Arama sayfasi
+https://{instance_domain}/explore                   # Kesfet (trendler)
+https://{instance_domain}/explore/tags              # Trend etiketler
+https://{instance_domain}/explore/links             # Trend baglantilar
+https://{instance_domain}/explore/posts             # Trend gonderiler
+https://{instance_domain}/tags/{etiket}             # Etiket sayfasi
+```
+
+### 4.5. Ayarlar ve Yonetim
+
+```
+https://{instance_domain}/settings/preferences      # Tercihler
+https://{instance_domain}/settings/profile          # Profil duzenleme
+https://{instance_domain}/settings/appearance        # Gorunum ayarlari
+https://{instance_domain}/settings/notifications     # Bildirim ayarlari
+https://{instance_domain}/settings/import           # Veri iceri aktarma
+https://{instance_domain}/settings/export           # Veri disi aktarma
+https://{instance_domain}/settings/applications     # OAuth uygulamalari
+https://{instance_domain}/settings/aliases          # Hesap takma adlari
+https://{instance_domain}/settings/migration        # Hesap tasima
+```
+
+### 4.6. Listeler, Filtreler, Yer Imleri
+
+```
+https://{instance_domain}/lists                     # Listeler
+https://{instance_domain}/lists/{liste_id}          # Tek liste
+https://{instance_domain}/bookmarks                 # Yer imleri
+https://{instance_domain}/favourites                # Begeniler
+https://{instance_domain}/filters                   # Filtreler
+https://{instance_domain}/mutes                     # Sessize alinanlar
+https://{instance_domain}/blocks                    # Engellenenler
+https://{instance_domain}/domain_blocks             # Engellenen alan adlari
+https://{instance_domain}/follow_requests           # Takip istekleri
+```
+
+### 4.7. Diger URL'ler
+
+```
+https://{instance_domain}/notifications             # Bildirimler
+https://{instance_domain}/conversations             # Direkt mesajlar
+https://{instance_domain}/about                     # Hakkinda sayfasi
+https://{instance_domain}/about/more                # Sunucu kurallari
+https://{instance_domain}/directory                 # Kullanici dizini
+https://{instance_domain}/invite                    # Davet linkleri
+```
+
+---
+
+## 5. Gorsel Boyutlari
+
+### 5.1. Gonderi Gorselleri
+
+| Tur | Onerilen Boyut | Aciklama |
+|-----|----------------|----------|
+| Gonderi gorseli (genel) | 1200 x 630 px | Open Graph uyumlu, en iyi on izleme |
+| Gonderi gorseli (kare) | 1080 x 1080 px | Instagram tarzinda |
+| Gonderi gorseli (dikey) | 1080 x 1350 px | Portre format |
+
+### 5.2. Profil Gorselleri
+
+| Tur | Onerilen Boyut | Aciklama |
+|-----|----------------|----------|
+| Profil resmi (avatar) | 400 x 400 px | Kare, daire olarak kirpilir |
+| Kapak resmi (header) | 1500 x 500 px | 3:1 oran |
+
+### 5.3. Dosya Boyut Limitleri (Varsayilan Instance Degerleri)
+
+| Tur | Max Boyut |
+|-----|-----------|
+| Resim | 16 MB |
+| Video | ~99 MB |
+| Animasyonlu GIF | 16 MB (resim olarak islenir) |
+
+> NOT: Bu degerler instance'a gore degisebilir. `GET /api/v2/instance` endpoint'inden guncel limitleri kontrol edin.
+
+---
+
+## 6. Rate Limiting (Hiz Sinirlamasi)
+
+### 6.1. Varsayilan Limitler
+
+| Kategori | Limit | Periyot |
+|----------|-------|---------|
+| Genel API (hesap basina) | 300 istek | 5 dakika |
+| Genel API (IP basina) | 300 istek | 5 dakika |
+| Medya yukleme (`POST /api/v1/media`) | 30 istek | 30 dakika |
+| Gonderi silme (`DELETE /api/v1/statuses/:id`) | 30 istek | 30 dakika |
+| Boost kaldirma (`POST /api/v1/statuses/:id/unreblog`) | 30 istek | 30 dakika |
+| Hesap olusturma (`POST /api/v1/accounts`) | 5 istek | 30 dakika (IP basina) |
+
+### 6.2. Yanit Basliklari (Response Headers)
+
+Her API yanitinda su basliklar bulunur:
+
+| Header | Aciklama |
+|--------|----------|
+| `X-RateLimit-Limit` | Periyot basina izin verilen toplam istek sayisi |
+| `X-RateLimit-Remaining` | Kalan istek sayisi |
+| `X-RateLimit-Reset` | Rate limit sifirlama zamani (ISO 8601 timestamp) |
+
+> NOT: Birden fazla limit uygulandiginda, basliklar en yakin oldugunuz limiti yansitir.
+
+### 6.3. Rate Limit Asildiginda
+
+- HTTP durum kodu: `429 Too Many Requests`
+- `X-RateLimit-Reset` basligindaki zamani bekleyin
+- Uygulama tarafinda exponential backoff stratejisi kullanin
+
+### 6.4. Gonderi Limitleri
+
+Instance'a gore degisir ancak tipik sinirlar:
+- Varsayilan karakter limiti: 500
+- URL basina ayrilmis karakter: 23 (URL'ler otomatik kisaltilir)
+- Gonderi basina medya: 4 adet
+- Sabitlenebilir gonderi: 5 adet
+- One cikarilan etiket: 10 adet
+
+---
+
+## 7. Icerik Turleri ve Ozellikler
+
+### 7.1. Metin Icerigi
+
+- **Gonderirken:** Duz metin (plain text) gonderilir
+- **API yanitlarinda:** HTML formatinda doner (`<p>`, `<a>`, `<br>` vb.)
+- **Kaynakta:** `GET /api/v1/statuses/:id/source` ile ham metin alinabilir
+- Bahsetmeler (`@kullanici@instance`) otomatik olarak baglantiya donusturulur
+- Etiketler (`#etiket`) otomatik olarak baglantiya donusturulur
+- URL'ler otomatik olarak baglantiya donusturulur
+
+### 7.2. Icerik Uyarisi (Content Warning / Spoiler Text)
+
+- `spoiler_text` parametresi ile ayarlanir
+- Ayarlandiginda gonderi icerigi varsayilan olarak gizlenir
+- Kullanici "Devamini Goster" / "Show More" butonuyla acabilir
+- `sensitive` parametresi medya icin ayri bir uyari ekler
+
+### 7.3. Anketler (Polls)
+
+Gonderi olusturma sirasinda anket parametreleri:
+
+| Parametre | Tip | Aciklama |
+|-----------|-----|----------|
+| `poll[options][]` | Array | Secenek metinleri (min 2) |
+| `poll[expires_in]` | Integer | Sure (saniye, min 300) |
+| `poll[multiple]` | Boolean | Coklu secim |
+| `poll[hide_totals]` | Boolean | Bitmeden toplami gizle |
+
+### 7.4. Medya Ekleri
+
+- Gonderi basina en fazla 4 medya eki
+- Medya ve anket ayni gonderide kullanilamaz
+- Oncelikle medya yuklenir (`POST /api/v2/media`), sonra `media_ids[]` ile gonderiye eklenir
+- Her medya icin `description` (alt text) eklenebilir (erisebilirlik icin onemli)
+- `focus` parametresi kirpma odak noktasini belirler
+
+### 7.5. Emoji
+
+- Unicode emoji standart olarak desteklenir
+- Instance'a ozel ozel emoji (custom emoji) `:emoji_adi:` sozdizimi ile kullanilir
+- Ozel emojiler instance'a gore degisir
+- `GET /api/v1/custom_emojis` endpoint'i ile mevcut emojiler listelenebilir
+
+---
+
+## 8. Instance Farkliliklari
+
+### 8.1. Karakter Limitleri
+
+| Instance Tipi | Karakter Limiti |
+|---------------|-----------------|
+| Varsayilan Mastodon | 500 |
+| Glitch-soc (fork) | Genellikle 5000+ |
+| Hometown (fork) | Yapilandirmaya bagli |
+| Bazi buyuk instance'lar | 1000-65535 arasi |
+
+> ONEMLI: Karakter limitini `GET /api/v2/instance` endpoint'inden `configuration.statuses.max_characters` alaniyla kontrol edin. Hardcoded 500 varsaymak hatadir.
+
+### 8.2. Instance Tespiti ve Konfigurasyonu
+
+Otomasyon araci icin instance'a baglanirken ilk adim:
+
+```
+GET /api/v2/instance
+```
+
+Bu endpoint'ten alinacak kritik bilgiler:
+- `configuration.statuses.max_characters` - Karakter limiti
+- `configuration.statuses.characters_reserved_per_url` - URL basina ayrilan karakter
+- `configuration.media_attachments.supported_mime_types` - Desteklenen medya turleri
+- `configuration.media_attachments.image_size_limit` - Resim boyut limiti
+- `configuration.media_attachments.video_size_limit` - Video boyut limiti
+- `configuration.media_attachments.image_matrix_limit` - Resim piksel limiti
+- `configuration.media_attachments.video_matrix_limit` - Video piksel limiti
+- `configuration.polls.max_options` - Anket secenegi limiti
+- `configuration.polls.max_characters_per_option` - Secenek karakter limiti
+- `configuration.polls.min_expiration` - Min anket suresi
+- `configuration.polls.max_expiration` - Max anket suresi
+- `configuration.accounts.max_pinned_statuses` - Sabitlenebilir gonderi limiti
+
+### 8.3. Mastodon Uyumlu Diger Yazilimlar
+
+Mastodon API'si su platformlar tarafindan da (kismi olarak) desteklenir:
+- **Pleroma / Akkoma** - Daha hafif, ek ozellikler
+- **Misskey / Calckey / Firefish** - Kismi Mastodon API uyumlulugu
+- **GoToSocial** - Go ile yazilmis, kismi uyumluluk
+- **Pixelfed** - Gorsel odakli, kismi uyumluluk
+
+Bu platformlarda Mastodon API'si calissa bile bazi farkliliklar olabilir. Instance yazilimini `GET /api/v2/instance` yanitindaki bilgilerden tespit edebilirsiniz.
+
+### 8.4. Ozel Ozellikler
+
+- **Ozel emoji:** Her instance kendi emoji setini tanimlar
+- **Sunucu kurallari:** Her instance'in kendi icerik politikalari vardir
+- **Moderasyon:** Instance yoneticileri alan adlarini engelleyebilir
+- **Kayit:** Acik, onay gerektiren veya kapali olabilir
+- **Minimum yas:** Varsayilan 16 (instance'a gore degisebilir)
+
+---
+
+## 9. API Kullanim Kaliplari (Otomasyon Icin)
+
+### 9.1. Gonderi Olusturma Akisi
+
+```
+1. (Opsiyonel) Medya yukle: POST /api/v2/media -> media_id al
+2. (Opsiyonel) Medya islenmesini bekle: GET /api/v1/media/:id (200 donene kadar)
+3. Gonderi olustur: POST /api/v1/statuses (status + media_ids)
+```
+
+### 9.2. Begeni/Boost Akisi
+
+```
+1. Gonderiyi bul: GET /api/v2/search veya GET /api/v1/timelines/*
+2. Begen: POST /api/v1/statuses/:id/favourite
+3. Boost: POST /api/v1/statuses/:id/reblog
+```
+
+### 9.3. Takip Akisi
+
+```
+1. Hesabi bul: GET /api/v1/accounts/lookup?acct=kullanici@instance
+   veya: GET /api/v1/accounts/search?q=kullanici
+2. Takip et: POST /api/v1/accounts/:id/follow
+3. (Kilitli hesapsa) Takip istegi otomatik gonderilir, onay beklenir
+```
+
+### 9.4. Zaman Cizelgesi Izleme
+
+```
+1. Ilk yukle: GET /api/v1/timelines/home?limit=40
+2. Yeni gonderiler: GET /api/v1/timelines/home?min_id={son_gonderi_id}
+   veya: Streaming API ile canli izle (GET /api/v1/streaming/user)
+```
+
+### 9.5. Sayfalama (Pagination)
+
+Mastodon API'si cursor tabanli sayfalama kullanir:
+- `max_id`: Belirtilen ID'den onceki sonuclari dondurur (geriye dogru)
+- `since_id`: Belirtilen ID'den sonraki sonuclari dondurur (onemli: en yeniden eskilere)
+- `min_id`: Belirtilen ID'den sonraki sonuclari dondurur (eskiden yeniye, ileri sayfalama)
+- `limit`: Sayfa basina sonuc sayisi
+
+Sayfalama linkleri HTTP `Link` header'inda doner:
+```
+Link: <https://instance/api/v1/timelines/home?max_id=123>; rel="next",
+      <https://instance/api/v1/timelines/home?min_id=456>; rel="prev"
+```
+
+### 9.6. Hata Yonetimi
+
+| HTTP Kodu | Anlami | Aksiyon |
+|-----------|--------|---------|
+| 200 | Basarili | - |
+| 202 | Kabul edildi (asenkron isleme) | Islemenin tamamlanmasini bekleyin |
+| 206 | Kismi icerik (medya isleniyor) | Tekrar deneyin |
+| 401 | Yetkisiz | Token'i yenileyin |
+| 403 | Yasakli | Izin kontrol edin |
+| 404 | Bulunamadi | ID'yi kontrol edin |
+| 422 | Dogrulama hatasi | Parametreleri kontrol edin |
+| 429 | Rate limit asildi | `X-RateLimit-Reset`'e kadar bekleyin |
+| 503 | Servis kullanilamiyor | Daha sonra tekrar deneyin |
+
+---
+
+## 10. Ornek API Istekleri
+
+### Gonderi Olusturma
+
+```bash
+curl -X POST https://mastodon.social/api/v1/statuses \
+  -H "Authorization: Bearer ACCESS_TOKEN" \
+  -d "status=Merhaba Mastodon!" \
+  -d "visibility=public"
+```
+
+### Resimli Gonderi
+
+```bash
+# 1. Resim yukle
+MEDIA_ID=$(curl -X POST https://mastodon.social/api/v2/media \
+  -H "Authorization: Bearer ACCESS_TOKEN" \
+  -F "file=@resim.jpg" \
+  -F "description=Resim aciklamasi" \
+  | jq -r '.id')
+
+# 2. Gonderi olustur
+curl -X POST https://mastodon.social/api/v1/statuses \
+  -H "Authorization: Bearer ACCESS_TOKEN" \
+  -d "status=Resimli gonderi" \
+  -d "media_ids[]=$MEDIA_ID"
+```
+
+### Anketli Gonderi
+
+```bash
+curl -X POST https://mastodon.social/api/v1/statuses \
+  -H "Authorization: Bearer ACCESS_TOKEN" \
+  -d "status=En sevdiginiz programlama dili?" \
+  -d "poll[options][]=Python" \
+  -d "poll[options][]=JavaScript" \
+  -d "poll[options][]=Rust" \
+  -d "poll[expires_in]=86400"
+```
+
+### Zamanlanmis Gonderi
+
+```bash
+curl -X POST https://mastodon.social/api/v1/statuses \
+  -H "Authorization: Bearer ACCESS_TOKEN" \
+  -d "status=Bu gonderi gelecekte yayinlanacak" \
+  -d "scheduled_at=2026-03-15T10:00:00.000Z"
+```
+
+### Icerik Uyarili Gonderi
+
+```bash
+curl -X POST https://mastodon.social/api/v1/statuses \
+  -H "Authorization: Bearer ACCESS_TOKEN" \
+  -d "status=Spoiler icerigi burada" \
+  -d "spoiler_text=Dikkat: Spoiler iceriyor" \
+  -d "sensitive=true"
+```
+
+---
+
+## 11. Onemli Notlar
+
+1. **Instance URL'si degiskendir:** Her Mastodon sunucusu farkli bir domain kullanir. API isteklerinde base URL olarak kullanicinin instance URL'si kullanilmalidir.
+
+2. **Karakter limiti sabit degildir:** Varsayilan 500 olsa da instance'a gore degisir. Her zaman `GET /api/v2/instance` ile kontrol edin.
+
+3. **Federation gecikmeleri:** Bir instance'taki gonderi diger instance'lara aninda ulasmayabilir. Federation islemleri asenkrondur.
+
+4. **Medya isleme asenkrondur:** `POST /api/v2/media` 202 donerse, medya henuz hazir degildir. `GET /api/v1/media/:id` ile 200 donene kadar kontrol edin, ancak gonderiye 202 durumunda bile ekleyebilirsiniz.
+
+5. **API ucretsizdir:** Twitter/X aksine Mastodon API tamamen ucretsizdir. Yalnizca rate limit kisitlamasi vardir.
+
+6. **Gonderi duzenleme destegi:** Mastodon 4.0+ surumlerinde gonderiler duzenlenebilir. Duzenleme gecmisi saklanir.
+
+7. **Boost gorunurlugu:** Private gonderiler boost edilemez. Boost sirasinda `visibility` parametresi ile gorunurluk daraltilabilir (ornegin public gonderiyi unlisted olarak boost etmek).
+
+8. **Direct mesaj guvenligi:** `direct` gorunurluklu gonderiler uctan uca sifrelenmis degildir. Instance yoneticileri icerigine erisebilir.
+
+9. **Sayfalama icin Link header kullanin:** Bazi endpoint'lerde (favourites, bookmarks) icerik ID'leri yanit govdesinde gosterilmez. Sayfalama icin her zaman HTTP `Link` header'ini parse edin.
+
+10. **PKCE destegi:** Guvenli OAuth akislari icin PKCE (S256) kullanilmasi onerilir.