Ekip API’si #

Ekibiniz, hesabınızda sizin dışınızda çalışan herkesi (yöneticiler, temsilciler ve salt okunur görüntüleyiciler) ve gönderdiğiniz davetiyeleri ve onları düzenlediğiniz departmanları kapsar. Ekip API’si, Ayarlar → Ekip bölümünün programatik sürümüdür: kişileri ekleyip çıkarabilir, her birinin neyi görüp yapabileceğini ayarlayabilir, davetiye gönderebilir veya hatırlatabilir ve departmanları yönetebilirsiniz.

Aşağıdaki tüm uç noktalar https://api.youraiconnector.com/v1 temel URL’sine göredir. Bu sayfadaki her şeyin kontrol paneli sürümü için Ekip Yönetimi bölümüne bakın.

Kimlik Doğrulama: bu uç noktalar oturum açmış bir kişi gerektirir #

Bu, API’nin bir API anahtarının kullanamayacağı tek kısmıdır. departman uç noktaları dışındaki her /team uç noktası, oturum açmış bir oturumdan alınan bir Firebase ID token ile çağrılmalıdır:

Authorization: Bearer <Firebase ID token>

Bunun yerine bir API anahtarı gönderirseniz, istek 401 ile reddedilir:

{
  "success": false,
  "error_code": 401,
  "error": "This endpoint requires a Firebase ID token (Authorization: Bearer <token>)."
}

Bunun nedeni, bu uç noktaların kimin oturum açtığına göre ne yapılacağına karar vermesidir: rolünüz, başka birine verebileceğiniz yetkilerin sınırı ve şu anda başka bir hesap içinde çalışıp çalışmadığınız. Bir API anahtarı bir entegrasyondur, bir kişi değildir; bu nedenle bu kuralların uygulanabileceği kimse yoktur.

Uygulamada bu, Ekip API’sinin oturum açmış bir Your AI Connector kullanıcısı olan birinci taraf bir uygulama için olduğu anlamına gelir (bkz. Kimlik Doğrulama → Firebase ID token). Sunucudan sunucuya bir entegrasyon ekip üyelerini yönetemez; uygulama dışından bu token’lardan birini oluşturmanın bir yolu yoktur.

İstisna: dört departman uç noktası normal API uç noktalarıdır. API’nin geri kalanı gibi API anahtarınızı ve oturum açmış bir oturumu kabul ederler.

Bu sayfadaki her yanıt, olağan zarfı takip eder: success: true artı en üst düzeyde uç noktanın alanları veya bir şeyler ters gittiğinde error ve error_code ile success: false.

Roller ve izinler #

Her ekip üyesinin, uygulamanın 12 alanındaki varsayılan erişimini belirleyen bir rolü vardır. Daha sonra bireysel alanları geçersiz kılabilirsiniz.

Her alan dört düzeyden birine ayarlanır: none (gizli), view (salt okunur), edit (oluşturma ve değiştirme), full (silme dahil).

Rolün varsayılanlarından sapmak için permission_overrides gönderin — bir { "area": ..., "level": ... } nesneleri dizisi. Her girdi, o alan için rolün varsayılanını değiştirir; listelemediğiniz her şey rol varsayılanını korur.

"permission_overrides": [
  { "area": "analytics", "level": "full" },
  { "area": "billing", "level": "none" }
]

Bu uç noktaları kimler çağırabilir

• Hesap sahibi her zaman her şeyi yapabilir.
• Bir ekip üyesinin kadroyu ve davet listesini okuması için view seviyesinde team_management yetkisine; ekleme, değiştirme, askıya alma, kaldırma, davet etme, iptal etme veya yeniden gönderme işlemleri için ise edit seviyesinde yetkiye ihtiyacı vardır. Yöneticiler varsayılan olarak edit yetkisine sahiptir; düzenleyiciler ve görüntüleyenler none yetkisine sahiptir, bu nedenle varsayılan olarak yalnızca yöneticiler ekibi yönetebilir.
• Hiç kimse kendi erişim seviyesinin üzerinde erişim veremez. Birine kendinizde olmayan bir seviye vermeye çalışırsanız veya erişimi sizinkinden daha geniş olan birini düzenlemeye, askıya almaya veya kaldırmaya çalışırsanız, istek 403 hatası ve ilgili alanı belirten bir mesajla reddedilir.

Ekip üyesi nesnesi #

GET /team/members, üye başına bunlardan birini döndürür:

Kaldırılan üyeler döndürülmez — liste yalnızca aktif ve askıya alınmış üyeleri içerir.

Görünürlük sınırları burada yalnızca yazılabilirdir. contact_scope, contact_scope_axes ve sub_account_access (bkz. Bir üyenin neleri görebileceğini sınırlama) oluşturma, güncelleme ve davet etme sırasında ayarlanabilir, ancak bu uç nokta bunları döndürmez.

Ekip üyelerini listele #

GET /team/members

Kadroyu ve planınızın koltuk sayılarını döndürür, böylece “5 koltuktan 3’ü dolu” gibi bir gösterim yapabilir ve davet etme işleminin ne zaman reddedileceğini anlayabilirsiniz.

cURL

curl "https://api.youraiconnector.com/v1/team/members" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

JavaScript

const res = await fetch("https://api.youraiconnector.com/v1/team/members", {
  headers: { Authorization: `Bearer ${idToken}` },
});
const { members, seat_limit, seats_used } = await res.json();

Python

import requests

res = requests.get(
    "https://api.youraiconnector.com/v1/team/members",
    headers={"Authorization": f"Bearer {id_token}"},
)
data = res.json()

Yanıt

{
  "success": true,
  "members": [
    {
      "account_owner_uid": "owner_uid_123",
      "member_uid": "uid_alice",
      "member_email": "alice@example.com",
      "member_display_name": "Alice Chen",
      "role": "admin",
      "permission_overrides": [],
      "status": "active",
      "auto_assign_enabled": true,
      "created_by": "owner_uid_123",
      "created_at": "2026-05-01T10:00:00.000Z",
      "updated_at": "2026-06-02T09:15:00.000Z"
    }
  ],
  "seat_limit": 5,
  "seats_used": 3
}

Planınızda koltuk sınırı yoksa seat_limit değeri null olur. seats_used yalnızca aktif üyeleri sayar — birini askıya almak veya kaldırmak koltuğunu hemen boşaltır.

Doğrudan bir ekip üyesi ekle #

POST /team/members

Birini davet göndermeye gerek kalmadan doğrudan ekibinize dahil eder.

Bu işlem e-posta göndermez. Kimseye eklendiklerine dair bildirim gitmez ve eğer halihazırda bir Your AI Connector girişleri yoksa, onlar için oluşturulan hesabın parolası yoktur, bu nedenle parolayı sıfırlayana kadar giriş yapamazlar. Kişiye durumu kendiniz bildirecek bir yolunuz yoksa ve giriş yapmalarını sağlayamıyorsanız Davetiye gönder seçeneğini kullanın.

İstek alanları

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/members" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "sam@example.com",
    "display_name": "Sam Rivera",
    "role": "editor"
  }'

JavaScript

const res = await fetch("https://api.youraiconnector.com/v1/team/members", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${idToken}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    email: "sam@example.com",
    display_name: "Sam Rivera",
    role: "editor",
  }),
});
const { member_uid } = await res.json();

Yanıt — 201 Created

{
  "success": true,
  "team_member_id": "owner_uid_123_uid_sam",
  "member_uid": "uid_sam",
  "message": "Team member created successfully."
}

Daha önce askıya alınmış veya kaldırılmış birini eklemek, işlem başarısız olmak yerine onları yeniden etkinleştirir.

Bir ekip üyesini güncelle #

PATCH /team/members/{memberUid}

Bir üyenin rolünü, izinlerini, görünürlüğünü, müşteri erişimini veya otomatik kişi atamasına katılıp katılmadığını değiştirir. Yalnızca değiştirmek istediğiniz alanları gönderin; dışarıda bıraktığınız her şey mevcut değerini korur.

İstek alanları

Bu, null ifadesinin “temizle” anlamına geldiği tek uç noktadır. "contact_scope": null, "contact_scope_axes": null veya "sub_account_access": null göndermek, bu sınırı tamamen kaldırır ve üyenin her şeyi tekrar görmesini sağlar. Oluşturma ve davet etme işlemlerinde null basitçe “sağlanmadı” anlamına gelir.

cURL

curl -X PATCH "https://api.youraiconnector.com/v1/team/members/uid_sam" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "admin",
    "permission_overrides": [{ "area": "billing", "level": "none" }]
  }'

Yanıt

{
  "success": true,
  "message": "Team member updated successfully."
}

Bir ekip üyesini askıya al #

POST /team/members/{memberUid}/suspend

Birini askıya alır: ekipteki yerlerini korurlar ancak erişimlerini kaybederler. Duraklatma geçici olduğunda kaldırmak yerine bunu kullanın — PATCH /team/members/{memberUid} ve {"status": "active"} ile onları geri getirin.

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/members/uid_sam/suspend" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

Yanıt

{
  "success": true,
  "message": "Team member suspended successfully."
}

Askıya alınan bir üye koltuğunu boşaltır, böylece yerine başka birini davet edebilirsiniz. Erişimleri, mevcut oturum belirteçleri bir sonraki yenilendiğinde sona erer; bu işlem bir saate kadar sürebilir — işlemin anında gerçekleşmesi gerekiyorsa onları kaldırın.

Bir ekip üyesini kaldırın #

DELETE /team/members/{memberUid}

Birini ekibinizden çıkarır ve koltuğunu boşaltır. Oturumları kapatılır ve hesabınıza erişimlerini kaybederler; kendi giriş bilgileri etkilenmez.

cURL

curl -X DELETE "https://api.youraiconnector.com/v1/team/members/uid_sam" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

Yanıt

{
  "success": true,
  "message": "Team member removed successfully."
}

Kaldırma işlemi sizin tarafınızdan kalıcıdır: kaldırılan bir üye, güncelleme uç noktası ile yeniden etkinleştirilemez; fikrinizi değiştirirseniz onları tekrar davet edin. E-posta adresleri de hesabınızın bildirim listesinden çıkarılır.

Bir üyenin neleri görebileceğini sınırlama #

Ekleme, güncelleme ve davet işlemlerinde kabul edilen üç isteğe bağlı alan, bir kişinin hesabı ne kadar görebileceğine karar verir. Bunlar birikir: birden fazla alanda kısıtlanan bir üye, bunların hepsinden kısıtlanmış olur.

contact_scope — all (varsayılan: her kişi ve görüşme) veya assigned (yalnızca kendilerine atananlar). assigned ile birlikte, henüz kimsenin sahip olmadığı kişileri de görmelerini sağlamak için "contact_scope_unassigned": true ekleyin.

contact_scope_axes — onları belirli temsilciler, kanallar veya departmanlarla sınırlar:

Temsilci ve departman kimlikleri kaydettiğinizde kontrol edilmez; mevcut olmayan bir kimlik hiçbir şeyle eşleşmez ve hata yerine boş bir gelen kutusu olarak görünür. Kanal adları ise kontrol edilir: tanınmayan bir kanal 400 ile reddedilir.

Bu üçünden hiçbiri hesap sahibi üzerinde ayarlanamaz; bu istek 400 ile reddedilir.

Davetleri listele #

GET /team/invites

Gönderdiğiniz davetler, en yeniden eskiye doğru sıralanır; böylece kimlerin henüz kabul etmediğini görebilirsiniz.

Sorgu parametreleri

cURL

curl "https://api.youraiconnector.com/v1/team/invites?status=pending" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

Yanıt

{
  "success": true,
  "invites": [
    {
      "id": "inv_abc123",
      "account_owner_uid": "owner_uid_123",
      "account_owner_display_name": "Acme Ltd",
      "invitee_email": "sam@example.com",
      "invitee_uid": null,
      "role": "editor",
      "permission_overrides": [],
      "status": "pending",
      "created_by": "owner_uid_123",
      "created_at": "2026-06-10T12:00:00.000Z",
      "expires_at": "2026-06-17T12:00:00.000Z",
      "responded_at": null
    }
  ]
}

Davet belirteci (token) asla döndürülmez; yalnızca gönderilen e-postanın içinde bulunur.

Davet gönder #

POST /team/invites

Ekibinize katılmaları için birine e-posta yoluyla davet gönderir. Bir ekip arkadaşı eklemenin olağan yolu budur: bağlantıya tıklarlar, kendi hesaplarıyla giriş yaparlar ve kabul ederler. Henüz bir Your AI Connector hesapları yoksa, onlar için bir hesap oluşturulur ve e-posta, parola belirleme sürecinde onlara rehberlik eder.

İstek alanları

İzinleri önceden ayarlamak, daha sonra üyeyi düzenlemek zorunda kalmayacağınız anlamına gelir; kabul ettiklerinde her şey üyeliklerine kopyalanır.

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/invites" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "email": "sam@example.com", "role": "editor" }'

JavaScript

const res = await fetch("https://api.youraiconnector.com/v1/team/invites", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${idToken}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ email: "sam@example.com", role: "editor" }),
});
const { invite_id } = await res.json();

Yanıt — 201 Created

{
  "success": true,
  "invite_id": "inv_abc123",
  "message": "Team invite sent successfully."
}

Planlanması gerekenler

• Davetlerin süresi 7 gün sonra dolar. Süresi dolan bir davet yeniden gönderilebilir ve bu işlem yeni bir 7 günlük süre başlatır.
• Bekleyen davetler bir koltuk işgal eder. Doğrudan üye eklemenin aksine, buradaki koltuk kontrolü aktif üyeleri artı bekleyen davetleri sayar; bu nedenle tüm koltukları dolu olan bir hesapta, e-posta gönderilmeden önce işlem reddedilir.
• Günlük 20 davet sınırı, hem gönderme hem de yeniden gönderme işlemleri dahil olmak üzere hesap başına sayılır.

Daveti iptal et #

DELETE /team/invites/{inviteId}

Bir daveti kabul edilmeden önce geri çeker. E-postadaki bağlantı çalışmayı durdurur.

cURL

curl -X DELETE "https://api.youraiconnector.com/v1/team/invites/inv_abc123" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

Yanıt

{
  "success": true,
  "message": "Team invite cancelled."
}

Hem pending hem de expired davetleri iptal edilebilir. Zaten kabul edilmiş, reddedilmiş veya iptal edilmiş bir davet 400 döndürür; size ait olmayan bir davet 403 döndürür; bilinmeyen bir kimlik ise 404 döndürür.

Bir daveti yeniden gönder #

POST /team/invites/{inviteId}/resend

Davet e-postasını tekrar gönderir — gözden kaçırıldığı veya spam’e düştüğü durumlar için. pending ve expired davetlerinde çalışır ve son kullanma süresini şu andan itibaren 7 gün sonrasına sıfırlar.

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/invites/inv_abc123/resend" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

Yanıt

{
  "success": true,
  "message": "Team invite resent successfully."
}

Yeni e-posta yeni bir bağlantı içerir ve eski bağlantı da çalışmaya devam eder, böylece ilk e-postayı daha sonra bulan bir kişi mağdur olmaz. Yeniden gönderme işlemi, gönderim için geçerli olan günlük 20 adetlik sınırla aynı sınıra tabidir ve süresi dolmuş bir daveti canlandırmak koltuk sayınızı tekrar kontrol eder — dolu bir plan 429 ile reddedilir.

Bir daveti kabul et #

POST /team/invites/accept

Davet e-postasındaki belirteç (token) ile bir daveti kabul eder ve oturum açmış kişiyi o hesabın ekibine dahil eder.

Bu, kendi kimliğinizle gerçekleştirdiğiniz bir işlemdir. Kendi adınızla oturum açın — başkasının hesabında çalışırken bu işlem kasıtlı olarak 403 ile reddedilir.

İstek alanları

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/invites/accept" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "invite_token": "1f4c…" }'

Yanıt

{
  "success": true,
  "team_member_id": "owner_uid_123_uid_sam",
  "account_owner_uid": "owner_uid_123",
  "message": "Team invite accepted successfully."
}

Bir daveti reddet #

POST /team/invites/decline

E-postadaki belirteç (token) ile bir daveti reddeder. Kabul etme işleminde olduğu gibi, bu da kendi kimliğinizle gerçekleştirdiğiniz bir işlemdir ve başka bir hesapta çalışırken reddedilir.

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/invites/decline" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "invite_token": "1f4c…" }'

Yanıt

{
  "success": true,
  "message": "Team invite declined."
}

Departmanlar #

Bir departman, ekibinizin adlandırılmış bir grubudur — Satış, Müşteri desteği, İK gibi. Bir potansiyel müşteriye bir sahip ekip atar, kendi başına yeni konuşmaları üstlenebilir ve bir üyenin neleri görebileceğini sınırlamak için kullanılabilir.

Bu dört uç nokta bir API anahtarı gerektirir. Bu sayfanın geri kalanının aksine, API’deki diğer tüm uç noktalar gibi kimlik doğrulaması yaparlar (bkz. Kimlik Doğrulama). Oturum açmış bir oturum da işe yarar: okuma işlemi view adresinde contacts gerektirir; oluşturma, değiştirme veya silme işlemleri ise edit adresinde team_management gerektirir.

Departman nesnesi

Hem routing_agents hem de routing_channels ayarlandığında, bir konuşmanın burada dosyalanması için her ikisiyle de eşleşmesi gerekir — bir ekibe “destek temsilcisi, ancak sadece WhatsApp’ta” kuralını bu şekilde verirsiniz.

Bir hesapta en fazla 50 departman bulunabilir.

Departmanları listele #

GET /team/departments

curl "https://api.youraiconnector.com/v1/team/departments?apiKey=YOUR_API_KEY"

Yanıt

{
  "success": true,
  "departments": [
    {
      "id": "dep_abc123",
      "name": "Sales",
      "color": "#2f6fed",
      "member_uids": ["uid_alice", "uid_bob"],
      "auto_assign_enabled": true,
      "routing_agents": [],
      "routing_channels": ["whatsapp"],
      "created_by": "owner_uid_123"
    }
  ]
}

Departman oluştur #

POST /team/departments

İstek alanları

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/departments?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales",
    "color": "#2f6fed",
    "member_uids": ["uid_alice", "uid_bob"],
    "routing_channels": ["whatsapp"]
  }'

JavaScript

const res = await fetch("https://api.youraiconnector.com/v1/team/departments", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "Sales",
    color: "#2f6fed",
    member_uids: ["uid_alice", "uid_bob"],
    routing_channels: ["whatsapp"],
  }),
});
const { department } = await res.json();

Python

import requests

res = requests.post(
    "https://api.youraiconnector.com/v1/team/departments",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "name": "Sales",
        "color": "#2f6fed",
        "member_uids": ["uid_alice", "uid_bob"],
        "routing_channels": ["whatsapp"],
    },
)
department = res.json()["department"]

Yanıt — 201 Created

{
  "success": true,
  "department": {
    "id": "dep_abc123",
    "name": "Sales",
    "color": "#2f6fed",
    "member_uids": ["uid_alice", "uid_bob"],
    "auto_assign_enabled": true,
    "routing_agents": [],
    "routing_channels": ["whatsapp"],
    "created_by": "owner_uid_123"
  }
}

Departmanı güncelle #

PATCH /team/departments/{departmentId}

Bir departmanı değiştirir. Yalnızca gönderdiğiniz alanlar değiştirilir.

curl -X PATCH "https://api.youraiconnector.com/v1/team/departments/dep_abc123?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "member_uids": ["uid_alice"], "auto_assign_enabled": false }'

Yanıt

{
  "success": true,
  "department": {
    "id": "dep_abc123",
    "name": "Sales",
    "color": "#2f6fed",
    "member_uids": ["uid_alice"],
    "auto_assign_enabled": false,
    "routing_agents": [],
    "routing_channels": ["whatsapp"],
    "created_by": "owner_uid_123"
  }
}

Tanınmayan alanlar gönderilmesi 400 döndürür; bilinmeyen bir departman 404 döndürür; başka bir departmanla çakışan bir isim 409 döndürür.

Bir departmanı silme #

DELETE /team/departments/{departmentId}

curl -X DELETE "https://api.youraiconnector.com/v1/team/departments/dep_abc123?apiKey=YOUR_API_KEY"

Yanıt

{
  "success": true,
  "deleted": "dep_abc123"
}

Birinin erişiminin kısıtlı olduğu bir departmanı silme işlemi reddedilir. 400 yanıtı, görünürlükleri bu departmanla sınırlandırılmış üyelerin isimlerini verir, böylece önce onların kapsamını yeniden ayarlayabilirsiniz. Bu kasıtlıdır: onları sessizce kısıtlamadan çıkarmak, hiçbir uyarı olmaksızın tüm müşteri tabanınızı görmelerine neden olur.

Silinen bir departman altında dosyalanan kişiler yeniden yazılmaz; sadece bir departman göstermeyi bırakırlar ve onları bir sonraki dosyalayışınızda bu durum geçerli olur.

Kendi izinlerinizi kontrol edin #

GET /team/permissions

Oturum açmış kişinin şu anda üzerinde çalıştığı hesapta neler yapabileceğini döndürür. Bir üyenin kullanamayacağı düğmeleri, hatayla karşılaşmalarını beklemek yerine gizlemek için bunu kullanın.

cURL

curl "https://api.youraiconnector.com/v1/team/permissions" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

Yanıt — hesap sahibi

{
  "success": true,
  "role": "owner",
  "is_team_mode": false,
  "permissions": {
    "campaigns": "full",
    "contacts": "full",
    "messages": "full",
    "appointments": "full",
    "settings": "full",
    "billing": "full",
    "team_management": "full",
    "analytics": "full",
    "phone_numbers": "full",
    "integrations": "full",
    "faqs": "full",
    "daily_summaries": "full"
  }
}

Yanıt — bir hesap içinde çalışan ekip üyesi

{
  "success": true,
  "role": "editor",
  "is_team_mode": true,
  "permissions": { "campaigns": "edit", "billing": "none", "…": "…" },
  "member": {
    "uid": "uid_sam",
    "email": "sam@example.com",
    "display_name": "Sam Rivera",
    "account_owner_uid": "owner_uid_123"
  }
}

Oturum açmış kişi hesap sahibi olduğunda role değeri owner olur; aksi takdirde bu, ekip rolüdür. member yalnızca ekip modunda mevcuttur ve üyelikleri olduğunda contact_scope, contact_scope_unassigned ve contact_scope_axes değerlerini taşır.

Oturum belirteçleri #

Beş uç nokta, hesaplar arasında geçiş yapmak için tek kullanımlık bir oturum açma belirteci oluşturur. Hepsi aynı şekilde yanıt verir:

{
  "success": true,
  "customToken": "eyJhbGciOi…"
}

Belirteç, Firebase istemci SDK’sı ile bir oturum için değiştirilir. Bu bir API anahtarı değildir ve bu şekilde gönderilemez, bu nedenle bu uç noktalar yalnızca birinci taraf bir uygulama içinde kullanışlıdır.

Oturumun buna yetkisi olmadığında her biri 403 ile reddeder: o hesaba üye olunmaması, personel olunmaması, o alt hesabın ajansınızda bulunmaması veya size verilmemiş olması ya da oturumun uç noktanın gerektirdiği modda olmaması durumları.

Bir platform rolü atayın #

POST /team/users/{targetUid}/role

Bir kullanıcının platform rolünü ayarlar — User, Dev, Support veya Agency. Bu, ekip üyeliği değildir: birinin ne tür bir Your AI Connector hesabına sahip olduğudur.

Bu uç nokta Your AI Connector personeli ile sınırlıdır ve son kalan Dev yetkisi düşürülemez. Eksiksiz olması için listelenmiştir; kendi ekibinizi yönetmenin bir parçası değildir.

{
  "success": true,
  "targetUid": "uid_sam",
  "role": "Agency",
  "claimUpdated": true
}

Ekip API hataları #

Ekip uç noktaları, HTTP durumuyla birlikte her zaman error_code içeren standart hata zarfını döndürür:

{
  "success": false,
  "error_code": 403,
  "error": "Cannot grant \"full\" access to \"billing\" — exceeds your own permissions."
}

Her uç noktanın döndürebileceği paylaşılan kodlar — 429 (hız sınırı) ve 500 — Hatalar ve Sayfalandırma bölümünde yeniden deneme rehberliği ile listelenmiştir.

İlgili #

• Ekip Yönetimi — kontrol panelindeki aynı özellikler, ekran görüntüleriyle birlikte.
• Kimlik Doğrulama — API anahtarı yerine Firebase kimlik belirteci gönderme.
• Kişiler API’si — bir üyenin görünürlük sınırlarının uygulandığı kişiler.