Makroskop'un API merkezi. Bu sayfa hem doküman hem test arayüzü: her servisi buradan, gerçek sunucuya karşı deneyebilirsin. Mesajlar WebSocket (Phoenix Channels) üzerinden akar; geri kalan her şey REST.
access_token değişkenini doldurman yeterli.
https://mskop-api.gurerlabs.com
# 1) Uygulama GlobalTrustID'den (OIDC + PKCE) aldığı kodu token'a çevirir
curl -X POST https://mskop-api.gurerlabs.com/api/auth/globaltrustid \
-H "Content-Type: application/json" \
-d '{"code": "GTID_KODU", "code_verifier": "PKCE_VERIFIER", "redirect_uri": "REDIRECT_URI"}'
# 2) Dönen access_token ile istek at
curl https://mskop-api.gurerlabs.com/api/me -H "Authorization: Bearer $ACCESS_TOKEN"
# 3) 401 token_expired gelince yenile (eski refresh token o an biter)
curl -X POST https://mskop-api.gurerlabs.com/api/auth/refresh \
-H "Content-Type: application/json" \
-d '{"refresh_token": "REFRESH_TOKEN"}'
Korunan servisler Authorization: Bearer <access_token> başlığı ister. Giriş yalnızca GlobalTrustID ile yapılır; parola yoktur. Access token 1 saat yaşar, süresi dolunca refresh token ile yeni bir çift alınır.
Uygulama GlobalTrustID'ye karşı OIDC authorization code + PKCE akışını yürütür, dönen kodu POST /api/auth/globaltrustid'ye yollar; access + refresh token döner.
İlk girişte account.username boştur. PUT /api/me/username ile seçilene kadar odalar ve socket 403 username_required döner.
401 token_expired gelince POST /api/auth/refresh ile yeni çift alınır; eski refresh token o an biter.
POST /api/auth/logout oturumu kapatır ve o cihaza push gönderimini durdurur.
Backend GlobalTrustID'den gelen kimliği saklamaz; hesabı yalnızca tek yönlü bir parmak iziyle bulur. Aynı kişi her cihazda aynı hesaba düşer: ilk giriş 201, sonrakiler 200 döner.
Refresh token yanıt gövdesinde döner ve 90 gün geçerlidir; Keychain / Keystore gibi güvenli depoda saklanmalı. Her kullanımda yenisiyle değişir, eskisi tekrar kullanılamaz.
Tüm hatalar aynı biçimde döner. İstemci mantığı her zaman code alanına bakmalı; message insan için yazılmıştır ve değişebilir. fields yalnızca 422 validation_failed yanıtında bulunur. Her yanıtta x-request-id başlığı vardır; destek isterken bunu ilet.
{"error":{"code":"validation_failed","fields":{"slug":["lowercase letters, digits and '-' only"]},"message":"Some fields are invalid."}}
| code | HTTP | Anlamı |
|---|---|---|
| invalid_request | 400 | Eksik ya da geçersiz parametre |
| unauthorized | 401 | Authorization başlığı yok ya da geçersiz |
| token_expired | 401 | Access token'ın süresi dolmuş: /api/auth/refresh çağır |
| invalid_refresh_token | 401 | Refresh token geçersiz ya da kullanılmış; tekrar giriş gerekir |
| star_required | 402 | Oda yıldızla açılıyor |
| insufficient_stars | 402 | Yıldız bakiyesi yetmiyor |
| username_required | 403 | Önce rumuz seçilmeli (PUT /api/me/username) |
| not_member | 403 | Odanın üyesi değilsin |
| not_admin | 403 | Bu işlem odanın yöneticisine ait |
| not_allowed | 403 | Gereken oda yetkisi yok |
| banned | 403 | Bu odadan engellendin |
| dm_closed | 403 | Kişi birebir mesaja kapalı |
| not_found | 404 | Kayıt ya da yol yok |
| room_not_found | 404 | Oda yok |
| founder_protected | 409 | Kurucuya bu işlem uygulanamaz |
| validation_failed | 422 | Alanlar geçersiz; ayrıntı fields içinde |
| rate_limited | 429 | Hız sınırı aşıldı; biraz bekleyip tekrar dene |
| gtid_unavailable | 502 | GlobalTrustID'ye ulaşılamadı |
| internal_error | 500 | Beklenmeyen hata; x-request-id ile bildir |
Limitler sabit pencereyle uygulanır ve aşılınca 429 rate_limited döner. Yanıtlarda X-RateLimit-* ya da Retry-After başlığı yoktur; 429 alan istemci birkaç saniye bekleyip tekrar denemelidir.
/api/auth/*
IP başına dakikada 20 istek
GET /api/link-preview
Hesap başına dakikada 60 istek (önbellekten dönenler de sayılır)
POST /api/analytics/events
Hesap başına dakikada 30 paket
socket · message:new
Hesap başına 10 saniyede 20 mesaj; gövde en fazla 16 KB
socket · komutlar
Hesap + oda + komut başına dakikada 5 (/mute, /ban…)
PATCH /api/panel/organization
Slug değişikliği: organizasyon başına günde 10
/api/health
Veritabanı (Postgres), Redis ve dosya deposunun (MinIO) durumunu döner. Postgres ya da Redis cevap vermezse 503 ve status: "degraded" döner; MinIO raporlanır ama tek başına hataya yol açmaz (sohbet medyasız da çalışır). Rate limit uygulanmaz; izleme ve yük dengeleyiciler için uygundur.
status: "degraded")curl https://mskop-api.gurerlabs.com/api/health
/api/usernames/available
Rumuz seçme ekranında yazarken çağrılır. Karşılaştırma büyük/küçük harf duyarsızdır. Geçersiz biçimdeki ya da ayrılmış (makroskop) rumuzlar için de available: false döner.
username
string
query
zorunlu
Denenecek rumuz
username verilmedi (invalid_request)curl https://mskop-api.gurerlabs.com/api/usernames/available?username=osman
Bu gruptaki tüm servisler IP başına dakikada 20 istekle sınırlıdır ve token istemez.
/api/auth/globaltrustid
Uygulama GlobalTrustID'ye karşı OIDC authorization code + PKCE akışını kendisi yürütür (scope=openid profile) ve dönen kodu buraya yollar. Backend kodu kendi client secret'ı ile token'a çevirir, id_token'ı GlobalTrustID'nin JWKS'i ile doğrular (imza, iss, aud, exp). Hesap yoksa açılır (201), varsa aynı hesaba girilir (200).
birthdate ve gender saklanır; başka hiçbir claim tutulmaz.account.username null gelir: uygulama rumuz seçme ekranına gitmeli.code
string
body
zorunlu
GlobalTrustID'nin döndürdüğü authorization code
redirect_uri
string
body
zorunlu
Akışta kullanılan redirect URI; GlobalTrustID'de kayıtlı olanla aynı olmalı
code_verifier
string
body
zorunlu
PKCE doğrulayıcısı
nonce
string
body
isteğe bağlı
Akışta nonce gönderildiyse aynısı
accountaccountcode ya da redirect_uri yok (invalid_request)gtid_rejected) ya da id_token doğrulanamadı (invalid_id_token)gtid_unavailable)gtid_not_configured)curl -X POST https://mskop-api.gurerlabs.com/api/auth/globaltrustid \
-H "Content-Type: application/json" \
-d '{"code":"GTID_KODU","code_verifier":"PKCE_VERIFIER","redirect_uri":"REDIRECT_URI"}'/api/auth/refresh
Refresh token ile yeni bir access + refresh çifti alır. Refresh token tek kullanımlıktır: bu çağrıdan sonra eskisi çalışmaz, yanıttaki yenisi saklanmalı. Yanıtta account yoktur.
refresh_token
string
body
zorunlu
Girişte ya da son yenilemede dönen refresh token
refresh_token yok (invalid_request)invalid_refresh_token): tekrar giriş gerekircurl -X POST https://mskop-api.gurerlabs.com/api/auth/refresh \
-H "Content-Type: application/json" \
-d '{"refresh_token":"REFRESH_TOKEN"}'/api/auth/logout
Refresh token'ın ait olduğu oturumu kapatır ve o cihaza push gönderimini durdurur. Bilinmeyen ya da zaten kapanmış bir token için de 204 döner; yanıt token'ın varlığını sızdırmaz.
refresh_token
string
body
zorunlu
Kapatılacak oturumun refresh token'ı
curl -X POST https://mskop-api.gurerlabs.com/api/auth/logout \
-H "Content-Type: application/json" \
-d '{"refresh_token":"REFRESH_TOKEN"}'Giriş yapmış kişinin kendi hesabı. Bu gruptaki servisler yalnız geçerli bir access token ister; rumuz seçilmemiş hesap da çağırabilir, çünkü rumuz seçme ekranı (onboarding) bunlarla çalışır. Hesap döndüren her uç (GET /api/me, rumuz ve profil güncellemesi) aynı tam nesneyi verir; istemcinin kısa bir yanıtı elindekiyle birleştirmesi gerekmez.
/api/me
Token sahibinin hesabını; birincil profil fotoğrafı (avatar), takip sayıları (follows) ve yıldız bakiyesi (stars) ile birlikte döner. Uygulama açılışta ve girişten sonra çağırır; username null ise rumuz seçme ekranına gidilmelidir.
birth_date (YYYY-MM-DD) ve gender GlobalTrustID'nin doğruladığı değerlerdir ve yalnız burada döner; başkasının profil kartında hiçbir zaman yer almaz.created_at ve avatar.created_at ISO-8601 metindir. avatar.url ve avatar.thumb_url 1 saat geçerli presigned linklerdir.{account}unauthorized) veya süresi dolmuş (token_expired)curl https://mskop-api.gurerlabs.com/api/me \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/me/username
Onboarding'in son adımı; rumuz sonradan da değiştirilebilir. Değer kırpılır (trim), büyük/küçük harf duyarsız olarak tekil olmalıdır. Rumuz seçilene kadar odalar, kişiler, yüklemeler ve socket bağlantısı 403 username_required döner; seçildiği an aynı token ile hepsi açılır.
GET /api/usernames/available kullanın; kesin karar bu çağrının yanıtıdır (iki kişi aynı anda aynı rumuzu deneyebilir).makroskop ayrılmış bir addır ve her yazımı is taken hatası verir.username
string
body
zorunlu
3–24 karakter: harf (Türkçe dahil), rakam, _ ya da . (^[\p{L}\p{N}_.]{3,24}$)
GET /api/me ile aynı {account}username yok ya da metin değil (invalid_request)unauthorized) veya süresi dolmuş (token_expired)validation_failed: fields.username biçim hatası için "3-24 characters: letters, digits, '_' or '.'", alınmış ya da ayrılmış ad için "is taken"curl -X PUT https://mskop-api.gurerlabs.com/api/me/username \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"username":"osman"}'/api/me/profile
Profilin kişiye ait kısmını günceller: biyografi, kimin birebir yazabileceği, fotoğrafı kimin göreceği ve ilgi alanına göre sponsorlu içerik. Bütün alanlar isteğe bağlıdır; gönderilmeyen alan olduğu gibi kalır. Yanıt GET /api/me ile aynı tam hesaptır.
personalized_ads false yapıldığı anda ilgi profili silinir, davranış olayları artık saklanmaz ve yalnız hedefsiz sponsorlu içerik gösterilir.dm_policy ve dm_star_cost yalnız yeni açılacak birebir sohbetleri etkiler; var olan sohbete dönmek her zaman serbest ve ücretsizdir.hidden_profile saklanır ama bugün hiçbir şeyi gizlemez (kullanıcı araması ucu henüz yok); arama geldiğinde ilk kuralı bu olacak.bio
string
body
isteğe bağlı
Profil yazısı; kırpıldıktan sonra en çok 200 karakter. null siler
dm_policy
string
body
isteğe bağlı
Kim birebir sohbet açabilir: open (herkes) · closed (kimse) · paid (dm_star_cost yıldız karşılığında)
dm_star_cost
integer
body
isteğe bağlı
Birebir sohbet açmanın yıldız bedeli, 0–100000. dm_policy paid ise 0'dan büyük olmalı
photo_visibility
string
body
isteğe bağlı
Fotoğrafı kim görür: everyone (herkes) · followers (taraflardan biri diğerini takip ediyorsa) · nobody (yalnız kendisi)
hidden_profile
boolean
body
isteğe bağlı
Aramalarda görünmeme tercihi (henüz etkisi yok)
personalized_ads
boolean
body
isteğe bağlı
İlgi alanlarına göre sponsorlu içerik. null gönderilemez
GET /api/me ile aynı {account}unauthorized) veya süresi dolmuş (token_expired)validation_failed: geçersiz değer, 200 karakteri aşan bio, paid iken 0 olan dm_star_cost ("must be more than 0 stars") ya da null personalized_adscurl -X PUT https://mskop-api.gurerlabs.com/api/me/profile \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"bio":"Fenerbahçe, kahve ve uzun yürüyüşler.","dm_policy":"paid","dm_star_cost":5,"photo_visibility":"followers"}'/api/me/stars
Yıldız bakiyesini ve son 50 hareketi (yeniden eskiye) döner. Bakiye, hareketlerin toplamıdır; delta pozitifse kazanç, negatifse harcamadır.
reason değerleri: dm_open (ücretli birebir sohbet açmak: açandan düşer, karşı tarafa yazılır) ve room_vanity_link (odaya kısa link almak; related_room o odadır). İstemci bilmediği bir reason'ı genel bir satır olarak göstermelidir.created_at ISO-8601 metindir.{balance, entries}unauthorized) veya süresi dolmuş (token_expired)curl https://mskop-api.gurerlabs.com/api/me/stars \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/me/rooms
Profil sayfasındaki sekmeler için: kişinin kurduğu gruplar (founded) ve kurmadan yönettiği gruplar (administered). Her iki liste de ada göre sıralıdır ve yalnız grup odalarını içerir; birebir sohbetler burada yer almaz.
avatar alanında gelir (yoksa null). my_role, member_count gibi bağlama bağlı alanlar bu yanıtta yoktur.{founded, administered}unauthorized) veya süresi dolmuş (token_expired)curl https://mskop-api.gurerlabs.com/api/me/rooms \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/me/followers
Beni takip edenler, en yeni takip başta. En çok 200 kişi döner; sayfalama yoktur. Toplam sayı için GET /api/me içindeki follows.followers kullanılır.
followed_at ISO-8601 metindir.{people}unauthorized) veya süresi dolmuş (token_expired)curl https://mskop-api.gurerlabs.com/api/me/followers \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/me/following
Benim takip ettiklerim, en yeni takip başta. En çok 200 kişi döner; sayfalama yoktur. Toplam sayı için GET /api/me içindeki follows.following kullanılır.
{people}unauthorized) veya süresi dolmuş (token_expired)curl https://mskop-api.gurerlabs.com/api/me/following \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/me
Hesabı geri alınamaz biçimde kapatır. GlobalTrustID ile açılmış hesap, hâlâ kendisi olduğunu kanıtlamak için gövdede aynı kimlikten alınmış taze bir GlobalTrustID kodu göndermelidir (giriş akışı yeniden yürütülür). Silindiği an hesabın bütün cihazlarındaki socket bağlantıları düşürülür.
room:gone, odaya room:deleted gider.sender.account_id null olur.code
string
body
zorunlu
Aynı kimlik için yeniden yürütülen giriş akışından gelen authorization code
redirect_uri
string
body
zorunlu
Akışta kullanılan redirect URI
code_verifier
string
body
zorunlu
PKCE doğrulayıcısı
nonce
string
body
isteğe bağlı
Akışta nonce gönderildiyse aynısı
code ya da redirect_uri yok (invalid_request)gtid_rejected), id_token doğrulanamadı ya da kod başka bir kimliğe ait (invalid_id_token), veya access token geçersiz (unauthorized / token_expired)gtid_unavailable)gtid_not_configured)curl -X DELETE https://mskop-api.gurerlabs.com/api/me \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"code":"GTID_KODU","code_verifier":"PKCE_VERIFIER","redirect_uri":"REDIRECT_URI"}'Bu çağrı taze bir GlobalTrustID kodu ister ve hesabı geri dönüşü olmayan biçimde siler; sayfadan denenmez.
Hesabın kare (1:1) fotoğrafları. Bir hesabın birden çok fotoğrafı olabilir, biri "yüz"dür (is_primary): GET /api/me ve başkalarının gördüğü profil kartı avatar alanında onu verir. Backend dosya baytı taşımaz; yükleme üç adımdır: (1) POST /api/me/avatars/presign iki presigned PUT linki verir: full (1:1 orijinal) ve thumb (cihazın önbelleğe alacağı küçük kopya); (2) uygulama kareyi kırpar, küçük kopyayı kendisi üretir ve iki dosyayı bu linklere doğrudan PUT eder (MinIO, 10 dakika geçerli, Authorization başlığı gönderilmez); (3) POST /api/me/avatars dönen iki key ile fotoğrafı kaydeder. Bu gruptaki servisler yalnız geçerli token ister; rumuz seçilmemiş hesap da fotoğraf yükleyebilir.
/api/me/avatars
Hesabın bütün fotoğraflarını döner: yüz olan başta, ardından yeniden eskiye. Fotoğraf yoksa liste boştur.
url ve thumb_url 1 saat geçerli presigned GET linkleridir. Uygulama küçük kopyanın baytını yerelde saklayıp önce onu çizmeli; süresi dolmuş link boş avatar değil, bir tazeleme demektir.created_at ISO-8601 metindir.{avatars}unauthorized) veya süresi dolmuş (token_expired)curl https://mskop-api.gurerlabs.com/api/me/avatars \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/me/avatars/presign
Yüklemenin 1. adımı: aynı fotoğrafın orijinali ve küçük kopyası için iki presigned PUT linki üretir. Linkler 600 saniye geçerlidir; iki dosya da avatars/{account_id}/ altına, content_type'a uygun uzantıyla yazılır. Bu çağrı kayıt oluşturmaz: dosyalar yüklendikten sonra POST /api/me/avatars ile kaydedilmelidir.
PUT ederken Content-Type başlığını burada seçilen türle gönderin; MinIO isteğine Authorization başlığı eklenmez, imza URL'nin içindedir.content_type
string
body
isteğe bağlı
image/jpeg (varsayılan) · image/webp · image/png
{content_type, full, thumb}content_type (invalid_request)unauthorized) veya süresi dolmuş (token_expired)curl -X POST https://mskop-api.gurerlabs.com/api/me/avatars/presign \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"content_type":"image/jpeg"}'/api/me/avatars
Yüklemenin 3. adımı: presign yanıtındaki full.key ve thumb.key ile fotoğrafı hesaba kaydeder. Hesabın ilk fotoğrafı ve primary: false denmeden eklenen her fotoğraf yüz olur; eski yüz aynı işlemde yüz olmaktan çıkar. Yeni fotoğraf yüz olduysa bağlı olan herkese socket üzerinden account:avatar duyurulur.
avatars/{account_id}/) başlamalıdır; başkasının dosyası kaydedilemez.PUT tamamlanmalı, sonra bu çağrı yapılmalıdır.key
string
body
zorunlu
Presign yanıtındaki full.key
thumb_key
string
body
zorunlu
Presign yanıtındaki thumb.key
content_type
string
body
isteğe bağlı
image/jpeg (varsayılan) · image/webp · image/png
byte_size
integer
body
isteğe bağlı
Orijinal dosyanın boyutu (bayt); 1 ile 8388608 (8 MiB) arası
size_px
integer
body
isteğe bağlı
Karenin kenar uzunluğu (piksel); 1 ile 4096 arası
primary
boolean
body
isteğe bağlı
Yüz yapılsın mı; varsayılan true. false ise mevcut yüz korunur (hesabın ilk fotoğrafı yine de yüz olur)
{avatar}unauthorized) veya süresi dolmuş (token_expired)validation_failed: key/thumb_key eksik ya da bu hesabın değil ("must be this account's own upload"), desteklenmeyen content_type, sınır dışı byte_size/size_pxcurl -X POST https://mskop-api.gurerlabs.com/api/me/avatars \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"byte_size":118432,"content_type":"image/jpeg","key":"avatars/f6cad462-3b1e-4d6a-9a77-2c1e0b8f4d21/c94e1b07-2d58-4a3f-8b6e-1f0a7d3c5e92.jpg","primary":true,"size_px":1024,"thumb_key":"avatars/f6cad462-3b1e-4d6a-9a77-2c1e0b8f4d21/c94e1b07-2d58-4a3f-8b6e-1f0a7d3c5e92-thumb.jpg"}'/api/me/avatars/{id}/primary
Hesabın fotoğraflarından birini yüz yapar; önceki yüz aynı işlemde yüz olmaktan çıkar. Değişiklik bağlı olan herkese socket üzerinden account:avatar ile duyurulur, böylece sohbet listeleri ve mesaj satırları yeni fotoğrafı hemen çizer.
id
uuid
path
zorunlu
Fotoğrafın id'si (GET /api/me/avatars)
{avatar} (artık is_primary: true)unauthorized) veya süresi dolmuş (token_expired)id UUID değil (not_found)curl -X PUT https://mskop-api.gurerlabs.com/api/me/avatars/e04b7d92-1a6c-4f58-b3e7-9d2c8a5f1b46/primary \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/me/avatars/{id}
Fotoğrafı ve depodaki iki dosyasını (orijinal ve küçük kopya) siler. Silinen yüzse en yeni fotoğraf yüz olur; son fotoğraf silindiyse hesabın yüzü kalmaz. Ardından güncel yüz (ya da null) bağlı olan herkese account:avatar ile duyurulur.
id
uuid
path
zorunlu
Silinecek fotoğrafın id'si
unauthorized) veya süresi dolmuş (token_expired)id UUID değil (not_found)curl -X DELETE https://mskop-api.gurerlabs.com/api/me/avatars/e04b7d92-1a6c-4f58-b3e7-9d2c8a5f1b46 \ -H "Authorization: Bearer $ACCESS_TOKEN"
Her oturum bir cihazdır: cihazın ne olduğu ve push adresi access token'ın taşıdığı oturuma yazılır, hesaba değil. Aynı kişinin iki telefonu iki ayrı kayıttır. Bu gruptaki servisler yalnız geçerli token ister; rumuz seçilmemiş hesap da çağırabilir.
/api/me/device
Cihaz kendini tanıtır ve (varsa) push adresini bildirir. Uygulama her açılışta, push token yenilendiğinde ve dil değiştiğinde gönderir; çağrı idempotenttir. Yalnız platform zorunludur: token alamayan cihaz (iOS simülatörü, bildirime izin vermeyen kullanıcı) da kendini tanıtabilir. Gönderilmeyen alan olduğu gibi kalır; push_token göndermemek "token'a dokunma" demektir, silmek DELETE /api/me/device'ın işidir.
push_token başka bir oturumda kayıtlıysa (yeniden kurulum, ağsız çıkış, aynı telefonda başka hesap) oradan alınıp bu oturuma taşınır; bir cihaz başka hesabın bildirimini almaz.push_env gönderilmeden yeni bir push_token gelirse token production sayılır; önceki token'ın değeri taşınmaz.{type, room_slug, message_id} gider (type: message ya da mention). Mesaj metni, oda adı ve gönderen Google'a ya da Apple'a gönderilmez; görünen metni uygulama kendi önbelleğinden üretir. Sessize alınmış odalar push üretmez.401 token_expired döner: token yenilenip çağrı tekrarlanmalıdır.platform
string
body
zorunlu
android · ios · web_app · web_integration. Push'un hangi servise gideceğini belirler: ios → APNs, diğerleri → FCM. Son ikisini bugün hiçbir istemci göndermez
push_token
string
body
isteğe bağlı
Android: FCM registration token. iOS: APNs device token (hex). 1–4096 bayt; boş metin 400 döner
push_env
string
body
isteğe bağlı
Yalnız iOS: sandbox (Xcode/simülatör derlemesi) · production (App Store, TestFlight). Varsayılan production
device_model
string
body
isteğe bağlı
Android Build.MODEL, iOS makine kimliği (iPhone16,2). Kırpılır, en çok 64 karakter; boş metin "söylenmedi" sayılır
device_manufacturer
string
body
isteğe bağlı
Android Build.MANUFACTURER, iOS Apple. Kırpılır, en çok 64 karakter
is_emulator
boolean
body
isteğe bağlı
Emülatör/simülatör mü. Gerçek true/false olmalı; "true" metni 400 döner. Göndermemek false ile aynı değildir (söylenmedi)
language
string
body
isteğe bağlı
Uygulamanın bu cihazda çalıştığı dil: tr · en. Duyurular dile göre gönderilir; oturumda tutulur, hesapta değil
app_version
string
body
isteğe bağlı
Uygulama sürümü. Kırpılır, en çok 64 karakter
os_version
string
body
isteğe bağlı
İşletim sistemi sürümü (Android 14, iOS 18.0). Kırpılır, en çok 64 karakter
platform yok ya da listede değil, veya herhangi bir alan geçersiz (invalid_request)unauthorized), süresi dolmuş ya da oturum kimliği taşımıyor (token_expired)not_found)curl -X PUT https://mskop-api.gurerlabs.com/api/me/device \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"app_version":"1.4.0 (52)","device_manufacturer":"Google","device_model":"Pixel 8","is_emulator":false,"language":"tr","os_version":"14","platform":"android","push_token":"FCM_TOKEN"}'/api/me/device
Bu oturumun push token'ını siler; cihaz bildirim almayı bırakır, platform ve model bilgisi kalır. Kullanıcı bildirimleri kapattığında çağrılır. Çıkış (POST /api/auth/logout) bunu zaten yapar.
unauthorized), süresi dolmuş ya da oturum kimliği taşımıyor (token_expired)curl -X DELETE https://mskop-api.gurerlabs.com/api/me/device \ -H "Authorization: Bearer $ACCESS_TOKEN"
Başka hesaplar: profil kartı, takip ilişkisi ve birebir sohbet (DM). Kişiler rumuzla adreslenir ve rumuz büyük/küçük harf duyarsızdır. Bu gruptaki servisler rumuz seçilmiş olmayı ister: rumuzu olmayan hesap 403 username_required alır.
/api/contacts
Ataçtaki "kişi" ekinin seçim listesi: takip ettiklerim ve birebir sohbetim olan kişiler, rumuza göre sıralı, en çok 500 kişi. Bir kişi iki kaynakta da varsa bir kez, source: "following" ile gelir.
{people}; source: following ya da dmunauthorized) veya süresi dolmuş (token_expired)username_required)curl https://mskop-api.gurerlabs.com/api/contacts \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/users/{username}
Bir kişinin profil kartını, birlikte üye olduğumuz grupları (common_rooms, ada göre) ve aramızdaki birebir sohbeti (dm) döner. dm yalnız benim üyesi olduğum bir sohbet varsa doludur (biçimi POST /api/dm/{username} yanıtıyla aynı), yoksa null. Kişinin kendi ayarları (fotoğraf görünürlüğü, gizli profil, doğum tarihi, cinsiyet) burada dönmez.
avatar karşı tarafın photo_visibility ayarı izin veriyorsa doludur, yoksa null.following: ben onu takip ediyor muyum; follows_me: o beni takip ediyor mu. follows onun takipçi/takip sayılarıdır.dm_policy ve dm_star_cost "mesaj gönder" düğmesini gizlemek ya da fiyatını göstermek içindir.username
string
path
zorunlu
Kişinin rumuzu; büyük/küçük harf duyarsız
{user, common_rooms, dm}unauthorized) veya süresi dolmuş (token_expired)username_required)not_found)curl https://mskop-api.gurerlabs.com/api/users/ozum \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/users/{username}/follow
Kişiyi takip etmeye başlar. İdempotenttir: zaten takip ediliyorsa yine 200 döner. Yanıttaki follows takip edilen kişinin güncel sayılarıdır.
username
string
path
zorunlu
Kişinin rumuzu; büyük/küçük harf duyarsız
{following: true, follows}invalid_request)unauthorized) veya süresi dolmuş (token_expired)username_required)not_found)curl -X POST https://mskop-api.gurerlabs.com/api/users/ozum/follow \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/users/{username}/follow
Kişiyi takip etmeyi bırakır. İdempotenttir: zaten takip edilmiyorsa da 200 ve following: false döner. Yanıttaki follows kişinin güncel sayılarıdır.
username
string
path
zorunlu
Kişinin rumuzu; büyük/küçük harf duyarsız
{following: false, follows}unauthorized) veya süresi dolmuş (token_expired)username_required)not_found)curl -X DELETE https://mskop-api.gurerlabs.com/api/users/ozum/follow \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/users/{username}/followers
Kişiyi takip edenler, en yeni takip başta. En çok 200 kişi döner; sayfalama yoktur. Toplam sayı profil kartındaki follows.followers alanındadır.
username
string
path
zorunlu
Kişinin rumuzu; büyük/küçük harf duyarsız
{people}; followed_at ISO-8601unauthorized) veya süresi dolmuş (token_expired)username_required)not_found)curl https://mskop-api.gurerlabs.com/api/users/ozum/followers \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/users/{username}/following
Kişinin takip ettikleri, en yeni takip başta. En çok 200 kişi döner; sayfalama yoktur. Toplam sayı profil kartındaki follows.following alanındadır.
username
string
path
zorunlu
Kişinin rumuzu; büyük/küçük harf duyarsız
{people}; followed_at ISO-8601unauthorized) veya süresi dolmuş (token_expired)username_required)not_found)curl https://mskop-api.gurerlabs.com/api/users/ozum/following \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/dm/{username}
Kişiyle birebir sohbet odasını döner; yoksa açar. Oda yalnız açanın listesine girer: karşı taraf ilk mesaj saklandığında odaya eklenir ve room:new olayını o zaman alır, o ana kadar onun profil kartında dm: null görünür. Karşı tarafın dm_policy değeri paid ise dm_star_cost yıldız açandan düşer ve karşı tarafa yazılır; ücret yalnız oda ilk açılırken bir kez alınır, var olan sohbete dönmek ücretsizdir.
kind: "dm", yönetici yok, herkese kapalı (visibility: "closed"), aramada çıkmaz. name karşı tarafın rumuzudur ve peer onu (online ile) verir.dm- + her UUID'nin tiresiz ilk 12 karakteri, sıralı); aynı çift hep aynı odaya düşer.member_count her zaman 2'dir; karşı taraf henüz eklenmemiş olsa bile.PATCH /api/rooms/{slug}, iki taraf da). Var olan sohbete karşı tarafın dm_policy ayarı sonradan closed olsa da dönülebilir.username
string
path
zorunlu
Sohbet açılacak kişinin rumuzu; büyük/küçük harf duyarsız
{room} (oda yeni açıldıysa da 200)invalid_request)unauthorized) veya süresi dolmuş (token_expired)insufficient_stars)dm_closed) ya da rumuz seçilmemiş (username_required)not_found)curl -X POST https://mskop-api.gurerlabs.com/api/dm/ozum \ -H "Authorization: Bearer $ACCESS_TOKEN"
Oda döndüren her uç aynı oda nesnesini verir; bağlama göre üstüne my_role, member_count, is_member, my_permissions, avatar gibi alanlar eklenir. kind group (olağan grup) ya da dm (birebir sohbetin sistem odası: peer dolu, name karşı tarafın rumuzu) olur. Odalar slug ile anılır: 3–48 karakter, küçük harf, rakam ve tek tire (^[a-z0-9]+(-[a-z0-9]+)*$), birebir sohbette dm-<id>-<id>; visibility open ise bağlantı katılmaya yeter, closed ise kişiyi bir yönetici ekler.
/api/rooms
Üyesi olduğun bütün odalar (arşivdekiler dahil), sohbet listesinin çizdiği satır bilgileriyle: my_role, joined_at, archived, muted, pinned_to_top, last_message, unread, unread_mentions. Sıra: önce başa sabitlenenler (en yeni sabit üstte), sonra en son konuşulan oda; hiç konuşulmamış oda joined_at'e düşer, eşitliği oda kimliği bozar. Birebir sohbet karşı tarafın rumuzuyla gelir ve peer.online o anki çevrimiçi durumunu taşır.
last_message.body gövdenin ilk 120 karakteridir; tartışma yanıtları ve silinmiş mesajlar last_message sayılmaz. Oda hiç konuşmadıysa null.unread okuma imlecinden (message:read) sonraki mesaj sayısıdır; kendi mesajların ve göremediğin admins satırları sayılmaz.my_role değeri de member gelir.user:<account_id> hattındaki room:activity, room:new ve room:gone olaylarıdır; her mesajda bu ucu yeniden çağırmak gerekmez.curl https://mskop-api.gurerlabs.com/api/rooms \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/search
Katılmadan önce bir grubu adının ya da slug'ının bir parçasıyla bulur (büyük/küçük harf duyarsız). Üyesi olduğun odalar başta, gerisi ada göre sıralanır; en çok 20 sonuç döner ve her satırda is_member, archived, member_count, avatar vardır. Kapalı gruplar ve başka bir organizasyonun odaları yalnız kendi üyelerinin aramasında çıkar; birebir sohbetler hiç çıkmaz.
GET /api/rooms/{slug} ile odanın kapı sayfasını açabilir.q
string
query
zorunlu
Aranan metin. % ve _ karakterleri yok sayılır; yalnız boşluksa sonuç boş liste olur
q verilmedi (invalid_request)curl https://mskop-api.gurerlabs.com/api/rooms/search?q=fenerbahce \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms
Yeni bir grup kurar; kuran kişi aynı işlemde kurucu (founder) ve ilk üye olur. slug verilmezse addan türetilir (Kadıköy Koşu Kulübü → kadikoy-kosu-kulubu, Türkçe harfler sadeleşir, en çok 40 karakter); türetilen slug doluysa sonuna -a1b2c3 gibi rastgele bir ek gelir. Fotoğraf ayrı yüklenir (*Oda fotoğrafları*): oda baytlardan önce var olur.
slug doluysa ek eklenmez, 422 döner (fields.slug: has already been taken).star_gated: true olan odaya katılma şimdilik 402 star_required döner; yıldızla katılma henüz açık değil.wallpaper, join_approval, show_members...) kurulumdan sonra PATCH /api/rooms/{slug} ile değişir.name
string
body
zorunlu
Oda adı; baştaki/sondaki boşluk kırpılır, 1–80 karakter
slug
string
body
isteğe bağlı
3–48 karakter, küçük harf, rakam ve tek tire; küçük harfe çevrilir. Sonradan değiştirilemez
visibility
string
body
isteğe bağlı
open (varsayılan; bağlantı yeter) ya da closed (yönetici ekler)
message_ttl_hours
integer
body
isteğe bağlı
Mesajlar bu kadar saat sonra silinir; 1–8760, null = silinmez (varsayılan)
welcome_message
string
body
isteğe bağlı
Yeni üyeye odanın yazdığı karşılama; en çok 500 karakter, {username} yerine katılanın rumuzu konur
star_gated
boolean
body
isteğe bağlı
Katılmak yıldız ister (varsayılan false)
my_role: "founder", member_count: 1validation_failed): name boş ya da 80'den uzun, slug biçimi bozuk ya da dolu, visibility bilinmiyor, message_ttl_hours aralık dışında, welcome_message 500'den uzuncurl -X POST https://mskop-api.gurerlabs.com/api/rooms \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"message_ttl_hours":168,"name":"Kadıköy Koşu Kulübü","visibility":"open","welcome_message":"Aramıza hoş geldin {username}!"}'/api/rooms/{slug}
Tek odanın tam nesnesi. Üye olmayan herkes de çağırabilir (davet bağlantısının açtığı kapı sayfası); kapalı gruplar dahil. is_member senin üye olup olmadığını, my_permissions bu odada yapabileceğin her şeyi söyler: istemci ataşı ve menüleri bu listeden çizmeli, kuralları kendisi türetmemelidir.
my_permissions boş liste gelir.pinned en yeni sabitlenen mesajdır (eski uygulamalar bunu okur), pins bütün sabitlerin listesidir (yeniden eskiye). Yalnız mesaj kimliği gelir; metni cihaz kendi kopyasından çizer.member_denied odanın üyelerden geri aldığı yetkilerdir; members_can_pin aynı kuralın eski adıdır (group.can_pin_message).my_role yoktur; rolü GET /api/rooms listesi ya da GET /api/rooms/{slug}/members verir.slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
room_not_found)curl https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}
Odanın ayarlarını değiştirir; göndermediğin alan olduğu gibi kalır, bilinmeyen alanlar yok sayılır, slug hiç değişmez. Gönderilen her ayar adı odaya yalnız yöneticilerin gördüğü bir room_settings_changed satırı olarak yazılır (event.data.settings; değerler saklanmaz). Birebir sohbette iki taraf da çağırabilir ama yalnız wallpaper değişir ve orada wallpaper zorunludur.
granted) bakılmaz.members_can_pin gönderilirse member_denied içindeki group.can_pin_message de aynı yönde güncellenir.visibility, wallpaper ve name için null gönderilemez (422); "message_ttl_hours": null otomatik silmeyi kapatır.slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
name
string
body
isteğe bağlı
Oda adı, 1–80 karakter
visibility
string
body
isteğe bağlı
open ya da closed
welcome_message
string
body
isteğe bağlı
Karşılama metni, en çok 500 karakter; {username} kullanılabilir
message_ttl_hours
integer
body
isteğe bağlı
1–8760 saat; null = mesajlar silinmez
wallpaper
string
body
isteğe bağlı
Sohbet duvar kâğıdı: adacayi, okyanus, lavanta, kum, gul, grafit
star_gated
boolean
body
isteğe bağlı
Katılmak yıldız ister
members_can_pin
boolean
body
isteğe bağlı
Üyeler mesaj sabitleyebilir
discussions_enabled
boolean
body
isteğe bağlı
Mesajların altında tartışma açılabilir
join_approval
boolean
body
isteğe bağlı
Katılma isteği yönetici onayı bekler (join → requested); açıkken visibility'ye bakılmaz
history_for_new_members
boolean
body
isteğe bağlı
false ise yeni üyenin akışı katıldığı andan başlar
events_visibility
string
body
isteğe bağlı
Oda satırlarını kim görür: all, admins ya da none
show_welcome
boolean
body
isteğe bağlı
Yeni üyeye karşılama satırı yazılır
show_members
boolean
body
isteğe bağlı
false ise yönetici olmayanlar üye listesinde yalnız kurucuyu ve yöneticileri görür
show_gifts
boolean
body
isteğe bağlı
Grup sayfasında hediyeler sekmesi görünür
members_can_video
boolean
body
isteğe bağlı
Üyeler görüntülü sohbet başlatabilir (Faz 2)
GET /api/rooms/{slug} ile aynı biçim)not_admin)room_not_found)validation_failed): bilinmeyen wallpaper / visibility / events_visibility, aralık dışı message_ttl_hours, uzun metincurl -X PATCH https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"message_ttl_hours":72,"name":"Fenerbahçe Taraftar Grubu","show_members":false,"wallpaper":"grafit"}'/api/rooms/{slug}
for=me sohbeti yalnız senin listenden düşürür: POST /api/rooms/{slug}/leave ile birebir aynıdır ve onun yanıtını döner (kurucuysan oda devredilir). for=everyone odayı temelli siler: üyeler, mesajlar, konular, banlar, fotoğraflar ve medya dosyaları gider; diğer üyelerin user: hattına room:gone, odanın kanalına room:deleted yayılır. Grupta bunu yalnız kurucu yapabilir, birebir sohbette iki taraftan biri; geri alınamaz.
for verilmezse (ya da tanınmayan bir değerse) birebir sohbette me, grupta everyone sayılır.slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
for
string
query
isteğe bağlı
everyone (odayı herkes için sil) ya da me (yalnız listemden kaldır)
for=me: ayrılma yanıtı (left, handed_over ya da room_gone)for=everyone: oda silindi; gövde boşfor=everyone ve kurucu değilsin / birebir sohbetin üyesi değilsin (not_admin); for=me ve üye değilsin (not_member)room_not_found)curl -X DELETE https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar?for=me \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/join
Odaya girer ve sonucu status ile, odanın güncel hâlini room ile döner. joined: üye oldun; odaya member:joined yayılır, member_joined satırı ve (açıksa) karşılama satırı yazılır. already_member: zaten üyesin, hiçbir şey değişmez. requested: oda onay istiyor (join_approval), isteğin yöneticilerin requests listesine düştü ve onaylanınca user: hattına room:new gelir.
403 banned) → yıldız (402 star_required) → onay kuyruğu (requested) → kapalı oda (403 room_closed). Kapalı ama kuyruklu oda istek alır.history_for_new_members: false) akışın katıldığın andan başlar.slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
status: joined, already_member ya da requested; yanında roomstar_required)banned) ya da oda kapalı ve onay kuyruğu yok (room_closed)room_not_found)curl -X POST https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/join \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/leave
Odadan çıkarsın; odaya member:left yayılır ve member_left satırı yazılır. Kurucu da ayrılabilir: oda önce yöneticilerden, yoksa üyelerden odada en uzun süredir bulunana geçer, yanıt handed_over + founder_id olur, odaya founder_changed satırı yazılır ve yeni kurucunun user: hattına my_role: "founder" taşıyan room:new gider. Odada senden başka kimse kalmadıysa oda dosyalarıyla birlikte silinir (room_gone, odaya room:deleted).
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
status: left, handed_over (+ founder_id) ya da room_gonenot_member)room_not_found)curl -X POST https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/leave \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/archive
Odayı yalnız kendi arşivine taşır; başka kimsenin listesi değişmez. Arşivdeki oda GET /api/rooms içinde archived: true ile gelmeye devam eder ve sıradan mesajlar için push göndermez; seni @rumuz ile anan mesajın push'u yine gelir. Zaten arşivdeyse de 204 döner.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
not_member)room_not_found)curl -X PUT https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/archive \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/archive
Odayı arşivden ana listeye geri alır ve push'ları yeniden açar (sessize alınmadıysa). Arşivde değilse de 204 döner.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
not_member)room_not_found)curl -X DELETE https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/archive \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/pin
Odayı yalnız senin sohbet listenin tepesine sabitler; odadaki başka kimsenin listesi kıpırdamaz. Sabitlenen odalar listede en yeni sabit üstte olacak şekilde önce gelir, pinned_to_top: true taşır. Odanın mesaj sabitlemesiyle (pinned, pins) ilgisi yoktur.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
not_member)room_not_found)curl -X PUT https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/pin \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/pin
Listedeki sabitlemeyi kaldırır; oda son konuşulma sırasındaki yerine döner. Sabit değilse de 204 döner.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
not_member)room_not_found)curl -X DELETE https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/pin \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/mute
Bu odadan sana push gelmez; başka hiçbir şey değişmez (mesajlar, rozet, liste aynen sürer). Arşivden farklı olarak @rumuz bahsetmeleri de sessize alınır. Oda nesnesinde muted: true görünür.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
not_member)room_not_found)curl -X PUT https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/mute \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/mute
Sessize almayı kaldırır; push'lar yeniden gelir. Sessizde değilse de 204 döner. Bir yöneticinin seni susturmasıyla (members/{account_id}/mute) karıştırılmamalı.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
not_member)room_not_found)curl -X DELETE https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/mute \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/stats
Grup sayfasının üst şeridi: ne zamandan beri var, kaç üye, kaç mesaj, ne kadar yıldız ve hediye almış. Yanıt stats nesnesine sarılıdır. message_count oda satırlarını (kind: "event") ve silinmiş mesajları saymaz.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
not_member)room_not_found)curl https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/stats \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/events
Odanın kendi yazdığı son satırlar (katılma, ayrılma, atma, ban, susturma, ayar değişikliği...), yeniden eskiye. Her biri kind: "event" olan normal bir mesaj nesnesidir; event.type ne olduğunu, event.username kimin hakkında olduğunu, event.actor kimin yaptığını söyler. Yöneticiler audience: "admins" satırlarını da görür, üyeler görmez.
member_joined, member_left, member_kicked, member_banned, member_unbanned, member_muted, member_unmuted, score, welcome, founder_changed, room_settings_changed, member_permissions_changed, admin_permissions_changed, message_deleted, message_pinned, message_unpinned, discussion_closed, discussion_reopened.slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
limit
integer
query
isteğe bağlı
Kaç satır; 1–200 arasına sıkıştırılır, varsayılan 50
not_member)room_not_found)curl https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/events?limit=20 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/topics
Odada kullanılan hashtag'ler, en son aktif olan başta, en çok 100 tane. Her mesaj taşıdığı her hashtag'in sayacını artırır; hashtag'siz mesajlar unknown konusunda sayılır (unknown: true). last_active ISO-8601 zamandır.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
not_member)room_not_found)curl https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/topics \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/vanity-link
Odaya yıldızla bir kısa link alır: short_link artık mskp.io/<code> olur, slug değişmez. Ücret (varsayılan 10 yıldız, app_settings.vanity_link_star_cost) çağıranın bakiyesinden düşer, yıldızlar odaya yazılır ve level yeniden hesaplanır; harcama yıldız defterine room_vanity_link sebebiyle işlenir. Yeniden çağırmak kodu değiştirir ve ücreti yeniden keser.
402 döner.403 not_admin döner.slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
code
string
body
zorunlu
İstenen kod; kırpılıp küçük harfe çevrilir. 3–48 karakter, slug biçiminde, başka odada olmamalı
vanity_code, short_link, stars, level yenilendicode verilmedi (invalid_request)insufficient_stars)not_admin)room_not_found)validation_failed, fields.vanity_code)curl -X POST https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/vanity-link \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"code":"fb"}'Odada üç rol vardır: founder (kurucu; her yetkiyi her zaman taşır, kısıtlanamaz, atılamaz ve engellenemez), admin (yönetici; yalnız kendisine verilen anahtarları, granted, taşır) ve member (üye; odanın member_denied ile geri aldıkları ve yöneticiye özgü anahtarlar dışında her şeyi yapabilir). Üye anahtarları: send_message, edit_message, delete_message, update_tag, sub_chat.send_message, sub_chat.close_subject, group.can_open_discussion, group.can_pin_message, group.can_take_screen_shot, ayrıca her ek türü için send_message.<tür> ve sub_chat.send_message.<tür> (tür: photos, videos, files, musics, voice_messages, video_messages, gifs, surveys, links, reactions, locations, share_contact_cards, events, entries; musics ve video_messages henüz kullanılmıyor). Yönetici anahtarları: group.edit_informations, group.can_remove_message, group.can_ban_members, group.can_ban_administrators (yalnız kurucu verebilir), group.can_invite_members, group.can_create_invite_link, group.can_cancel_invite_link, group.can_pin_message, group.can_edit_member_tags, group.can_open_voice_calls, group_can_give_permissions (noktasız yazılır), group.can_edit_permissions, group.can_be_anonymous, group.can_take_screen_shot. Bazı uçlar anahtara değil yalnız yönetici olmaya bakar; her kartın rozeti neyin gerektiğini söyler, kişinin odadaki sonucu ise her zaman oda nesnesindeki my_permissions listesidir.
/api/rooms/{slug}/admins/{account_id}
Bir üyeyi yönetici yapar. Yeni yönetici hiçbir anahtarla başlamaz (granted: []); ne yapabileceğini ayrıca PUT …/admins/{account_id}/permissions ile verirsin. Kimin atadığı saklanır ve üye listesinde granted_by olarak döner. Zaten yöneticiyse hiçbir şey değişmez ve yine admin döner.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
account_id
uuid
path
zorunlu
Yönetici yapılacak üyenin hesap kimliği
{status: "admin"}not_admin) ya da hedef odanın üyesi değil (not_member)room_not_found)founder_protected)curl -X PUT https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/admins/2b9d71c4-8e05-4a3f-b6d2-5c19e7a04f83 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/admins/{account_id}
Yöneticiyi sıradan üyeye indirir; verilmiş bütün anahtarları (granted) silinir. Kişi odada kalır.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
account_id
uuid
path
zorunlu
Yöneticiliği alınacak hesabın kimliği
{status: "member"}not_admin)room_not_found) ya da hedef yönetici değil (not_found)founder_protected)curl -X DELETE https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/admins/2b9d71c4-8e05-4a3f-b6d2-5c19e7a04f83 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/admins/{account_id}/permissions
Bir yöneticinin taşıdığı anahtarların tamamını yazar: liste her seferinde bütün gerçektir, içinde olmayan geri alınır. Bilinmeyen anahtarlar reddedilmez, sessizce düşer; liste tekilleştirilip sıralanır. Odaya yalnız yöneticilerin gördüğü bir admin_permissions_changed satırı yazılır (event.data.granted).
403 cannot_grant_to_self).group.can_ban_administrators yalnız kurucu verebilir; başka bir yönetici gönderirse çağrı reddedilmez, o anahtar listeden düşer. Yanıttaki granted gerçekte yazılandır.send_message.links) yöneticiye ayrıca verilirse o yönetici için yasak kalkar.slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
account_id
uuid
path
zorunlu
Anahtarları yazılacak yöneticinin hesap kimliği
granted
string[]
body
zorunlu
Verilecek anahtarların tam listesi; boş liste hepsini geri alır
{granted: [...]}: yazılan listenot_admin); hedef kendinsin (cannot_grant_to_self)room_not_found)curl -X PUT https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/admins/2b9d71c4-8e05-4a3f-b6d2-5c19e7a04f83/permissions \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"granted":["group.can_ban_members","group.can_edit_member_tags","group.can_remove_message"]}'/api/rooms/{slug}/permissions
Odanın üyelerden geri aldığı yetkileri (member_denied) yazar. Liste her seferinde bütün gerçektir: içinde olmayan her şey serbesttir; bilinmeyen anahtarlar sessizce düşer. Yasak yöneticileri de bağlar, onlara aynı anahtar ayrıca verilmediyse. Odaya yalnız yöneticilerin gördüğü bir member_permissions_changed satırı yazılır.
denied gönderilmezse ya da liste değilse boş liste sayılır ve bütün kısıtlar kalkar.members_can_pin alanını güncellemez; sabitleme kuralı için member_denied ve my_permissions esas alınmalı.slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
denied
string[]
body
zorunlu
Üyelerden alınacak anahtarların tam listesi; [] hepsini geri verir
GET /api/rooms/{slug} ile aynı biçim)not_admin)room_not_found)curl -X PATCH https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/permissions \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"denied":["group.can_pin_message","send_message.links","send_message.locations"]}'/api/rooms/{slug}/members
Odanın üyeleri, katılma sırasına göre (en eski başta). Her satırda rol (founder, admin, member), odanın taktığı etiket (tag), yöneticinin anahtarları (granted), onu kimin atadığı (granted_by, rumuz) ve ne zamandan beri yönetici olduğu (admin_since) vardır. muted_until bir yöneticinin susturması sürerken ms epoch, bitince null; joined_at ve admin_since ISO-8601'dir.
show_members: false) kurucu ya da yönetici olmayan biri yalnız kurucuyu ve yöneticileri görür.granted yalnız kurucuya ve yöneticilere dolu gelir; sıradan üye herkeste [] görür.slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
not_member)room_not_found)curl https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/members \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/members/{account_id}
Kişiyi engellemeden odadan çıkarır (/kick komutunun REST ikizi); bağlantıyla yeniden katılabilir. Yöneticiyse yöneticiliği de gider. Odaya member_kicked satırı yazılır ve member:left yayılır, kişinin user: hattına room:gone gider. Hedef bir yöneticiyse ayrıca group.can_ban_administrators gerekir.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
account_id
uuid
path
zorunlu
Çıkarılacak hesabın kimliği
not_admin, yöneticisin ama group.can_ban_members verilmediyse ya da hedef bir yöneticiyse ve group.can_ban_administrators yoksa not_allowednot_member)room_not_found) ya da hesap yok (not_found)founder_protected)curl -X DELETE https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/members/2b9d71c4-8e05-4a3f-b6d2-5c19e7a04f83 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/members/{account_id}/tag
Odanın bir üyesine taktığı kısa kelime (ör. Kaptan); o kişinin bu odadaki her mesajında adının yanında çizilir, başka odada görünmez. Metin kırpılır ve 32 karakterden uzunsa kesilir; boş metin ya da null etiketi kaldırır. Odaya member:tagged {account_id, tag} yayılır, açık cihazlar listeyi yeniden istemeden çizer.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
account_id
uuid
path
zorunlu
Etiketlenecek üyenin hesap kimliği
tag
string
body
isteğe bağlı
Etiket, en çok 32 karakter; boş ya da null kaldırır
{account_id, tag}; kaldırıldıysa tag: nullnot_admin) ya da hedef üye değil (not_member)room_not_found)curl -X PUT https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/members/2b9d71c4-8e05-4a3f-b6d2-5c19e7a04f83/tag \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"tag":"Kaptan"}'/api/rooms/{slug}/members/{account_id}/mute
Kişi odada kalır ama süre bitene kadar mesaj gönderemez; denerse socket muted hatası ve until döner (/mute komutunun REST ikizi, yönetim ekranı için). Odaya member_muted satırı yazılır (data.until ms, data.seconds verilen süre). Yeniden çağırmak süreyi baştan kurar.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
account_id
uuid
path
zorunlu
Susturulacak üyenin hesap kimliği
minutes
integer
body
isteğe bağlı
Süre (dakika); 1–525600 arasına sıkıştırılır, verilmezse ya da sayı değilse 60
{muted_until}: bitiş anı, ms epochnot_admin, yöneticisin ama group.can_ban_members verilmediyse ya da hedef bir yöneticiyse ve group.can_ban_administrators yoksa not_allowednot_member)room_not_found) ya da hesap yok (not_found)founder_protected)curl -X PUT https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/members/2b9d71c4-8e05-4a3f-b6d2-5c19e7a04f83/mute \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"minutes":60}'/api/rooms/{slug}/members/{account_id}/mute
Kişinin sesini hemen geri verir ve odaya member_unmuted satırı yazar. Susturulmamış bir üye için de 204 döner (satır yine yazılır).
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
account_id
uuid
path
zorunlu
Sesi açılacak üyenin hesap kimliği
not_admin, yöneticisin ama group.can_ban_members verilmediyse ya da hedef bir yöneticiyse ve group.can_ban_administrators yoksa not_allowednot_member)room_not_found) ya da hesap yok (not_found)founder_protected)curl -X DELETE https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/members/2b9d71c4-8e05-4a3f-b6d2-5c19e7a04f83/mute \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/bans
Odanın engellediği hesaplar, en yeni başta. reason engellerken verilen sebeptir (yoksa null), banned_at ISO-8601'dir. Liste bans nesnesine sarılıdır.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
not_admin)room_not_found)curl https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/bans \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/bans/{account_id}
Kişiyi odadan çıkarır ve bir daha katılamaz (join → 403 banned); /ban komutunun REST ikizidir. Odaya member_banned satırı yazılır (data.reason), member:left yayılır ve kişinin user: hattına room:gone gider. Hedefin o anda üye olması gerekmez: odaya hiç girmemiş bir hesap da önceden engellenebilir.
204 döner; ilk sebep değişmez.slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
account_id
uuid
path
zorunlu
Engellenecek hesabın kimliği
reason
string
body
isteğe bağlı
Sebep; engellenenler listesinde görünür
not_admin, yöneticisin ama group.can_ban_members verilmediyse ya da hedef bir yöneticiyse ve group.can_ban_administrators yoksa not_allowedroom_not_found) ya da hesap yok (not_found)founder_protected)curl -X PUT https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/bans/2b9d71c4-8e05-4a3f-b6d2-5c19e7a04f83 \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"reason":"Reklam ve spam"}'/api/rooms/{slug}/bans/{account_id}
Engeli kaldırır ve odaya member_unbanned satırı yazar (/unban komutunun REST ikizi). Kişi üye olarak geri eklenmez; isterse bağlantıyla yeniden katılır.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
account_id
uuid
path
zorunlu
Engeli kaldırılacak hesabın kimliği
not_admin, yöneticisin ama group.can_ban_members verilmediyse ya da hedef bir yöneticiyse ve group.can_ban_administrators yoksa not_allowedroom_not_found, not_found) veya kişi engelli değil (not_found)founder_protected)curl -X DELETE https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/bans/2b9d71c4-8e05-4a3f-b6d2-5c19e7a04f83 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/requests
Onay isteyen bir odada (join_approval: true) kapıda bekleyenler, en eski başta. requested_at ISO-8601'dir. Liste requests nesnesine sarılıdır.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
not_admin)room_not_found)curl https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/requests \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/requests/{account_id}
Bekleyen kişiyi üye yapar. Odaya member:joined yayılır, member_joined ve (açıksa) karşılama satırı yazılır; kişinin user: hattına room:new gider, odayı açık olmasa da listesinde görür.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
account_id
uuid
path
zorunlu
Onaylanacak isteğin sahibi
{status: "joined"}not_admin)room_not_found) ya da bu hesabın bekleyen isteği yok (not_found)curl -X POST https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/requests/2b9d71c4-8e05-4a3f-b6d2-5c19e7a04f83 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/requests/{account_id}
Bekleyen isteği siler. Kişiye bildirim gitmez; yeniden istek gönderebilir. Bekleyen istek yoksa da 204 döner.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
account_id
uuid
path
zorunlu
Reddedilecek isteğin sahibi
not_admin)room_not_found)curl -X DELETE https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/requests/2b9d71c4-8e05-4a3f-b6d2-5c19e7a04f83 \ -H "Authorization: Bearer $ACCESS_TOKEN"
Oda fotoğrafları karedir (1:1); bir odanın birkaç fotoğrafı olabilir ama biri birincildir ve listelerde, başlıkta o görünür. Backend bayt taşımaz: önce presign ile iki yükleme adresi alınır, istemci asıl görüntüyü ve kendi ürettiği küçük kopyayı doğrudan depoya PUT eder, sonra anahtarları POST /api/rooms/{slug}/avatars ile kaydeder. url ve thumb_url 1 saatlik imzalı adreslerdir; küçük kopyanın baytını cihazda saklayıp önce onu çizmek, bayat adresi boş avatar yerine bir tazelemeye çevirir.
/api/rooms/{slug}/avatars
Odanın bütün fotoğrafları: birincil başta, gerisi yeniden eskiye. Oda detayı gibi üye olmayanlar da çağırabilir. created_at ISO-8601'dir; adresler her çağrıda yeniden imzalanır.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
room_not_found)curl https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/avatars \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/avatars/presign
Bir fotoğraf için iki imzalı PUT adresi verir: full (1:1 asıl görüntü) ve thumb (küçük kopya). İkisi aynı kimliği paylaşır ve 600 saniye geçerlidir. İstemci kareyi kırpar, küçük kopyayı kendisi üretir ve iki nesneyi de Content-Type başlığıyla bu adreslere yükler. Birebir sohbette iki taraf da çağırabilir.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
content_type
string
body
isteğe bağlı
image/jpeg (varsayılan), image/webp ya da image/png
content_type (invalid_request)not_admin)room_not_found)curl -X POST https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/avatars/presign \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"content_type":"image/jpeg"}'/api/rooms/{slug}/avatars
presign ile yüklenen iki nesneyi odanın fotoğrafı olarak kaydeder. Odanın ilk fotoğrafı ve primary: false denmeden eklenen her fotoğraf birincil olur; eski birincil aynı işlemde düşer. Sunucu nesnelerin gerçekten yüklendiğini denetlemez: iki PUT bitmeden bu uç çağrılmamalı.
key ve thumb_key bu odanın kendi önekiyle (room-avatars/<oda id>/) başlamalı; başka odanın ya da hesabın anahtarı 422 alır.false değeri engeller; başka her değer (ya da alanın olmaması) birincil yapar.slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
key
string
body
zorunlu
presign yanıtındaki full.key
thumb_key
string
body
zorunlu
presign yanıtındaki thumb.key
content_type
string
body
isteğe bağlı
image/jpeg (varsayılan), image/webp ya da image/png
byte_size
integer
body
isteğe bağlı
Asıl görüntünün boyutu (bayt); 1–8000000
size_px
integer
body
isteğe bağlı
Karenin kenarı (piksel); 1–4096
primary
boolean
body
isteğe bağlı
Birincil yap (varsayılan true)
{avatar}not_admin)room_not_found)validation_failed): key/thumb_key yok ya da odanın öneki değil, bilinmeyen content_type, byte_size ya da size_px aralık dışındacurl -X POST https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/avatars \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"byte_size":118432,"content_type":"image/jpeg","key":"room-avatars/9b7e2c51-4d0a-4f6e-8a13-6e2d7c90b4f5/5d7c2e90-1a4b-4f36-8e02-b9c3d6a17f54.jpg","primary":true,"size_px":1024,"thumb_key":"room-avatars/9b7e2c51-4d0a-4f6e-8a13-6e2d7c90b4f5/5d7c2e90-1a4b-4f36-8e02-b9c3d6a17f54-thumb.jpg"}'/api/rooms/{slug}/avatars/{id}/primary
Odanın listelerde ve başlıkta görünen fotoğrafını değiştirir; eski birincil aynı işlemde düşer. Fotoğraf bu odanın değilse ya da yoksa 404 döner.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
id
uuid
path
zorunlu
Fotoğrafın kimliği (GET …/avatars listesinden)
{avatar}not_admin)room_not_found) ya da fotoğraf yok (not_found)curl -X PUT https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/avatars/8a61f4c2-0d39-4b7e-a5c8-e2f71b9d3064/primary \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/avatars/{id}
Fotoğraf kaydını ve depodaki iki nesnesini (asıl ve küçük kopya) siler. Silinen birincilse en yeni fotoğraf birincil olur; başka fotoğraf yoksa odanın avatar alanı null kalır.
slug
string
path
zorunlu
Oda slug'ı (büyük/küçük harf fark etmez)
id
uuid
path
zorunlu
Silinecek fotoğrafın kimliği
not_admin)room_not_found) ya da fotoğraf yok (not_found)curl -X DELETE https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/avatars/8a61f4c2-0d39-4b7e-a5c8-e2f71b9d3064 \ -H "Authorization: Bearer $ACCESS_TOKEN"
Mesajların kendisi REST'ten değil WebSocket'ten gider (message:new). Bu gruptaki çağrılar dosyanın yolculuğunu yönetir: önce presign ile MinIO'ya doğrudan yüklenecek bir PUT linki alınır, dosya o linke yüklenir, sonra socket'te message:new içindeki attachment ile yalnızca dönen key'ler gönderilir. Yükleme linkleri 600 sn (10 dk), mesajlardaki indirme linkleri (url, thumb_url) 3600 sn (1 saat) geçerlidir; bayatlayan link buradaki uçlardan tazelenir. Hepsi yalnız oda üyelerine açıktır: oda yoksa 404 room_not_found, üye değilsen 403 not_member.
/api/rooms/{slug}/media
Odanın fotoğraf ve video mesajlarını yeniden eskiye döner: grup sayfasındaki ve profildeki Medya sekmesi. GIF, çıkartma, tek gösterimlik ve silinmiş mesajlar listede yoktur; yöneticilere ayrılmış (audience: "admins") satırları yalnız yöneticiler, oda geçmişi kapalıysa (history_for_new_members: false) yeni üye yalnız katıldıktan sonrakileri görür. Her mesaj taze presigned linklerle (url, thumb_url, 1 saat) gelir.
inserted_at değerini before olarak gönder. Karşılaştırma kesin (<) olduğundan aynı milisaniyede gönderilmiş iki medyadan biri sayfa sınırında atlanabilir.from (UUID değil) ve sayı olmayan before / limit hata vermez, yok sayılır.slug
string
path
zorunlu
Oda slug'ı
from
uuid
query
isteğe bağlı
Yalnız bu hesabın gönderdikleri (profildeki Medya sekmesi)
before
ms
query
isteğe bağlı
Bu andan (ms epoch) önce gönderilenler; ilk sayfada verilmez
limit
integer
query
isteğe bağlı
Sayfa boyu; varsayılan 60, 1–100 arasına çekilir
{media: [mesaj], has_more} — has_more: true ise daha eskisi varnot_member)room_not_found)curl https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/media?from=f6cad462-3b1e-4d6a-9a77-2c1e0b8f4d21&before=1791969600000&limit=30 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/media/{id}
Tek bir fotoğraf, video, GIF ya da çıkartma mesajını yeni presigned linklerle döner. Mesajdaki linkler 1 saatte bayatlar; küçük kopyayı yerelde saklayan cihaz büyük dosyayı isterken buraya sorar. Metin, belge gibi başka türden bir mesaj ya da silinmiş mesaj 404 döner.
view_once: true) mesajda link ve anahtar hiç gelmez; o dosya yalnız socket'teki message:open_once ile, bir kez açılır.slug
string
path
zorunlu
Oda slug'ı
id
uuid
path
zorunlu
Mesajın kimliği
{message} — taze url ve thumb_url ilenot_member)room_not_found), ya da mesaj yok, silinmiş ya da medya değil (not_found)curl https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/media/3c7f1b2e-8a4d-4f6b-9e1c-0d2a5b7c9e81 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/media/presign
Fotoğraf, video, GIF ya da çıkartma mesajı için iki presigned PUT linki verir: dosyanın kendisi (full) ve küçük kopyası (thumb). İstemci ikisini de dönen url'lere doğrudan PUT eder (10 dk içinde), sonra socket'te message:new ile attachment: {type, key, thumb_key, content_type, width, height, byte_size} gönderir. Anahtarlar bu odanın room-media/<oda kimliği>/ önekindedir; başka bir odada kullanılamaz.
content_type kabul edilenler: image/jpeg (varsayılan), image/png, image/webp, image/gif, video/mp4. Başkası 400.thumb_content_type kabul edilenler: image/jpeg, image/png, image/webp. Verilmezse video ve GIF için image/jpeg, diğerlerinde dosyanın kendi türü. Saydamlığı korunması gereken çıkartmada image/png gönder.message:new anında denetlenir (yükleme sırasında değil), aşılırsa socket invalid_attachment döner. Fotoğraf: image/jpeg, image/png, image/webp; en çok 8 MiB (8.388.608 bayt) ve kenar başına 1–8192 px.video/mp4; en çok 16 MiB (16.777.216 bayt), duration_ms 1–10.500. GIF: image/gif ya da image/webp; en çok 8 MiB. Çıkartma: image/webp, image/png ya da image/gif; en çok 2 MiB (2.097.152 bayt), isteğe bağlı pack_id ([A-Za-z0-9_.:-]{1,64}) ve emoji (1–8 karakter).view_once: true, yalnız birebir sohbette, fotoğraf ya da video) mesajda thumb_key gönderilmez; thumb linki kullanılmadan bırakılır.slug
string
path
zorunlu
Oda slug'ı
content_type
string
body
isteğe bağlı
Dosyanın türü: image/jpeg (varsayılan), image/png, image/webp, image/gif, video/mp4
thumb_content_type
string
body
isteğe bağlı
Küçük kopyanın türü: image/jpeg, image/png, image/webp
{content_type, thumb_content_type, full, thumb}; her biri {method: "PUT", url, key, expires_in: 600}content_type ya da thumb_content_type (invalid_request)not_member)room_not_found)curl -X POST https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/media/presign \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"content_type":"image/jpeg"}'/api/rooms/{slug}/docs/presign
Bir belge için tek bir presigned PUT linki verir. İstemci dosyayı put.url'e yükler (10 dk içinde), sonra socket'te message:new ile attachment: {type: "document", key, name, content_type, byte_size} gönderir. Belge bir ödünçtür: dosya gönderildikten expires_in saniye (1 saat) sonra sunucudan silinir, mesaj satırı kalır.
application/pdf (pdf), application/msword (doc), application/vnd.openxmlformats-officedocument.wordprocessingml.document (docx), application/vnd.ms-excel (xls), application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (xlsx), application/vnd.ms-powerpoint (ppt), application/vnd.openxmlformats-officedocument.presentationml.presentation (pptx), application/zip ve application/x-zip-compressed (zip).max_bytes). Boyut message:new anında byte_size ile denetlenir; name orada boş olmamalı ve en çok 200 karakter olmalı, yoksa socket invalid_attachment döner.put.expires_in (600) yükleme linkinin ömrü, üst düzeydeki expires_in (3600) belgenin gönderildikten sonra sunucuda kalacağı süre.slug
string
path
zorunlu
Oda slug'ı
content_type
string
body
zorunlu
Belgenin MIME türü; yukarıdaki listeden biri
name
string
body
zorunlu
Dosyanın görünen adı; burada yalnız varlığı denetlenir, anahtara girmez
{content_type, extension, max_bytes, expires_in, put}content_type ya da name yok (invalid_request)not_member)room_not_found)curl -X POST https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/docs/presign \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"content_type":"application/pdf","name":"Sezon Bütçesi 2026.pdf"}'/api/rooms/{slug}/docs/{id}
Belge mesajını, dosya hâlâ sunucudayken yeni bir indirme linkiyle döner. Link belgenin kalan ömrüyle (ttl_left saniye) sınırlıdır, belgeden uzun yaşayamaz. Belgenin saati dolduysa 410 document_expired döner: belge buradaydı, uygulama bunu "süresi doldu" diye göstermeli.
expired ve ttl_left bulunur; süresi geçmiş kartta expired: true ve url: null olur, ad ve boyut kalır.slug
string
path
zorunlu
Oda slug'ı
id
uuid
path
zorunlu
Belge mesajının kimliği
{message} — attachment.url tazenot_member)room_not_found), ya da mesaj yok, silinmiş ya da belge değil (not_found)document_expired)curl https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/docs/6b1d9e4f-2a7c-4c3e-8f5b-9d0e1a2b3c4d \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/rooms/{slug}/messages/{id}/share
Yazar kendi makale mesajını (kind: "article") sözlüğün moderasyon kuyruğuna gönderir; gövde yoktur. Topic'i makalenin etiketi belirler: önce kartın kendi hashtag'i, yoksa mesajın ilk hashtag'i (# atılır, küçük harfe çevrilir). 201 yayımlandı değil kuyruğa alındı demektir: kararı bir moderatör verir, uygulama yazara bunu söylemeli.
topic.status pending olur. topic konsol bilgi vermezse null gelebilir.403 not_available_in_organization alır.503 sozluk_unavailable ret değil arızadır: yazara "tekrar dene" denmeli, "makalen reddedildi" değil.slug
string
path
zorunlu
Makalenin bulunduğu odanın slug'ı
id
uuid
path
zorunlu
Makale mesajının kimliği
{share: {entry_id, status: "pending", topic, message}}not_member), makale senin değil (not_author), oda bir organizasyonun (not_available_in_organization) ya da yayın yasağın var (sozluk_author_banned; message moderatörün gerekçesidir)not_found); oda yok (room_not_found)sozluk_already_shared)not_an_article), makalenin etiketi yok (sozluk_tag_required) ya da eski konsollarda etiketin topic'i yok (sozluk_topic_not_found)sozluk_unavailable)curl -X POST https://mskop-api.gurerlabs.com/api/rooms/fenerbahce-taraftar/messages/d4a8c2e6-1b3f-4d5a-9e7c-8f0b2d4e6a1c/share \ -H "Authorization: Bearer $ACCESS_TOKEN"
Mesajdaki bir linkin altındaki kartı sunucu hazırlar: sayfayı telefon değil backend çeker, böylece linkteki site odada kimin okuduğunu görmez. Analitik ucu ise uygulamanın Keşfet'te yaptıklarını (topic, makale, kategori açılışları) yerel kuyruğundan toplu olarak yükler; olaylar yalnız sayılır, mesaj içeriği hiçbir zaman okunmaz. İkisi de rumuzu seçilmiş bir hesabın token'ını ister.
/api/link-preview
Verilen adresin başlığını, kısa açıklamasını, site adını ve ikonunu döner. Sonuçlar normalleştirilmiş adrese göre (şema ve host küçük harf, #fragment atılır) önbelleğe alınır: başarılı önizleme 24 saat, başarısızlık 1 saat saklanır; aynı adres için aynı anda gelen istekler tek çekişi bekler. 404 preview_unavailable gelirse uygulama kart çizmeden yalnız linki gösterir.
http/https, yalnız port 80 ve 443, adreste kullanıcı/şifre olmamalı, en çok 2048 karakter. Ad sunucuda çözülür ve çözüldüğü her adres denetlenir; biri bile yasaklıysa reddedilir: loopback, özel ağlar (10/8, 172.16/12, 192.168/16), link-local (169.254/16, bulut metadata adresi dahil), CGNAT (100.64/10), 0.0.0.0/8, multicast, ayrılmış ve belgeleme aralıkları, IPv6 ::1, fc00::/7, fe80::/10, fec0::/10, ff00::/8 ve içinde bunları taşıyan her IPv6 biçimi. 2130706433, 127.1 gibi sayısal yazımlar da reddedilir.text/html işlenir. İstekler User-Agent: MakroskopBot/1.0 (+https://makroskop.gurerlabs.com) ile, çerezsiz gider.og:title, twitter:title, title sırasıyla, en çok 200 karakter; açıklama og:description, twitter:description, meta description sırasıyla, en çok 300 karakter; site adı og:site_name. İkon en çok 64 KB'lık PNG, ICO, JPEG, GIF ya da WebP olur (SVG hiç kullanılmaz) ve data: URI olarak döner; bulunamazsa null.çiçek.com.tr): alan adı punycode'a, geri kalanı yüzde kodlamasına çevrilir.url
string
query
zorunlu
Önizlenecek adres, yüzde kodlanmış; en çok 2048 karakter
{url, final_url, title, description, site_name, icon}; url sorulduğu gibi, final_url yönlendirmelerden sonraki adrespreview_unavailable)url yok, http/https değil, port 80/443 değil, kullanıcı/şifre içeriyor, çok uzun ya da hedef adres yasaklı (invalid_url)rate_limited)curl https://mskop-api.gurerlabs.com/api/link-preview?url=https://ornek.com/haber/derbi-sonrasi \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/analytics/events
Uygulamanın yerel kuyruğundaki Keşfet olaylarını tek pakette yükler; olaylar yalnız eklenir ve saatlik bir iş onları kişi başına bir ilgi profiline çevirir (istek anında hiçbir şey puanlanmaz). Geçersiz olaylar hata vermez, sessizce düşer ve ignored içinde sayılır; aynı id ikinci kez gelirse saklanmaz, duplicates olarak sayılır. Hesapta personalized_ads: false ise paket kabul edilir ama hiçbir şey saklanmaz: 200 {accepted: 0, duplicates: 0, ignored: n}.
{id, type, at, topic?, category?, entry_id?, author_id?, source?, duration_ms?, platform?}.id: istemcinin ürettiği kimlik (ör. UUID v4), 1–64 karakter, yalnız [A-Za-z0-9_-]. Tekilleştirme hesap + id üzerinden yapılır; paket içindeki tekrar da duplicates sayılır.type ve zorunlu alanı: topic_open için topic; entry_open için entry_id; entry_read için entry_id ve duration_ms; category_open için category.at: olayın anı, ms epoch; son 30 gün ile 5 dk ileri arasında olmalı, yoksa olay düşer.topic küçük harfe çevrilir ve baştaki # atılır (en çok 120 karakter); category en çok 64 karakter; entry_id pozitif tam sayı; author_id UUID; source en çok 32 karakter (ör. topic_list, chat_card, my_entries, link); duration_ms 6 saatle sınırlanır. topic, category ve author_id ipucudur: iş kategoriyi sözlükten kendisi çözer.platform oturumun platformundan (PUT /api/me/device) yazılır; oturum bildirmediyse olaydaki platform (android | ios) kullanılır.413, rate limit'e sayılmaz). Dakikada 30 paket sınırı personalized_ads kapalıyken de işler.events
object[]
body
zorunlu
En çok 100 olay; şekil ve kurallar aşağıda
{accepted, duplicates, ignored} — yeni saklanan, zaten var olan ve düşen olay sayılarıevents listesi yok (invalid_request)too_many_events)rate_limited)curl -X POST https://mskop-api.gurerlabs.com/api/analytics/events \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"events":[{"at":1791967272345,"category":"spor","id":"0b6f1c2e-7d4a-4e9b-8c3f-1a2b3c4d5e6f","source":"gundem","topic":"derbi","type":"topic_open"},{"at":1791967280112,"author_id":"f6cad462-3b1e-4d6a-9a77-2c1e0b8f4d21","category":"spor","entry_id":7341,"id":"4e8a2d7c-1f3b-4c6e-9a0d-5b7c9e1f3a2d","source":"topic_list","topic":"derbi","type":"entry_open"},{"at":1791967334112,"author_id":"f6cad462-3b1e-4d6a-9a77-2c1e0b8f4d21","category":"spor","duration_ms":54000,"entry_id":7341,"id":"9c3e5a1b-2d4f-4a6c-8e0b-7d9f1a3c5e7b","topic":"derbi","type":"entry_read"}]}'Keşfet, sözlüğün uygulamadaki yüzüdür. Kategoriler, topic'ler ve makaleler (entry) yönetim konsolunun sözlüğünden okunur; backend bunlara yalnız kendisinin bildiklerini ekler: yazarın güncel rumuzu ve fotoğrafı, tepki sayıları, kaynak grubun tartışması, görüntülenme ve paylaşım sayaçları. Yalnız moderatörün yayımladığı topic ve makaleler görünür. Sunucuda sözlük ayarlı değilse bu gruptaki her uç 404 not_found döner; sözlüğe ulaşılamazsa ya da beklenmedik bir yanıt gelirse 503 sozluk_unavailable (ret değil arıza, tekrar denenebilir). Topic listesi ve etiket önerileri oturumun diliyle (PUT /api/me/device ile bildirilen language) süzülür; dili boş topic'ler her dilde, dil hiç bildirilmediyse tüm topic'ler görünür. Sayfalama limit/offset iledir: topic'ler ve Makalelerim varsayılan 30 (en çok 100), bir topic'in makaleleri varsayılan 20 (en çok 50); geçersiz değerler reddedilmez, sınıra çekilir. Makale kimlikleri tam sayıdır; tüm zamanlar ms epoch'tur.
/api/discover/categories
Keşfet'in kategori çiplerini konsoldaki sırasıyla döner; arşivlenmiş kategoriler gelmez. Topic listesini süzmek için slug kullanılır.
{categories: [{slug, name}]}not_found)sozluk_unavailable)curl https://mskop-api.gurerlabs.com/api/discover/categories \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/discover/topics
Yayımlanmış topic'leri makale sayısına göre çoktan aza döner. Her topic'in yanında share (bu süzgeçteki tüm yayımlanmış makalelerin yüzdesi, 2 hane) ve listedeki sırası rank (offset'ten devam eder) gelir. Oturumun diliyle süzülür.
category
string
query
isteğe bağlı
Yalnız bu kategorinin topic'leri (kategori slug'ı)
limit
integer
query
isteğe bağlı
Sayfa boyu; varsayılan 30, en çok 100
offset
integer
query
isteğe bağlı
Atlanacak kayıt sayısı; varsayılan 0
{topics: [topic], total, has_more}not_found)sozluk_unavailable)curl https://mskop-api.gurerlabs.com/api/discover/topics?category=spor&limit=30&offset=0 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/discover/topics/suggest
Makale yazarken hashtag alanının önerileri: etiketi ya da başlığının bir kelimesi q ile başlayan en çok 5 yayımlanmış topic, makale sayısına göre çoktan aza. q'nun başındaki # atılır; q boşsa en popüler 5 topic gelir. Oturumun diliyle süzülür.
q
string
query
isteğe bağlı
Yazılan etiketin başı
{topics: [{tag, title, entry_count}]}, en çok 5not_found)sozluk_unavailable)curl https://mskop-api.gurerlabs.com/api/discover/topics/suggest?q=der \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/discover/topics/{tag}
Tek bir yayımlanmış topic'i döner. Liste dışında sorulduğu için share her zaman 0.0, rank her zaman null'dır. Yayımlanmamış ya da bilinmeyen etiket 404 döner; bu uç dil süzgeci uygulamaz.
tag
string
path
zorunlu
Topic'in etiketi (küçük harf, # olmadan)
{topic}not_found)sozluk_unavailable)curl https://mskop-api.gurerlabs.com/api/discover/topics/derbi \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/discover/topics/{tag}/entries
Bir topic'in yayımlanmış makalelerini tam makale nesnesiyle döner. new (varsayılan) yayın tarihine göre yeniden eskiye, old tersi, top toplam tepki sayısına göre (eşitlikte yeni olan önce) sıralar; tanınmayan sort new sayılır. Yanıtta total yoktur, devamı has_more ile anlaşılır.
tag
string
path
zorunlu
Topic'in etiketi
sort
string
query
isteğe bağlı
new | old | top
limit
integer
query
isteğe bağlı
Sayfa boyu; varsayılan 20, en çok 50
offset
integer
query
isteğe bağlı
Atlanacak kayıt sayısı; varsayılan 0
{entries: [entry], has_more}not_found)sozluk_unavailable)curl https://mskop-api.gurerlabs.com/api/discover/topics/derbi/entries?sort=new&limit=20&offset=0 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/discover/entries/{id}
Tek bir yayımlanmış makaleyi döner; sohbetteki makale kartı ve sözlük linki buraya açılır. blocks makalenin grupta yazıldığı hâlidir; kaynak mesaj silinmişse null ve media: [] olur, uygulama o zaman body'yi çizer. discussion.available kaynak mesaj hâlâ odadaysa ve grup açıksa ya da okuyan üyeyse true olur.
reactions yalnız emoji başına sayıdır; kimin tepki verdiği hiçbir zaman dönmez.author.avatar yazarın fotoğraf görünürlük ayarına uyar; gizliyse null. media ve avatar linkleri 1 saatlik presigned GET'lerdir.reshare_count: kökü bu makalenin mesajı olan iletiler ile bu makalenin sohbet kartlarının toplamı (silinenler hariç).stats_visible: okuyan yazarsa ya da kaynak grup açıksa true; GET /api/discover/entries/{id}/stats için.id
integer
path
zorunlu
Makalenin (entry) kimliği
{entry}not_found)sozluk_unavailable)curl https://mskop-api.gurerlabs.com/api/discover/entries/7341 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/discover/entries/{id}/discussion
Kaynak gruptaki makale mesajının altındaki tartışmayı, gruba katılmadan okumak için döner: root makale mesajı, messages yanıtlar (eskiden yeniye), şekil socket'teki mesajla aynı. Grup açıksa herkes, kapalıysa yalnız üyeler okuyabilir. Üye olan uygulama tartışmaya her zamanki gibi socket'ten yazar; bu uç yalnız okumak içindir.
id
integer
path
zorunlu
Makalenin (entry) kimliği
limit
integer
query
isteğe bağlı
En çok kaç yanıt; varsayılan 100, 1–200
{room: {slug, name, visibility}, is_member, root, messages}not_member)not_found)sozluk_unavailable)curl https://mskop-api.gurerlabs.com/api/discover/entries/7341/discussion?limit=100 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/discover/entries/{id}/view
Makale kartı ekranda yaklaşık 1 sn kalınca çağrılır. Kişi + makale + gün (UTC) başına bir kez sayılır; aynı gün tekrar çağırmak zararsızdır. Gövde yoktur; sözlüğe gidilmez ve makalenin varlığı denetlenmez, yalnız id'nin pozitif tam sayı olması istenir.
id
integer
path
zorunlu
Makalenin (entry) kimliği
id pozitif tam sayı değil, ya da sunucuda sözlük ayarlı değil (not_found)curl -X POST https://mskop-api.gurerlabs.com/api/discover/entries/7341/view \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/discover/entries/{id}/share
Makale bir sohbete iletildiğinde (forward) ya da linki kopyalandığında (link) çağrılır; her çağrı ayrı bir paylaşım olarak sayılır ve istatistikteki shares alanına yansır. Makalenin varlığı denetlenmez. İletinin kendisi socket'ten attachment: {type: "entry", entry_id} ile gider; bu uç yalnız sayaçtır.
id
integer
path
zorunlu
Makalenin (entry) kimliği
via
string
body
zorunlu
forward (sohbete iletme) | link (link kopyalama)
via yok ya da forward / link değil (invalid_request)id pozitif tam sayı değil, ya da sunucuda sözlük ayarlı değil (not_found)curl -X POST https://mskop-api.gurerlabs.com/api/discover/entries/7341/share \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"via":"link"}'/api/discover/entries/{id}/stats
Makalenin sayılarını döner: görüntülenme (views toplam, viewers tekil kişi), tepkiler, tartışmadaki yanıtlar, yeniden paylaşımlar ve paylaşım sayaçları. Yazar her zaman görebilir; başkaları yalnız kaynak grup açıksa (makaledeki stats_visible). Kapalı grubun makalesi herkese açık okunur ama üyelerinin tepkisi grubun kendisinindir.
id
integer
path
zorunlu
Makalenin (entry) kimliği
{views, viewers, reactions, reaction_breakdown, replies, reshares, shares: {forward, link}, published_at}forbidden)not_found)sozluk_unavailable)curl https://mskop-api.gurerlabs.com/api/discover/entries/7341/stats \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/discover/me/entries
Ben → Makalelerim: kişinin sözlüğe gönderdiği her makale, durumu ne olursa olsun (pending, published, rejected). Reddedilenlerde review_note moderatörün notudur. Yalnız published olanlar ayrıca excerpt, blocks, media ve reshare_count taşır; bekleyen ve reddedilende bu alanlar hiç yoktur.
limit
integer
query
isteğe bağlı
Sayfa boyu; varsayılan 30, en çok 100
offset
integer
query
isteğe bağlı
Atlanacak kayıt sayısı; varsayılan 0
{entries: [...], total}not_found)sozluk_unavailable)curl https://mskop-api.gurerlabs.com/api/discover/me/entries?limit=30&offset=0 \ -H "Authorization: Bearer $ACCESS_TOKEN"
Sohbet listesindeki ve Keşfet'teki sponsorlu satırlar. Satırları organizasyonlar işletme panelinde yazar, konsolda onaylanınca yayına girer; uygulama gösterilebilecekleri buradan ister, nereye koyacağına kendisi karar verir ve olanı (gösterim, dokunma, gizleme) geri bildirir. Üç yerleşim vardır: chats (sohbet listesi), discover_topics (Keşfet topic listesi) ve discover_entries (topic'in makale listesi). Makroskop Premium hesaplarına hiçbir zaman satır gelmez. Hedefleme cihazın dili ve platformu (PUT /api/me/device) ile isteğe bağlı anonim bir kitledir; kitle bilgisi uygulamaya hiç dönmez.
/api/sponsored
Bu kişiye bu cihazda, bu yerleşimde şu an gösterilebilecek yayındaki satırları döner. Kitlesi olan (hedefli) satır yalnız ilgi profili eşleşen kişiye gelir ve önde sıralanır, sonra hedefsizler; her grupta bu yerleşimde bugün görülmemiş olanlar önce, gerisi rastgele. Profili olmayan ya da personalized_ads: false kişi yalnız hedefsiz satırları görür; gizlenen (hide) satırlar hiç gelmez.
placement ya da sayı olmayan / 1'den küçük limit 400 döner. 5'ten büyük limit 5'e indirilir.tr ve android varsayılır.image_url ve thumb_url 1 saatlik presigned GET'lerdir; resim yoksa null. thumb_url küçük kopya yoksa tam boy resme düşer.target_kind: url (https adresi), room (bir grubun slug'ı) ya da deeplink. Hedef click yanıtında da döner.placement
string
query
isteğe bağlı
chats (varsayılan) | discover_topics | discover_entries
limit
integer
query
isteğe bağlı
En çok kaç satır; varsayılan 3, en çok 5
{items: [...]}; Premium'da ya da uygun satır yoksa boş listeplacement ya da limit (invalid_request)curl https://mskop-api.gurerlabs.com/api/sponsored?placement=chats&limit=3 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/sponsored/{id}/impression
Satır ya da kart yarısı ekranda 1 sn kalınca çağrılır. Kişi + satır + gün + yerleşim başına yalnız ilk çağrı sayılır ve organizasyonun gösterim kredisinden bir düşer; tekrarlar da 204 döner, uygulamanın kontrol etmesine gerek yoktur. Satır bütçesine ulaşınca yayından kalkar; organizasyonun kredisi biterse tüm satırları duraklatılır.
id
uuid
path
zorunlu
Sponsorlu satırın kimliği
placement
string
body
isteğe bağlı
Gösterildiği yer: chats (varsayılan) | discover_topics | discover_entries
placement (invalid_request)not_found)curl -X POST https://mskop-api.gurerlabs.com/api/sponsored/2f9c4e1a-8b3d-4a6f-9c2e-5d7a1b3c9e4f/impression \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"placement":"chats"}'/api/sponsored/{id}/click
Satıra dokunulduğunda çağrılır ve gidilecek hedefi döner; uygulama target_kind'e göre linki, grubu ya da deeplink'i açar. Tıklama yalnız o gün o satır için bir gösterim sayılmışsa ve kişi + gün + yerleşim başına bir kez sayılır; placement verilmezse bugün görüldüğü herhangi bir yerleşim kullanılır. Az önce duraklatılan ya da biten satırda da hedef döner, böylece dokunuş boşa gitmez.
id
uuid
path
zorunlu
Sponsorlu satırın kimliği
placement
string
body
isteğe bağlı
Dokunulduğu yer: chats | discover_topics | discover_entries
{target_kind, target}placement (invalid_request)not_found)curl -X POST https://mskop-api.gurerlabs.com/api/sponsored/2f9c4e1a-8b3d-4a6f-9c2e-5d7a1b3c9e4f/click \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"placement":"chats"}'/api/sponsored/{id}/hide
Satırın ⋮ menüsündeki "Bunu gösterme": bu satır bu kişiye bir daha hiçbir yerleşimde gelmez. Gövde yoktur; aynı satırı ikinci kez gizlemek zararsızdır. Uygulama satırı yanıtı beklemeden listeden kaldırabilir.
id
uuid
path
zorunlu
Sponsorlu satırın kimliği
id UUID değil (not_found)curl -X POST https://mskop-api.gurerlabs.com/api/sponsored/2f9c4e1a-8b3d-4a6f-9c2e-5d7a1b3c9e4f/hide \ -H "Authorization: Bearer $ACCESS_TOKEN"
İşletme paneli (mk-panel), uygulamadaki hesabın bir cihazı gibi çalışır. Kişi panele GlobalTrustID ile girer; bu giriş henüz bir hesaba bağlı değilse panel bir QR gösterir (app.gurerlabs.makroskop://panel-link?code=KOD). Uygulama QR'ı okutur, bu gruptaki uçlarla kimin bağlanmak istediğini gösterir ve kişiden onay alır. Ardından panel kendi oturumunu alır: telefondakiyle aynı türden bir token çifti (platform: "web_app"). Kod 180 saniye geçerlidir ve tek kullanımlıktır. Aynı GlobalTrustID girişi daha sonra QR istemeden doğrudan hesaba bağlanır. Bu uçları uygulama, kişinin kendi token'ıyla çağırır. Rumuz seçilmiş olmalıdır (403 username_required).
/api/panel-links/{code}
Uygulama QR'ı okuttuktan sonra, onay ekranını çizmek için bu ucu çağırır. Ekranda panelin hangi tarayıcıdan açıldığı (label) ve GlobalTrustID girişindeki maskeli ad (name_hint) gösterilir. Bu çağrı kodu harcamaz; kod ancak onaylanınca kullanılmış sayılır.
label ve name_hint paneli çalıştıran sunucudan gelir ve null olabilir. Uygulama bu durumda genel bir metin göstermelidir.expires_in, kodun kaç saniye daha geçerli olduğunu söyler. Onay ekranında geri sayım göstermek için kullanılabilir.code
string
path
zorunlu
QR'daki code değeri: 32 karakterlik base64url metin
unauthorized) ya da süresi dolmuş (token_expired)username_required)not_found)already_used)expired); panel yeni bir QR göstermelicurl https://mskop-api.gurerlabs.com/api/panel-links/517A05VtAO4pdsc4O3HsRSaz6LVNmoM8 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/panel-links/{code}/confirm
Kişi onay ekranında "Evet" dediğinde çağrılır. Panelin GlobalTrustID girişini, token'ın sahibi olan hesaba bağlar. Gövde yoktur. Panel bir sonraki yoklamasında kendi oturumunu alır; bu oturum yalnız bir kez teslim edilir ve ardından kod harcanmış olur.
sub değeri ve kodun kendisi saklanmaz; koddan yalnız SHA-256 özeti tutulur.409 already_used döner.code
string
path
zorunlu
QR'daki code değeri
unauthorized) ya da süresi dolmuş (token_expired)username_required)not_found)already_used)expired)curl -X POST https://mskop-api.gurerlabs.com/api/panel-links/517A05VtAO4pdsc4O3HsRSaz6LVNmoM8/confirm \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/me/panels
Hesaba bağlı web panellerini en yenisi başta olacak şekilde listeler. Uygulamadaki "Bağlı cihazlar" ekranı bu listeyle çizilir. Kişi buradan bir paneli seçip bağını koparabilir.
linked_at ve last_used_at ms epoch değerleridir. last_used_at, panelin bu bağla en son oturum açtığı anı gösterir; panel henüz oturum almadıysa null olabilir.label, bağlanırken bildirilen tarayıcıdır (en çok 64 karakter) ve null olabilir.unauthorized) ya da süresi dolmuş (token_expired)username_required)curl https://mskop-api.gurerlabs.com/api/me/panels \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/me/panels/{id}
Paneli hesaptan ayırır. O panelin bütün oturumları aynı anda silinir. Panelin elindeki access token'ın süresi dolmamış olsa bile, /api/panel/* uçlarına yapacağı bir sonraki istek 401 alır; refresh token'ı da artık çalışmaz. Aynı GlobalTrustID girişiyle yeniden bağlanmak için QR adımı baştan yapılmalıdır.
id
uuid
path
zorunlu
GET /api/me/panels listesindeki id
unauthorized) ya da süresi dolmuş (token_expired)username_required)id UUID değil (not_found)curl -X DELETE https://mskop-api.gurerlabs.com/api/me/panels/c11debb6-9789-4fdb-ab77-fad368336eac \ -H "Authorization: Bearer $ACCESS_TOKEN"
Bu uçlar işletme panelinin (mk-panel) kendi API'sidir. Her istek, panel bağlamayla alınmış oturumun access token'ını taşır (Authorization: Bearer ACCESS_TOKEN); token'ın süresi dolunca POST /api/auth/refresh ile yenilenir. Sunucu her istekte oturumun hâlâ var olup olmadığına bakar. Kişi uygulamadan panelin bağını koparırsa, token'ın süresi dolmamış olsa bile bir sonraki istek hemen 401 unauthorized alır. Rumuz seçilmiş olmalıdır (403 username_required). Organizasyon gerektiren uçlar, kişinin organizasyonu yoksa 404 no_organization döner. Organizasyonu owner ve admin rolleri yönetir; sponsorlu içeriği owner, admin ve ads rolleri yapar. Bu rollerin dışında kalanlar 403 not_allowed alır. Bu gruptaki bütün zamanlar ms epoch'tur.
/api/panel/me
Panelin bütün sayfaları bu tek yanıttan beslenir. Yanıtta kimin oturum açtığı, organizasyonu ve oradaki rolü, organizasyonun paketi ve kalan kredileri bulunur. Formların seçim listeleri (catalog) ve satın alınabilecek paketler (products) de lang diliyle adlandırılmış olarak gelir.
organization ve role alanları null gelir. Panel bu durumda organizasyon kurma formunu göstermelidir.billing yalnız şirket organizasyonlarında ve yalnız owner ya da admin rolüne gelir; diğer durumlarda null olur.slug_editable, organizasyonun hiç odası yokken true olur. İlk oda kurulunca önek (slug) kilitlenir.subscription yürürlükteki pakettir, yoksa null olur. pending_request, konsolun onayını bekleyen paket isteğidir, yoksa null olur. balances alanında her sayaç (message, ai, impression, verification) her zaman bulunur.price_cents girilen fiyattır; net_cents ve vat_cents faturada yazacak tutarlardır. Bir çeviri eksikse önce İngilizcesi, o da yoksa Türkçesi gösterilir.lang
string
query
isteğe bağlı
tr ya da en. Verilmezse ya da başka bir değerse tr kullanılır
unauthorized), ya da token'ın süresi dolmuş (token_expired)username_required)curl https://mskop-api.gurerlabs.com/api/panel/me?lang=tr \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/panel/organization
Kişinin organizasyonunu kurar ve kişiyi organizasyonun sahibi (owner) yapar. Bir kişinin en fazla bir organizasyonu olabilir. Organizasyon iki türlü kurulur: individual (bireysel) ya da company (şirket). Örnek gövde bir şirket içindir; bireysel kurulumun gövdesi aşağıdaki notlardadır.
{"kind": "individual", "display_name": "Ayşe Yılmaz Tasarım", "purpose": "Müşterilerime iş takibi ve duyuru", "position_id": "POSITION_ID"}. Bireysel organizasyonda type_id, team_size ve billing alanlarına bakılmaz.type_id ve billing zorunludur. billing alanlarından legal_name, tax_office, tax_id, address, city ve country (ISO-2, ör. TR) zorunludur; district, region, postal_code ve contact_phone isteğe bağlıdır. Her alan kırpılır ve en çok 200 karaktere kısaltılır.tax_id ya kontrol basamağı tutan 10 haneli bir VKN ya da şahıs şirketi için 11 haneli bir TCKN olmalıdır; aksi hâlde 422 invalid_tax_id döner. Başka ülkelerde 2–32 harf ve rakamdan oluşmalıdır. contact_phone içindeki boşluk, parantez, nokta ve tire atılır; kalan kısım 7–20 rakam olmalıdır (başta + olabilir).slug (organizasyon öneki) Makroskop genelinde tekildir. Önce kırpılır ve küçük harfe çevrilir, sonra ^[a-z0-9]+(-[a-z0-9]+)*$ biçimine uyan 3–48 karakter olmalıdır. Ayrılmış kelimeler (admin api app console destek help konsol official panel resmi root sozluk support system www) ve makroskop ile başlayan önekler 422 invalid_slug alır. Önek boş bırakılırsa görünen addan üretilir; o önek alınmışsa sonuna -2, -3 eklenir.POST /api/panel/organization/package ile istenir.lang
string
query
isteğe bağlı
Yanıttaki paket adlarının dili: tr (varsayılan) ya da en
kind
string
body
zorunlu
individual ya da company. Sonradan değiştirilemez
display_name
string
body
zorunlu
Görünen ad, 2–80 karakter (kırpılır)
purpose
string
body
zorunlu
Organizasyonun ne için kullanılacağı, en çok 1000 karakter
position_id
uuid
body
isteğe bağlı
Yalnız individual için: catalog.positions listesindeki bir id
type_id
uuid
body
isteğe bağlı
company için zorunlu: catalog.organization_types listesindeki bir id
team_size
integer
body
isteğe bağlı
Yalnız company için: ekip büyüklüğü, 1–20
billing
object
body
isteğe bağlı
company için zorunlu: fatura bilgileri (alanlar notlarda)
slug
string
body
isteğe bağlı
Organizasyon öneki, 3–48 karakter; verilmezse görünen addan üretilir
organization ve role: "owner" döner (GET /api/panel/me ile aynı şekil)kind, katalogda olmayan type_id/position_id, aralık dışında team_size, bozuk country ya da contact_phone (invalid_request)unauthorized), ya da token'ın süresi dolmuş (token_expired)username_required)already_in_organization) ya da önek başkasında (slug_taken)invalid_tax_id) ya da önek kurallara uymuyor (invalid_slug)curl -X POST https://mskop-api.gurerlabs.com/api/panel/organization \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"billing":{"address":"Caferağa Mah. Moda Cad. No: 12","city":"İstanbul","contact_phone":"+90 216 555 01 01","country":"TR","district":"Kadıköy","legal_name":"Kargo Lojistik Anonim Şirketi","postal_code":"34710","tax_id":"4829157365","tax_office":"Kadıköy"},"display_name":"Kargo A.Ş.","kind":"company","purpose":"Müşterilerimize gönderilerinin durumunu anında bildirmek ve kampanyalarımızı duyurmak.","team_size":5,"type_id":"870ce7d4-33be-4603-b23c-c5aa9d6e123d"}'/api/panel/organization
Organizasyonun kendisi hakkında söylediklerini değiştirir. Alanlar kuruluştakilerle aynıdır ve hepsi isteğe bağlıdır; gönderilmeyen alan olduğu gibi kalır. kind hiçbir zaman değişmez. Şirket organizasyonunda billing içinde gönderilen alanlar eskilerinin yerine yazılır; diğer fatura alanları korunur.
slug) yalnız slug_editable iken, yani organizasyonun hiç odası yokken değiştirilebilir. Odası varken farklı bir önek göndermek 409 slug_locked döner. Organizasyonun zaten sahip olduğu öneki göndermek değişiklik sayılmaz.429 rate_limited döner. Böylece başkalarının hangi önekleri aldığı tek tek denenerek bulunamaz.position_id ya da type_id için boş metin ya da null göndermek o alanı temizler.lang
string
query
isteğe bağlı
Yanıttaki paket adlarının dili: tr (varsayılan) ya da en
display_name
string
body
isteğe bağlı
Görünen ad, 2–80 karakter
purpose
string
body
isteğe bağlı
En çok 1000 karakter
position_id
uuid
body
isteğe bağlı
Yalnız individual için; catalog.positions listesinden
type_id
uuid
body
isteğe bağlı
Yalnız company için; catalog.organization_types listesinden
team_size
integer
body
isteğe bağlı
Yalnız company için; 1–20
billing
object
body
isteğe bağlı
Yalnız company için; değişecek fatura alanları
slug
string
body
isteğe bağlı
Yeni önek; kurallar kuruluştakiyle aynı
organization ve role dönerinvalid_request)unauthorized), ya da token'ın süresi dolmuş (token_expired)owner ya da admin değil (not_allowed), ya da rumuz seçilmemiş (username_required)no_organization)slug_locked), ya da önek başkasında (slug_taken)invalid_slug) ya da vergi numarası geçersiz (invalid_tax_id)rate_limited)curl -X PATCH https://mskop-api.gurerlabs.com/api/panel/organization \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"billing":{"address":"Rasimpaşa Mah. İskele Sok. No: 4","postal_code":"34716"},"team_size":8}'/api/panel/organization/package
Organizasyon için bir paket ister. Ücretsiz paket hemen açılır: yürürlükteki paket biter ve sayaçlar yeni paketin kotalarına ayarlanır (üstüne eklenmez). Ücretli paket ödeme altyapısı olmadığı için konsolun onayını bekler; bu sürede pending_request alanında görünür. Yeniden paket istemek önceki bekleyen isteğin yerine geçer.
lang
string
query
isteğe bağlı
Yanıttaki paket adlarının dili: tr (varsayılan) ya da en
product_id
uuid
body
zorunlu
products listesindeki bir paketin id'si
organization ve role dönerproduct_id gönderilmedi (invalid_request)unauthorized), ya da token'ın süresi dolmuş (token_expired)owner ya da admin değil (not_allowed), ya da rumuz seçilmemiş (username_required)no_organization), ya da paket bilinmiyor veya satışta değil (not_found)curl -X POST https://mskop-api.gurerlabs.com/api/panel/organization/package \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"product_id":"44b16db2-bbff-46d1-903f-c5682075a8a6"}'/api/panel/usage
Organizasyonun her sayaçta kalan kredisini ve kredi hareketlerinin en yeni 50 kaydını döner. Paketten ya da konsoldan gelen krediler pozitif, harcamalar negatif quantity ile yazılır. Bakiye hızlı cevaptır; asıl kayıt hareketlerdir.
source değerleri: grant:package (paket açıldı; note paketin slug'ı), grant:manual (konsoldan ek kredi), impression (bir sponsorlu gösterim için harcanan kredi).message, ai, impression, verification.unauthorized), ya da token'ın süresi dolmuş (token_expired)username_required)no_organization)curl https://mskop-api.gurerlabs.com/api/panel/usage \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/panel/groups
Kişinin kurduğu (founded) ve yönettiği (administered) grupları döner. Her grup, uygulamadaki oda nesnesiyle aynı şekildedir; ek olarak panelde seçilen grup türünü taşıyan group_type_id alanı vardır. Uygulamadan kurulmuş gruplarda bu alan null gelir. Bu uç organizasyon istemez.
unauthorized), ya da token'ın süresi dolmuş (token_expired)username_required)curl https://mskop-api.gurerlabs.com/api/panel/groups \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/panel/groups
Panelden yeni bir grup kurar; kurucusu oturumu açan kişidir. Uygulamadaki oda kurmanın aynısıdır, ancak burada grup türü (group_type_id) zorunludur. Grup kurulunca uygulamada da kişinin oda listesinde görünür.
slug verilmezse addan üretilir; üretilen slug alınmışsa sonuna rastgele bir ek konur. Açıkça verilen bir slug alınmışsa 422 validation_failed döner (fields.slug).name
string
body
zorunlu
Grup adı, 1–80 karakter
group_type_id
uuid
body
zorunlu
catalog.group_types listesindeki bir id
slug
string
body
isteğe bağlı
3–48 karakter, ^[a-z0-9]+(-[a-z0-9]+)*$
visibility
string
body
isteğe bağlı
open (varsayılan: bağlantıyı bilen katılır) ya da closed (kişiyi bir yönetici ekler)
welcome_message
string
body
isteğe bağlı
Yeni üyeye odanın yazacağı karşılama metni, en çok 500 karakter; {username} rumuzla değiştirilir
room döner (my_role: "founder", member_count: 1, group_type_id)group_type_id yok ya da katalogda değil (invalid_request)unauthorized), ya da token'ın süresi dolmuş (token_expired)username_required)validation_failed)curl -X POST https://mskop-api.gurerlabs.com/api/panel/groups \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"group_type_id":"3b9f6c0e-5d21-4a8e-9c47-1e2f8a6b7d30","name":"Kargo Destek","visibility":"open","welcome_message":"Hoş geldin {username}! Gönderi numaranı yaz, hemen bakalım."}'/api/panel/sponsored
Organizasyonun bütün sponsorlu satırlarını, en yenisi başta olacak şekilde döner. Her satırın durumu, bütçesi, gösterim ve tıklama sayıları ve hedef kitlesi yanıtta bulunur. Görsel linkleri kısa ömürlü, imzalı GET adresleridir.
draft (taslak), review (konsolun onayını bekliyor), live (yayında), paused (duraklatıldı), rejected (reddedildi; sebep reject_reason alanında), ended (bütçe doldu).budget satırın en çok kaç gösterim alacağıdır. Gösterim sayısı bütçeye ulaşınca satır ended olur. Organizasyonun impression kredisi biterse yayındaki bütün satırları paused olur.audience her zaman bir nesnedir. Hedefsiz bir satırda {"interests": [], "activity": "any", "segments": []} gelir.unauthorized), ya da token'ın süresi dolmuş (token_expired)username_required)no_organization)curl https://mskop-api.gurerlabs.com/api/panel/sponsored \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/panel/sponsored
Yeni bir sponsorlu satırı taslak (draft) olarak oluşturur. Taslak yayına kendiliğinden çıkmaz: önce submit ile incelemeye gönderilir, konsol onaylayınca yayına girer. Organizasyonun paketinde sponsored özelliği bulunmalı ve organizasyon askıya alınmamış olmalıdır.
url yalnız https:// adresi olabilir (kullanıcı bilgisi içermemeli, alan adında nokta olmalı). room var olan bir grubun slug'ı olmalıdır. deeplink şema://… biçiminde olmalıdır; javascript, data, file, content, intent, about, blob ve vbscript şemaları yasaktır. target en çok 500 karakterdir.POST /api/panel/sponsored/media ile yüklenir; dönen key burada image_key, küçük kopyanınki thumb_key olarak verilir. Anahtar organizasyonun kendi sponsored/ORG_ID/ önekinde olmalıdır.audience: interests sözlüğün kategori slug'larıdır (en çok 20); kişinin ilgi alanlarından herhangi biri eşleşmelidir. activity en düşük etkinlik seviyesidir (any, low, medium, high). segments listesindeki bütün segmentler kişide bulunmalıdır. Hepsi boşsa hedefleme yapılmaz ve satır herkese gösterilir. Seçenekler GET /api/panel/sponsored/audience-options ile alınır.languages ve platforms boş bırakılırsa satır bütün dillerde ve platformlarda gösterilir. starts_at ve ends_at ms epoch'tur; ends_at, starts_at'ten sonra olmalıdır.budget değeri gönderilmezse 0 kalır; bu durumda submit reddedilir.title
string
body
zorunlu
Başlık, 2–60 karakter
body
string
body
zorunlu
Metin, 2–140 karakter
target_kind
string
body
zorunlu
url, room ya da deeplink
target
string
body
zorunlu
Hedef: https adresi, grup slug'ı ya da derin bağlantı; en çok 500 karakter
image_key
string
body
isteğe bağlı
sponsored/media yanıtındaki key
thumb_key
string
body
isteğe bağlı
Küçük kopyanın key değeri
languages
string[]
body
isteğe bağlı
tr, en; boş liste bütün diller demektir
platforms
string[]
body
isteğe bağlı
android, ios; boş liste bütün platformlar demektir
budget
integer
body
isteğe bağlı
En çok gösterim sayısı, 100–10.000.000
starts_at
ms
body
isteğe bağlı
Yayın başlangıcı (ms epoch) ya da null
ends_at
ms
body
isteğe bağlı
Yayın bitişi (ms epoch) ya da null; başlangıçtan sonra olmalı
audience
object
body
isteğe bağlı
Hedef kitle {interests, activity, segments}; null herkes demektir
item dönerinvalid_request)unauthorized), ya da token'ın süresi dolmuş (token_expired)not_allowed), pakette sponsored özelliği yok (feature_unavailable), organizasyon askıda (organization_suspended), ya da rumuz seçilmemiş (username_required)no_organization)invalid_audience)sozluk_unavailable)curl -X POST https://mskop-api.gurerlabs.com/api/panel/sponsored \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"audience":{"activity":"medium","interests":["teknoloji","ekonomi"],"segments":["group_active"]},"body":"Gönderi numaranı Kargo Destek grubuna yaz, durumunu saniyeler içinde söyleyelim.","budget":5000,"ends_at":1795132800000,"image_key":"sponsored/e5b8ec80-e426-4e4f-b6e4-dea3da782ba5/5705db63-17b2-4109-88fa-c367bb9c3111.webp","languages":["tr"],"starts_at":1792454400000,"target":"kargo-destek","target_kind":"room","thumb_key":"sponsored/e5b8ec80-e426-4e4f-b6e4-dea3da782ba5/961cb17c-f383-413b-9a36-bc720cf19a2d.webp","title":"Kargon nerede, anında öğren"}'/api/panel/sponsored/media
Sponsorlu satırın görselini sunucuya yükler. İstek gövdesi JSON değildir; doğrudan resmin baytlarıdır ve türü Content-Type başlığında bildirilir. Her satır için iki kez çağrılır: biri asıl görsel, diğeri küçük kopya (yaklaşık 160 px, kare). Dönen key değerleri taslağın image_key ve thumb_key alanlarına yazılır.
image/jpeg, image/png ve image/webp'tir; boyut en çok 2 MB olabilir. Sunucu baytların gerçekten bildirilen türde olup olmadığını kontrol eder. Uyuşmazsa, dosya boşsa ya da 2 MB'ı aşıyorsa 422 invalid_media döner.sponsored/ORG_ID/ önekine rastgele bir adla kaydedilir. Hiçbir taslağa bağlanmayan dosya kendiliğinden silinmez.sponsored özelliği bulunmalı ve organizasyon askıda olmamalıdır.{key, content_type, byte_size} dönerinvalid_request)unauthorized), ya da token'ın süresi dolmuş (token_expired)not_allowed), pakette sponsored özelliği yok (feature_unavailable), organizasyon askıda (organization_suspended), ya da rumuz seçilmemiş (username_required)no_organization)invalid_media)storage_unavailable)curl -X POST https://mskop-api.gurerlabs.com/api/panel/sponsored/media \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type: image/webp" \ --data-binary @gorsel.webp
Bu uç gövde olarak resmin ham baytlarını bekler. Sayfadaki form yalnız JSON gönderebildiği için buradan denenemez; örnekteki curl --data-binary komutunu kullan.
/api/panel/sponsored/audience-options
Sponsorlu formundaki hedef kitle seçeneklerini döner. İlgi alanları sözlüğün kategorileridir. Segmentler ve etkinlik seviyeleri hem Türkçe hem İngilizce etiketle gelir. Reklamveren tek bir kişiyi değil, yalnız anonim bir kitleyi hedefleyebilir.
unauthorized), ya da token'ın süresi dolmuş (token_expired)not_allowed) ya da rumuz seçilmemiş (username_required)no_organization)sozluk_unavailable)curl https://mskop-api.gurerlabs.com/api/panel/sponsored/audience-options \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/panel/sponsored/audience-estimate
Bir hedef kitlenin yaklaşık kaç kişiye ulaşacağını tahmin eder. Hedefli kitle, kişiselleştirilmiş reklamı kapatmamış hesapların ilgi profillerinden sayılır. Hedefsiz kitle ise sponsorlu satır görebilen herkesten sayılır; Premium hesaplar ve sistem hesabı bu sayıya girmez. languages ya da platforms verilirse yalnız o dilde ya da platformda oturumu olan kişiler sayılır.
{"estimate": null, "label": "50'den az"} döner.{"estimate": 1200, "label": "≈ 1.200"}.audience
object
body
isteğe bağlı
{interests, activity, segments}; null ya da boş bırakılırsa herkes
languages
string[]
body
isteğe bağlı
tr, en
platforms
string[]
body
isteğe bağlı
android, ios
languages ya da platforms liste değil ya da bilinmeyen değer içeriyor (invalid_request)unauthorized), ya da token'ın süresi dolmuş (token_expired)not_allowed) ya da rumuz seçilmemiş (username_required)no_organization)invalid_audience)sozluk_unavailable)curl -X POST https://mskop-api.gurerlabs.com/api/panel/sponsored/audience-estimate \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"audience":{"activity":"medium","interests":["teknoloji","ekonomi"],"segments":[]},"languages":["tr"]}'/api/panel/sponsored/{id}
Bir sponsorlu satırın alanlarını değiştirir. Alanlar oluşturmadakilerle aynıdır ve hepsi isteğe bağlıdır. Yayındaki, duraklatılmış ya da reddedilmiş bir satırda herhangi bir alan değişirse (hedef kitle dahil) satır taslağa (draft) döner, çünkü onaylanan içerik artık aynı değildir. Bu durumda yeniden submit gerekir.
review ve ended durumundaki satırlar düzenlenemez (409 not_editable).audience: null hedeflemeyi kaldırır ve satır herkese gösterilir. image_key, thumb_key, starts_at ya da ends_at için null göndermek o alanı temizler.reject_reason değerini siler.id
uuid
path
zorunlu
Sponsorlu satırın id'si
title
string
body
isteğe bağlı
2–60 karakter
body
string
body
isteğe bağlı
2–140 karakter
target_kind
string
body
isteğe bağlı
url, room ya da deeplink; target ile birlikte gönderilir
target
string
body
isteğe bağlı
Yeni hedef; target_kind ile birlikte gönderilir
budget
integer
body
isteğe bağlı
100–10.000.000 gösterim
ends_at
ms
body
isteğe bağlı
Yayın bitişi (ms epoch) ya da null
audience
object
body
isteğe bağlı
Yeni hedef kitle ya da null
item dönerinvalid_request)unauthorized), ya da token'ın süresi dolmuş (token_expired)not_allowed) ya da rumuz seçilmemiş (username_required)no_organization), ya da satır yok veya bu organizasyonun değil (not_found)review ya da ended durumunda (not_editable)invalid_audience)sozluk_unavailable)curl -X PATCH https://mskop-api.gurerlabs.com/api/panel/sponsored/42aff321-6614-4a11-921c-eb401d18eb46 \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"audience":{"activity":"any","interests":["teknoloji"],"segments":[]},"budget":8000}'/api/panel/sponsored/{id}
Taslak (draft) ya da reddedilmiş (rejected) bir satırı ve görsellerini siler. Yayında olan, duraklatılmış, incelemedeki ya da bitmiş bir satır silinemez. Böyle bir satırı yayından kaldırmak için pause kullanılır.
id
uuid
path
zorunlu
Sponsorlu satırın id'si
unauthorized), ya da token'ın süresi dolmuş (token_expired)not_allowed) ya da rumuz seçilmemiş (username_required)no_organization), ya da satır yok (not_found)not_editable)curl -X DELETE https://mskop-api.gurerlabs.com/api/panel/sponsored/42aff321-6614-4a11-921c-eb401d18eb46 \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/panel/sponsored/{id}/submit
Taslak ya da reddedilmiş bir satırı konsolun incelemesine (review) gönderir. Konsoldaki editör onaylarsa satır yayına (live) girer; reddederse rejected olur ve sebebi reject_reason alanına yazılır. Satırın bütçesi 0'dan büyük olmalı ve organizasyonun gösterim (impression) kredisi bulunmalıdır.
id
uuid
path
zorunlu
Sponsorlu satırın id'si
item (status: "review") dönerbudget 0) (invalid_request)unauthorized), ya da token'ın süresi dolmuş (token_expired)insufficient_credits)not_allowed), pakette sponsored yok (feature_unavailable), organizasyon askıda (organization_suspended), ya da rumuz seçilmemiş (username_required)no_organization), ya da satır yok (not_found)not_editable)curl -X POST https://mskop-api.gurerlabs.com/api/panel/sponsored/42aff321-6614-4a11-921c-eb401d18eb46/submit \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/panel/sponsored/{id}/pause
Yayındaki (live) bir satırı duraklatır (paused). Duraklatılan satır uygulamalarda gösterilmez ve gösterim kredisi harcamaz. Satırın onayı korunur; satır düzenlenmediği sürece resume ile yeniden incelemeye gitmeden yayına döner.
id
uuid
path
zorunlu
Sponsorlu satırın id'si
item (status: "paused") dönerunauthorized), ya da token'ın süresi dolmuş (token_expired)not_allowed) ya da rumuz seçilmemiş (username_required)no_organization), ya da satır yok (not_found)not_editable)curl -X POST https://mskop-api.gurerlabs.com/api/panel/sponsored/42aff321-6614-4a11-921c-eb401d18eb46/pause \ -H "Authorization: Bearer $ACCESS_TOKEN"
/api/panel/sponsored/{id}/resume
Duraklatılmış (paused) ve daha önce konsolca onaylanmış bir satırı yeniden yayına (live) alır. Organizasyonun gösterim kredisi bulunmalı ve satır bütçesini doldurmamış olmalıdır. Kredi bittiği için sunucunun kendiliğinden duraklattığı satırlar, konsol kredi ekledikten sonra bu çağrıyla yeniden başlatılır.
id
uuid
path
zorunlu
Sponsorlu satırın id'si
item (status: "live") dönerunauthorized), ya da token'ın süresi dolmuş (token_expired)insufficient_credits)not_allowed) ya da rumuz seçilmemiş (username_required)no_organization), ya da satır yok (not_found)not_editable)curl -X POST https://mskop-api.gurerlabs.com/api/panel/sponsored/42aff321-6614-4a11-921c-eb401d18eb46/resume \ -H "Authorization: Bearer $ACCESS_TOKEN"
Mesajlar, okundu bilgileri, tepkiler, yazıyor göstergesi ve çevrimiçi durumu Phoenix Channels üzerinden akar. Adres wss://mskop-api.gurerlabs.com/socket/websocket?token=ACCESS_TOKEN&vsn=2.0.0 şeklindedir. Token başlıkta değil, sorgu dizesinde gönderilir. Long-polling kapalıdır; yalnız WebSocket kullanılır. Her frame bir JSON dizisidir: [join_ref, ref, topic, event, payload]. İstemcinin gönderdiği bir olayın yanıtı aynı ref ile phx_reply olarak gelir: {"status": "ok" | "error", "response": {...}}. Hata yanıtında response.reason bulunur; olaya özgü sebepler kartların notlarındadır. Kimlik her zaman token'dan alınır; payload'daki account_id yok sayılır. Sınırlar: message:new hesap başına 10 saniyede 20 mesajdır, gövde en çok 16 KB olabilir. Tepkiler aynı sınırla ayrı bir kovadan sayılır. Eğik çizgili komutlar hesap, oda ve komut başına dakikada 5 kez çalıştırılabilir. Bilinmeyen bir olay ya da biçimi tutmayan bir payload genellikle unknown_event alır. Hazır istemciler: web için phoenix (npm), Android için JavaPhoenixClient, iOS için SwiftPhoenixClient.
/socket/websocket?token={token}&vsn=2.0.0
Uygulama açıkken tek bir WebSocket bağlantısı tutulur; oda ve kişi kanallarına bu bağlantı üzerinden katılınır. Token yalnız bağlanırken doğrulanır. Açık bağlantı, token'ın süresi dolsa da sürer. Bağlantı koparsa istemci, gerekirse önce token'ı yeniler, sonra taze token'la yeniden bağlanır.
403 ile reddedilir. Bu durumda gövdede hata kodu gelmez; istemci önce POST /api/auth/refresh ile yeni token almayı denemelidir.[null, "hb", "phoenix", "heartbeat", {}] gönderir. Sunucu 60 saniye boyunca hiç frame almazsa bağlantıyı kapatır.Origin kontrolü). Mobil uygulamalar Origin göndermez ve her zaman kabul edilir.token
string
query
zorunlu
Geçerli access token (Bearer öneki olmadan)
vsn
string
query
zorunlu
Frame biçimi; dizi biçimi için 2.0.0 olmalıdır
Origin değeri kabul edilmediwebsocat "wss://mskop-api.gurerlabs.com/socket/websocket?token=$ACCESS_TOKEN&vsn=2.0.0"
# 30 saniyede bir heartbeat:
→ [null,"hb","phoenix","heartbeat",{}]
← [null,"hb","phoenix","phx_reply",{"status":"ok","response":{}}]
# Phoenix JS istemcisi (vsn'yi kendisi ekler):
const socket = new Socket("wss://mskop-api.gurerlabs.com/socket", {params: {token: accessToken}})
socket.connect()WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → phx_join
Bir odanın kanalına katılır. Yalnız odanın üyeleri katılabilir. Katılma yanıtında oda nesnesi gelir (REST'teki oda yüküyle aynı şekil, ek olarak member_count, is_member, avatar, peer ve muted). Ardından sunucu yalnız bu bağlantıya önce presence_state, sonra message:sync gönderir.
room_not_found (böyle bir oda yok), not_member (oda var ama kişi üyesi değil).seq imleci vardır. Düzenleme, silme, tepki, etkinlik yanıtı ve tartışma sayacı da imleci ileri taşır. Cihaz elindeki son latest_seq değerini since olarak gönderir ve o imleçten sonra değişen her satırı en eskisi önce, 100'erli paketler hâlinde alır. has_more true ise message:sync {since: latest_seq} ile devam eder.since verilmezse ya da 0 ise cihaz yeni sayılır ve en yeni 100 mesaj gelir. Daha eskileri message:history ile istenir.seq sırasıyla gelir ama akış inserted_at sırasıyla çizilir. Cihaz mesajı id ile günceller, seq = max(eski, yeni) olarak saklar ve listeyi yeniden sıralamaz.room.peer alanı {account_id, username, online} taşır. Karşı tarafın durumu değişince peer:presence gelir.show_members: false olan bir odada sıradan üyeler, kurucu ve yöneticiler dışındaki kişileri presence içinde hidden-… takma kimlikleriyle ve rumuzsuz görür.slug
string
path
zorunlu
Odanın slug'ı; topic room:SLUG olur
since
integer
payload
isteğe bağlı
Cihazın sakladığı son latest_seq; 0 ya da yoksa yeni cihaz
→ ["1","1","room:fenerbahce-taraftar","phx_join",{"since":418}]
← ["1","1","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{"room":{"id":"3c8f1a2e-7b64-4d09-a5e1-6f2b9c0d4e17","slug":"fenerbahce-taraftar","…":"…"}}}]
← ["1",null,"room:fenerbahce-taraftar","presence_state",{"0c4e8a92-51d7-4b3f-a6e2-9d18f7c3b456":{"metas":[{"state":"online","username":"ayse","online_at":1791969100,"phx_ref":"F5xQ2k8pT0s"}]}}]
← ["1",null,"room:fenerbahce-taraftar","message:sync",{"since":418,"latest_seq":421,"has_more":false,"messages":[…]}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:new
Odaya mesaj gönderir. Mesaj sunucuda oda anahtarıyla şifreli saklanır. Gönderen mesajı yalnız yanıt olarak alır; odadaki diğer herkese message:new olarak yayılır. Gövde / ile başlıyor ve ek yoksa mesaj yazılmaz, komut çalıştırılır.
invalid_payload (body metin değil), read_only (Makroskop'un resmi duyuru sohbeti), empty_body (ek yok ve gövde boş), not_allowed (konuşma yetkisi yok; ek türü yasaksa permission alanıyla, ör. send_message.photos), body_too_large (16 384 bayttan uzun), rate_limited, invalid_parent (birebir sohbet, tartışmalar kapalı, kök bu odada değil ya da tartışma sonlandırılmış), muted (until ms ile), invalid_forward, not_available_in_organization (Keşfet kartı Makroskop dışı bir odaya), invalid_attachment.attachment.type; yoksa image): image {key, thumb_key, content_type, width, height, byte_size?}. Türü jpeg, png ya da webp olmalı; en çok 8 MB ve 8192 px; anahtar odanın room-media/ROOM_ID/ önekinde olmalı. video mp4, en çok 16 MB, duration_ms en çok 10 500. gif image/gif ya da image/webp. sticker webp, png ya da gif, en çok 2 MB; pack_id? ve emoji? alabilir.contact {account_id} (rumuzu sunucu doldurur). location {lat, lng, label?}. article {title (≤200), hashtag?, blocks (≤200; p, h, li, quote; her biri ≤4000 karakter), media (≤20 fotoğraf)}. document {key, name, content_type, byte_size (≤10 MB)}; dosya 1 saat sonra silinir. happening {title, starts_at, ends_at?, location?, description?, media?}. entry {entry_id}; yalnız Makroskop odalarında kullanılabilir.view_once: true. Yalnız birebir sohbette, image ya da video ile ve thumb_key olmadan gönderilir.hashtags gönderilmezse gövdeden çıkarılır. Yanıttaki topics alanında mesajın düştüğü konular bulunur; hashtag yoksa ["unknown"] olur. reply_to.sender en çok 40, snippet en çok 120 karakter olarak saklanır.parent_id verilirse mesaj o tartışmanın içine düşer. Bu durumda yanıttaki parent_thread_count, parent_seq ve parent_thread_participants kök mesajın yeni hâlini taşır; tartışma dışındaki mesajlarda bu alanlar null olur./mute @rumuz [5m|2h|1d], /unmute @rumuz, /ban @rumuz [sebep], /unban @rumuz, /kick @rumuz, /score [daily|weekly|monthly|all]. Yanıtı {command, target: {account_id, username}, …} biçimindedir (/mute için until ms). Komutlar hesap, oda ve komut başına dakikada 5 kez çalıştırılabilir. Komut hataları: not_admin, user_not_found, unknown_command, bad_duration, bad_window, founder_protected, not_member, rate_limited.user: kanalına room:new gider.body
string
payload
zorunlu
Mesaj metni, en çok 16 KB; ek varsa boş olabilir
client_ref
string
payload
isteğe bağlı
İstemcinin kendi kimliği; yanıtta ve yayında aynen döner
hashtags
string[]
payload
isteğe bağlı
Ayrıca gönderilen etiketler; yoksa gövdeden çıkarılır
reply_to
object
payload
isteğe bağlı
Alıntı {id, sender, snippet}
attachment
object
payload
isteğe bağlı
Ek; türler notlarda
parent_id
uuid
payload
isteğe bağlı
Tartışmanın kök mesajı
forward_of
object
payload
isteğe bağlı
İletilen mesajın kaynağı {room, message_id}
→ ["1","2","room:fenerbahce-taraftar","message:new",{"body":"Maç ne oldu? #fb-maçı","client_ref":"c-1"}]
← ["1","2","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71","seq":422,"…":"…"}}]
# Susturulmuş üye:
← ["1","2","room:fenerbahce-taraftar","phx_reply",{"status":"error","response":{"reason":"muted","until":1791969602000}}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:ack
Cihaz mesajları aldığını ve yerel veritabanına yazdığını bildirir. Gönderen dışındaki birinden gelen ilk ack, odaya message:delivered {id} olarak yayılır; gönderen bunu çift tik olarak gösterir. Yanıt gelmez.
id metin değil, ids liste değil) unknown_event alır.id
uuid
payload
isteğe bağlı
Tek mesaj; ya bu ya ids gönderilir
ids
uuid[]
payload
isteğe bağlı
Mesaj kimlikleri, en çok 200
→ ["1","3","room:fenerbahce-taraftar","message:ack",{"ids":["a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71"]}]
← [null,null,"room:fenerbahce-taraftar","message:delivered",{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71"}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:sync
Katılma sırasında gelen senkron paketinin devamını ister. since imlecinden sonra değişen satırlar en eskisi önce, en çok 100'er gelir. Yanıttaki has_more true ise yanıttaki latest_seq değeriyle yeniden istenir.
deleted: true ve boş gövdeyle, düzenlenmişler dolu edited_at ve yeni gövdeyle gelir. Tepki alan mesajlar reactions alanının yeni hâliyle satırın tamamı olarak gelir.audience: "admins" olan oda satırları (yönetici kaydı) sıradan üyelerin senkronuna girmez.since negatif ya da tam sayı değilse unknown_event döner.since
integer
payload
zorunlu
Son işlenen latest_seq (0 ya da daha büyük)
→ ["1","4","room:fenerbahce-taraftar","message:sync",{"since":421}]
← ["1","4","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{"since":421,"latest_seq":422,"has_more":false,"messages":[…]}}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:history
Yukarı kaydırırken cihazda bulunmayan eski mesajları getirir. before anından eski en yeni limit mesaj, eskiden yeniye sıralı gelir. before_id ekrandaki en eski mesajın kimliğidir; aynı milisaniyede yazılmış mesajların atlanmamasını sağlar.
before tam sayı değilse unknown_event döner. limit geçersizse 50 kullanılır.history_for_new_members: false) kişinin katıldığı andan öncesi verilmez.before
ms
payload
zorunlu
Ekrandaki en eski mesajın inserted_at değeri
before_id
uuid
payload
isteğe bağlı
Ekrandaki en eski mesajın id'si
limit
integer
payload
isteğe bağlı
Varsayılan 50, en çok 100
→ ["1","5","room:fenerbahce-taraftar","message:history",{"before":1791969153000,"before_id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71","limit":50}]
← ["1","5","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{"messages":[…],"has_more":true}}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:thread
Bir mesajın altındaki tartışmanın tamamını getirir: üstte kök mesaj (root), altında yanıtlar (messages, eskiden yeniye, en çok 200). Tartışma yanıtları odanın kendi akışında görünmez; bu yüzden onları okumanın tek yolu bu olaydır.
not_found (bu odada böyle bir kök mesaj yok). id metin değilse unknown_event döner.id
uuid
payload
zorunlu
Kök mesajın id'si
→ ["1","6","room:fenerbahce-taraftar","message:thread",{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71"}]
← ["1","6","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{"root":{…},"messages":[…]}}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:thread:close
Bir tartışmayı bitmiş olarak işaretler (closed: true) ya da yeniden açar. Kapalı tartışma okunabilir ama yeni yanıt almaz. Durum değişirse odaya message:thread:closed {id, closed, seq} yayılır ve odaya discussion_closed ya da discussion_reopened satırı yazılır.
seq bulunmaz.not_allowed, not_found, invalid_payload (closed boolean değil).id
uuid
payload
zorunlu
Kök mesajın id'si
closed
boolean
payload
zorunlu
true sonlandırır, false yeniden açar
→ ["1","7","room:fenerbahce-taraftar","message:thread:close",{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71","closed":true}]
← ["1","7","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71","closed":true,"seq":431}}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:rsvp
Bir etkinlik kartına (kind: "happening") katılım yanıtı verir. Her kişinin tek bir yanıtı vardır; fikir değişince yeni yanıt eskisinin yerine geçer. Yeni sayılar odadaki herkese message:rsvp {id, rsvps, seq} olarak yayılır.
seq null döner.not_an_event, event_over (bitiş zamanı geçti), not_found, invalid_payload (answer geçersiz).id
uuid
payload
zorunlu
Etkinlik mesajının id'si
answer
string
payload
zorunlu
going, maybe ya da no
→ ["1","8","room:fenerbahce-taraftar","message:rsvp",{"id":"7c2e9f14-3a8b-4d61-b5e0-2f9a6c1d8e43","answer":"going"}]
← ["1","8","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{"id":"7c2e9f14-3a8b-4d61-b5e0-2f9a6c1d8e43","rsvps":{…},"seq":433}}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:read
"Buraya kadar okudum" bildirimidir. Oda listesindeki okunmamış rozeti bu imleçten sonraki mesajları sayar; böylece rozet hesabın bütün cihazlarında aynı olur. İmleç hiçbir zaman geri gitmez: daha küçük bir seq göndermek bir şey değiştirmez.
seq negatif ya da tam sayı değilse unknown_event döner.seq
integer
payload
zorunlu
Okunan son mesajın seq değeri
→ ["1","9","room:fenerbahce-taraftar","message:read",{"seq":422}]
← ["1","9","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{"seq":422}}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:react
Bir mesaja tepki ekler ya da (on: false) geri alır. Yalnız iki uygulamada da bulunan yedi emoji kabul edilir: ❤️ 👍 😂 😮 😢 🙏 🔥. Tepki mesajın imlecini ilerletir; odadaki diğer kişilere message:reaction olarak yayılır, tepkiyi bırakan cihaz yeni seq değerini yanıtta alır.
reaction_limit ve limit alanı döner.seq null döner.invalid_payload (id UUID değil), unknown_emoji, rate_limited, reaction_limit.id
uuid
payload
zorunlu
Mesajın id'si
emoji
string
payload
zorunlu
❤️ 👍 😂 😮 😢 🙏 🔥 emojilerinden biri
on
boolean
payload
isteğe bağlı
false tepkiyi geri alır; varsayılan true
→ ["1","10","room:fenerbahce-taraftar","message:react",{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71","emoji":"🔥"}]
← ["1","10","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{"seq":434}}]
# Sınır doluysa:
← ["1","10","room:fenerbahce-taraftar","phx_reply",{"status":"error","response":{"reason":"reaction_limit","limit":1}}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:seen
"Bu mesajlar ekranımda" bildirimidir. Sunucu kimin neyi gördüğünü kaydeder; bu kayıt mesajın "Görüntüleyenler" listesini ve views sayacını besler. Odadaki diğer kişilere message:seen {ids, account_id, username} yayılır. Yanıt gelmez.
account_id ve username alanları null olur.ids
uuid[]
payload
zorunlu
Ekranda görünen mesajlar, en çok 200
→ ["1","11","room:fenerbahce-taraftar","message:seen",{"ids":["a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71"]}]
← [null,null,"room:fenerbahce-taraftar","message:seen",{"ids":["a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71"],"account_id":"f6cad462-3b1e-4d6a-9a77-2c1e0b8f4d21","username":"osmangurer"}] (diğer cihazlara)WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:open_once
Birebir sohbette tek gösterimlik bir fotoğrafı ya da videoyu açar. Yanıttaki url 60 saniye geçerli, tek bir imzalı GET adresidir ve yalnız bir kez verilir. Açılış odaya message:opened {id, seq, opened_at} olarak yayılır; iki taraf da baloncuğu "Açıldı" yapar. Dosya açıldıktan yaklaşık 90 saniye sonra silinir.
not_allowed (gönderen kendi dosyasını açamaz), already_opened (dosya başka bir cihazdan da olsa zaten açılmış), gone (dosya silinmiş), not_view_once (mesaj tek gösterimlik değil ya da oda birebir sohbet değil), not_found.id
uuid
payload
zorunlu
Tek gösterimlik mesajın id'si
→ ["2","12","room:dm-0c4e8a9251d7-f6cad4623b1e","message:open_once",{"id":"b3d71f0e-6c2a-4e95-8a14-0f7e2d9c5b36"}]
← ["2","12","room:dm-0c4e8a9251d7-f6cad4623b1e","phx_reply",{"status":"ok","response":{"url":"https://mskop-api.gurerlabs.com/makroskop-media/…","seq":57,"opened_at":1791969302000}}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:state
Cihazda zaten bulunan mesajların güncel tepkilerini ve görüntülenme sayılarını toplu olarak getirir. Mesajın tamamını yeniden indirmeden bu iki bilgiyi tazelemek için kullanılır. UUID olmayan kimlikler atılır; en çok 200 kimlik işlenir.
ids liste değilse unknown_event döner.ids
uuid[]
payload
zorunlu
Mesaj kimlikleri, en çok 200
→ ["1","13","room:fenerbahce-taraftar","message:state",{"ids":["a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71"]}]
← ["1","13","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{"messages":[…]}}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:viewers
Mesaj menüsündeki "Görüntüleyenler" listesini getirir: mesajı kimin, ne zaman gördüğü ve varsa bıraktığı tepki. Liste görülme sırasına göre, en eskisi başta gelir. seen_at ISO-8601 biçimindedir.
hidden sayısına eklenir.id UUID değilse liste boş döner; id metin değilse unknown_event döner.id
uuid
payload
zorunlu
Mesajın id'si
→ ["1","14","room:fenerbahce-taraftar","message:viewers",{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71"}]
← ["1","14","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71","viewers":[…],"hidden":0}}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:edit
Kişi kendi mesajının gövdesini değiştirir; sunucudaki şifreli kopya da güncellenir. Hashtag'ler ve bahsetmeler yeni gövdeden yeniden çıkarılır. Odaya message:edited {id, body, account_id, hashtags, mentions, edited_at, seq} yayılır; edited_at ms epoch'tur. Yanıt boş bir ok'tur.
not_allowed (permission: "edit_message"; oda bu yetkiyi üyelerden almış), empty_body, body_too_large, not_author, not_found. id ya da body metin değilse unknown_event döner.id
uuid
payload
zorunlu
Mesajın id'si
body
string
payload
zorunlu
Yeni gövde, en çok 16 KB
→ ["1","15","room:fenerbahce-taraftar","message:edit",{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71","body":"Maç 2-1 bitti #fb-maçı"}]
← ["1","15","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{}}]
← [null,null,"room:fenerbahce-taraftar","message:edited",{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71","body":"Maç 2-1 bitti #fb-maçı","account_id":"0c4e8a92-51d7-4b3f-a6e2-9d18f7c3b456","hashtags":["#fb-maçı"],"mentions":[],"edited_at":1791969302000,"seq":435}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → message:delete
Kişi kendi mesajını geri alır ya da yetkili biri başkasının mesajını kaldırır. Gövde sunucudan silinir, yerinde bir iz kalır; böylece o sırada bağlı olmayan cihazlar da silindiğini öğrenir. Ekli dosyalar hemen silinir. Odaya message:deleted yayılır ve yöneticilere görünen bir message_deleted satırı yazılır.
parent_id, parent_thread_count, parent_seq ve parent_thread_participants alanları kökün yeni hâliyle gelir.not_allowed, not_author, not_found. id metin değilse unknown_event döner.id
uuid
payload
zorunlu
Mesajın id'si
→ ["1","16","room:fenerbahce-taraftar","message:delete",{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71"}]
← ["1","16","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{}}]
← [null,null,"room:fenerbahce-taraftar","message:deleted",{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71","account_id":"0c4e8a92-51d7-4b3f-a6e2-9d18f7c3b456","seq":436,"parent_id":null,"parent_thread_count":null,"parent_seq":null,"parent_thread_participants":null}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → room:pin
Bir mesajı odanın sabitlenenler listesinin başına ekler. Mesaj zaten sabitliyse başa taşınır. id: null göndermek bütün sabitleri bir kerede kaldırır. Odaya room:pinned {message_id, account_id, at, pins} yayılır ve odaya message_pinned ya da message_unpinned satırı yazılır.
message_id, account_id ve at en yeni sabiti anlatır; pins listenin tamamıdır ve en yenisi başta gelir. Son sabit de kalkınca message_id null olur ve pins boş gelir. at ISO-8601 biçimindedir.members_can_pin açık olan odalarda sıradan üyeler de sabitleyebilir.not_admin, not_found (mesaj bu odada yok), invalid_payload.id
uuid
payload
zorunlu
Sabitlenecek mesaj; null bütün sabitleri kaldırır
→ ["1","17","room:fenerbahce-taraftar","room:pin",{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71"}]
← ["1","17","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{}}]
← [null,null,"room:fenerbahce-taraftar","room:pinned",{"message_id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71","account_id":"0c4e8a92-51d7-4b3f-a6e2-9d18f7c3b456","at":"2026-10-14T09:15:02.418903Z","pins":[{"message_id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71","account_id":"0c4e8a92-51d7-4b3f-a6e2-9d18f7c3b456","at":"2026-10-14T09:15:02.418903Z"}]}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → room:unpin
Sabitlenenler listesinden tek bir mesajı kaldırır; diğerleri yerinde kalır. Birden fazla sabit varken "bunu kaldır" ile "hepsini kaldır" farklı isteklerdir; hepsini kaldırmak için room:pin {id: null} kullanılır. Odaya güncel listeyle room:pinned yayılır.
not_admin, invalid_payload (id yok ya da metin değil).id
uuid
payload
zorunlu
Kaldırılacak sabit mesaj
→ ["1","18","room:fenerbahce-taraftar","room:unpin",{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71"}]
← ["1","18","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{}}]
← [null,null,"room:fenerbahce-taraftar","room:pinned",{"message_id":null,"account_id":null,"at":null,"pins":[]}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → typing
Kişinin yazmakta olduğunu odaya bildirir. Sunucu aynı hesap ve oda için 2 saniyede en çok bir kez typing {account_id, username} yayar; aradaki istekler sessizce düşer. Yayın gönderene gelmez. Yanıt gelmez.
→ ["1","19","room:fenerbahce-taraftar","typing",{}]
← [null,null,"room:fenerbahce-taraftar","typing",{"account_id":"f6cad462-3b1e-4d6a-9a77-2c1e0b8f4d21","username":"osmangurer"}] (diğer üyelere)WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} → presence:set
Uygulamanın ön planda (online) ya da arka planda (background) olduğunu bildirir. Değişiklik odaya presence_diff olarak gider: aynı anahtar leaves içinde eski durumuyla, joins içinde yeni durumuyla görünür. Bağlantının kapanması, kişinin listeden düşmesi demektir.
online ise yeşil, listede ve background ise sarı, listede yoksa gri.online durumundaki kişilere o odanın push bildirimi gönderilmez; mesajı canlı olarak alırlar.invalid_state.state
string
payload
zorunlu
online ya da background
→ ["1","20","room:fenerbahce-taraftar","presence:set",{"state":"background"}]
← ["1","20","room:fenerbahce-taraftar","phx_reply",{"status":"ok","response":{}}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
room:{slug} ← sunucu olayları
Sunucunun oda kanalına kendiliğinden gönderdiği olaylardır. Cihaz her olayı kendi yerel kopyasına uygular. seq taşıyan olaylarda satırın ve senkron imlecinin seq değerini de ilerletir; aksi hâlde aynı satır bir sonraki senkronda yeniden gelir.
message:new — mesaj nesnesi (senkrondakiyle aynı şekil) ve ek olarak topics, client_ref, parent_thread_count, parent_seq, parent_thread_participants. Gönderen kendi mesajını yayın olarak almaz. parent_id doluysa mesaj bir tartışma yanıtıdır ve akışa değil, tartışma penceresine girer. Odanın kendi satırları (kind: "event", gönderen null) da bu olayla gelir. event.type şunlardan biridir: member_joined, member_left, member_kicked, member_banned, member_unbanned, member_muted, member_unmuted, score, welcome, founder_changed, room_settings_changed, member_permissions_changed, admin_permissions_changed, message_deleted, message_pinned, message_unpinned, discussion_closed, discussion_reopened.message:sync {since, messages, latest_seq, has_more} — katılınca yalnız bu bağlantıya. message:delivered {id} — gönderen dışından biri mesajı aldı (çift tik).message:edited {id, body, account_id, hashtags, mentions, edited_at, seq} — edited_at ms epoch. message:deleted {id, account_id, seq, parent_id, parent_thread_count, parent_seq, parent_thread_participants}.message:reaction {id, emoji, account_id, username, on, seq}. message:seen {ids, account_id, username}. message:rsvp {id, rsvps, seq}. message:opened {id, seq, opened_at} — opened_at ms epoch. message:thread:closed {id, closed, seq}.room:pinned {message_id, account_id, at, pins} — at ISO-8601. typing {account_id, username}.presence_state {ACCOUNT_ID: {metas: [{state, username, online_at, phx_ref}]}} — katılınca tam liste; online_at saniye cinsinden epoch. presence_diff {joins, leaves} — değişiklikler. Üyelerini gizleyen odada sıradan üyeler hidden-… kimlikleri görür.member:joined {account_id, username} (biri REST ile katıldı), member:left {account_id}, member:tagged {account_id, tag}. Gizli üyelerin giriş ve çıkışları sıradan üyelere gönderilmez.room:removed {} — kişi odadan ayrıldı ya da çıkarıldı (başka bir cihazdan da olabilir); ardından kanal phx_close ile kapanır. room:deleted {slug} — oda silindi.peer:presence {account_id, online} — yalnız birebir sohbette: karşı taraf bağlandı ya da bağlantısı koptu.← [null,null,"room:fenerbahce-taraftar","message:new",{"id":"e2c6a1f9-4b7d-4380-9e15-8a3f0d6c2b71","seq":437,"kind":"text","body":"Kadıköy'de buluşalım mı?","sender":{"account_id":"fdea3b17-2c9e-4a61-8d40-7b5e1c9a2f08","username":"mehmet","tag":null,"role":"member"},"inserted_at":1791969420000,"topics":["unknown"],"client_ref":"c-88","…":"…"}]
← [null,null,"room:fenerbahce-taraftar","message:reaction",{"id":"a9ea1c52-7d3b-4e0f-9b18-5c2e6f4d8a71","emoji":"🔥","account_id":"fdea3b17-2c9e-4a61-8d40-7b5e1c9a2f08","username":"mehmet","on":true,"seq":438}]
← [null,null,"room:fenerbahce-taraftar","presence_diff",{"joins":{"fdea3b17-2c9e-4a61-8d40-7b5e1c9a2f08":{"metas":[{"state":"background","username":"mehmet","online_at":1791969100,"phx_ref":"F5xQ9mZ1aB4"}]}},"leaves":{"fdea3b17-2c9e-4a61-8d40-7b5e1c9a2f08":{"metas":[{"state":"online","username":"mehmet","online_at":1791969100,"phx_ref":"F5xQ2k8pT0s"}]}}}]
← [null,null,"room:fenerbahce-taraftar","member:joined",{"account_id":"9d2b7e40-1c6f-4a85-b3e9-5f0a8c2d7e16","username":"zeynep"}]
← ["1",null,"room:fenerbahce-taraftar","room:removed",{}]
← ["1","1","room:fenerbahce-taraftar","phx_close",{}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
user:{account_id} → phx_join
Uygulama açılışta odaların yanı sıra kendi kanalına da katılır. Bu kanal sunucunun bir odaya değil kişiye ulaştığı yoldur: oda listesi açık kanal olmadan da güncel kalır. Katılmak hesabı genel çevrimiçi listesine de yazar; bu liste yalnız birebir sohbetin karşı tarafına durum göstermek için kullanılır.
account_id'nle katılabilirsin; başka bir kimlik forbidden alır. Bu kanala gönderilen her istemci olayı unknown_event alır.room:new {room} — biri seninle birebir sohbete ilk mesajı yazdı ya da bir yönetici katılma isteğini onayladı; uygulama odayı listeye hemen ekler.room:gone {slug} — odadan çıkarıldın, engellendin, ayrıldın (başka cihazdan da olabilir) ya da oda silindi.room:activity {slug, seq, last_message, mentioned} — üyesi olduğun bir odaya mesaj düştü (gönderene gelmez). last_message, GET /api/rooms listesindeki nesneyle aynıdır: {id, seq, kind, audience, sender, body (ilk 120 karakter), event, inserted_at}. mentioned, mesajın seni @rumuz ile anıp anmadığını söyler. Okunmamış sayısı gönderilmez; cihaz rozeti kendisi bir artırır. Tartışma yanıtları ve odanın kendi satırları bu olayı tetiklemez.peer:presence {account_id, online} — birebir sohbet ettiğin biri bağlandı ya da bağlantısı koptu; o sohbetin açık olması gerekmez.account:avatar {account_id, avatar} — biri profil fotoğrafını değiştirdi. Son fotoğraf silindiyse avatar: null gelir. Bağlı olan herkese, kişinin kendisine de gider.account_id
uuid
path
zorunlu
Kendi hesap kimliğin; topic user:ACCOUNT_ID olur
→ ["3","21","user:f6cad462-3b1e-4d6a-9a77-2c1e0b8f4d21","phx_join",{}]
← ["3","21","user:f6cad462-3b1e-4d6a-9a77-2c1e0b8f4d21","phx_reply",{"status":"ok","response":{}}]
← [null,null,"user:f6cad462-3b1e-4d6a-9a77-2c1e0b8f4d21","room:activity",{"slug":"gece-kulubu","seq":421,"mentioned":false,"last_message":{"id":"b0127e5c-3f9a-4d28-8c61-e4a7b2d90f35","seq":421,"kind":"text","audience":"all","sender":{"account_id":"fdea3b17-2c9e-4a61-8d40-7b5e1c9a2f08","username":"mehmet"},"body":"Bu akşam kaçta?","event":null,"inserted_at":1791969420000}}]
← [null,null,"user:f6cad462-3b1e-4d6a-9a77-2c1e0b8f4d21","peer:presence",{"account_id":"0c4e8a92-51d7-4b3f-a6e2-9d18f7c3b456","online":true}]
← [null,null,"user:f6cad462-3b1e-4d6a-9a77-2c1e0b8f4d21","room:gone",{"slug":"gece-kulubu"}]WebSocket bağlantısı bu sayfadan denenemez; örnekteki websocat komutunu ya da Phoenix istemcisini kullan.
Aramana uyan endpoint yok.