Workspaceler

Workspaceler, sosyal medya hesaplarını, gönderileri ve takım üyelerini gruplayan organizasyon birimleridir. API anahtarına bağlı kullanıcının üye olduğu tüm workspace’lere erişilebilir.

Workspaceleri Listele

GET/v1/workspaces

Kullanıcının üye olduğu tüm workspace’leri kullanım istatistikleri ve limitleriyle döner.

Kod Örnekleri

Node.js

workspaceleri-listele.js


const response = await fetch('https://api.sosyalkopru.com/v1/workspaces', {
  headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` },
})
const { data } = await response.json()
 
data.forEach(ws => {
  const doluluk = ((ws.usage.accounts / ws.limits.maxAccounts) * 100).toFixed(0)
  console.log(`[${ws.plan}] ${ws.name}`)
  console.log(`  Hesap: ${ws.usage.accounts}/${ws.limits.maxAccounts} (%${doluluk})`)
  console.log(`  Rol: ${ws.role}`)
})

Python

workspaceleri_listele.py


import os, requests
 
response = requests.get(
    "https://api.sosyalkopru.com/v1/workspaces",
    headers={"Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}"},
)
response.raise_for_status()
 
for ws in response.json()["data"]:
    doluluk = ws["usage"]["accounts"] / ws["limits"]["maxAccounts"] * 100
    print(f"[{ws['plan']}] {ws['name']} — rol: {ws['role']}")
    print(f"  Hesap: {ws['usage']['accounts']}/{ws['limits']['maxAccounts']} (%{doluluk:.0f})")

PHP

workspaceleri-listele.sh


curl https://api.sosyalkopru.com/v1/workspaces \
  -H "Authorization: Bearer $SOSYALKOPRU_API_KEY"

Başarılı Yanıt


{
  "success": true,
  "data": [
    {
      "id": "ws_01HZGK9P3QABC",
      "name": "Sosyal Köprü Ana",
      "plan": "GROWTH",
      "role": "OWNER",
      "usage": {
        "accounts": 4,
        "members": 2,
        "scheduledPosts": 12
      },
      "limits": {
        "maxAccounts": 10,
        "maxMembers": 5,
        "maxScheduledPosts": 100
      },
      "createdAt": "2025-01-15T10:00:00.000Z"
    }
  ],
  "meta": { "requestId": "req_01XYZ", "timestamp": "...", "version": "1" }
}

Workspace Detayı

GET/v1/workspaces/{id}

Tek bir workspace’in abonelik ve üyelik bilgilerini döner.

Path Parametresi

Parametre	Açıklama
`id`	Workspace ID’si (`ws_...`)

Kod Örnekleri

Node.js

workspace-detay.js


const response = await fetch(
  `https://api.sosyalkopru.com/v1/workspaces/${workspaceId}`,
  { headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` } }
)
const { data } = await response.json()
 
console.log(`Workspace: ${data.name}`)
console.log(`Plan     : ${data.plan}`)
 
if (data.subscription) {
  const bitis = new Date(data.subscription.currentPeriodEnd).toLocaleDateString('tr-TR')
  console.log(`Abonelik : ${data.subscription.status} (${bitis}'e kadar)`)
}

Python

workspace_detay.py


response = requests.get(
    f"https://api.sosyalkopru.com/v1/workspaces/{workspace_id}",
    headers={"Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}"},
)
response.raise_for_status()
data = response.json()["data"]
print(f"Workspace: {data['name']} ({data['plan']})")
if data.get("subscription"):
    print(f"Abonelik: {data['subscription']['status']}")

PHP

workspace-detay.sh


curl https://api.sosyalkopru.com/v1/workspaces/ws_01HZGK9P3QABC \
  -H "Authorization: Bearer $SOSYALKOPRU_API_KEY"

Başarılı Yanıt


{
  "success": true,
  "data": {
    "id": "ws_01HZGK9P3QABC",
    "name": "Sosyal Köprü Ana",
    "plan": "GROWTH",
    "role": "OWNER",
    "usage": {
      "accounts": 4,
      "members": 2,
      "scheduledPosts": 12
    },
    "limits": {
      "maxAccounts": 10,
      "maxMembers": 5,
      "maxScheduledPosts": 100
    },
    "subscription": {
      "status": "active",
      "currentPeriodStart": "2025-06-01T00:00:00.000Z",
      "currentPeriodEnd": "2025-07-01T00:00:00.000Z"
    },
    "createdAt": "2025-01-15T10:00:00.000Z"
  },
  "meta": { "requestId": "req_01XYZ", "timestamp": "...", "version": "1" }
}

Üyeleri Listele

GET/v1/workspaces/{id}/members

Workspace üyelerini rolleriyle birlikte döner.

Query Parametreleri

Parametre	Tip	Açıklama
`role`	`string`	`OWNER` `ADMIN` `MEMBER` `VIEWER`

Kod Örnekleri

Node.js

workspace-uyeler.js


const response = await fetch(
  `https://api.sosyalkopru.com/v1/workspaces/${workspaceId}/members`,
  { headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` } }
)
const { data } = await response.json()
 
data.forEach(m => {
  console.log(`${m.role.padEnd(8)} ${m.name} <${m.email}>`)
})

Python

workspace_uyeler.py


response = requests.get(
    f"https://api.sosyalkopru.com/v1/workspaces/{workspace_id}/members",
    headers={"Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}"},
)
response.raise_for_status()
for m in response.json()["data"]:
    print(f"{m['role']:<8} {m['name']} <{m['email']}>")

PHP

workspace-uyeler.sh


curl https://api.sosyalkopru.com/v1/workspaces/ws_01HZGK9P3QABC/members \
  -H "Authorization: Bearer $SOSYALKOPRU_API_KEY"

Başarılı Yanıt


{
  "success": true,
  "data": [
    {
      "userId": "usr_01HZGK9P3QABC",
      "name": "Buğra Er",
      "email": "bugra@sosyalkopru.com",
      "role": "OWNER",
      "joinedAt": "2025-01-15T10:00:00.000Z"
    },
    {
      "userId": "usr_01HZGK9P3QDEF",
      "name": "Sosyal Medya Uzmanı",
      "email": "uzman@sosyalkopru.com",
      "role": "MEMBER",
      "joinedAt": "2025-03-10T09:00:00.000Z"
    }
  ],
  "meta": { "requestId": "req_01XYZ", "timestamp": "...", "version": "1" }
}

Workspace Planları

Plan	Açıklama
`STARTER`	Başlangıç planı — 3 hesap, 2 üye
`GROWTH`	Büyüme planı — 10 hesap, 5 üye
`AGENCY_PRO`	Ajans planı — sınırsız hesap ve üye

Üye Rolleri

Rol	Açıklama
`OWNER`	Tam yetki — fatura ve abonelik dahil
`ADMIN`	Tüm içerik işlemleri — faturalandırma hariç
`MEMBER`	Gönderi oluşturma ve planlama
`VIEWER`	Yalnızca görüntüleme