Bağlantılar¶

Bağlantı, bir TEBHOS hesabını TEBHOS dışındaki bir şeye bağlar: kullanıcının denetiminde olduğunu kanıtladığı bir alan adına veya desteklenen harici bir hizmetteki bir hesaba. Görüntüleyenin görmesine izin verilen doğrulanmış bağlantılar, kullanıcının profilinde connected_accounts içinde görünür (bkz. Kullanıcılar).

Her /users/@me/connections yolu bir kullanıcı oturum token'ı gerektirir; yalnızca Bağlantıları listele ayrıca connections kapsamlı bir OAuth2 erişim token'ını da kabul eder. Geçerli bir bot token'ı 403 ACCESS_DENIED ile reddedilir (geçersiz olanı 401 ile); diğer bağlantı yollarındaki geçerli bir erişim token'ı da öyle. Bağlantı kimlikleri snowflake değil, dizedir.

Hesap bağlantı sınırı¶

Bir hesap tüm türlerde toplam en fazla 20 bağlantıya sahip olabilir. Bir tane daha oluşturmak 400 BAD_REQUEST döndürür.

Bağlantı nesnesi¶

Bir bağlantı, türü ve id değerinden oluşan çiftle tanımlanır. İkisi de bağlantı başına her yolun adresinde yer alır.

Yapı¶

Örnek¶

{
  "id": "12345678",
  "type": "github",
  "name": "partyparrot",
  "verified": true,
  "visibility_flags": 1,
  "sort_order": 0
}

Bağlantı türleri¶

Bir sağlayıcı türü yalnız örnekte (instance) onun için kimlik bilgileri varsa kullanılabilir. Hangilerinin etkin olduğunu Bağlantı sağlayıcılarını listele bildirir. Steam OpenID kullanır ve her zaman etkindir.

Bağlantı görünürlük bayrakları¶

Bayraklar, sahibin profilini görüntüleyenlerden hangilerinin bir bağlantıyı göreceğine karar verir.

İstek başka bir değer belirtmedikçe yeni bir bağlantı EVERYONE (1) alır. 0 değeri bağlantıyı, sahibinin kendi profiline bakışı dahil herkesten gizler. Doğrulanmamış bir bağlantı, bayrakları ne olursa olsun profilde asla görünmez. Bağlantıları listele bayrakları yok sayar ve hesabın sahip olduğu her bağlantıyı döndürür.

Bağlantı doğrulama nesnesi¶

Bağlantı başlat tarafından döndürülür. Doğrula ve bağlantı oluştur başarılı olana kadar bağlantı oluşmaz.

Yapı¶

Kanıt token'ı yalnız hesaba ve küçük harfe çevrilmiş alan adına bağlıdır; bu yüzden aynı alan adı için Bağlantı başlat yinelendiğinde aynı token döner ve yayımlanan bir kayıt denemeler boyunca yerinde kalabilir.

Alan adı sahipliği kanıtı¶

Token iki yoldan biriyle yayımlanır:

• DNS: _tebhos.<domain> adresinde değeri tam olarak tebhos-verification=<token> olan bir TXT kaydı. TEBHOS kaydı DNS-over-HTTPS üzerinden çözümler; bu yüzden doğrulamadan önce DNS değişikliklerinin yayılması için zaman tanınmalıdır.
• HTTPS: yalın token https://<domain>/.well-known/tebhos-verification adresinden sunulur. Yanıtın durumu 2xx olmalı, gövdesi en fazla 4096 bayt olmalı ve boşluklar kırpıldıktan sonra token'a eşit olmalıdır. Yönlendirmeler izlenmez ve istek 5 saniye sonra zaman aşımına uğrar.

Alan adı bir . içermeli ve yalnız ASCII harfler, rakamlar, . ve - karakterlerinden oluşmalıdır. Diğer her değer kanıtta başarısız olur.

Bağlantıları listele¶

GET /users/@me/connections

Hesabın sahip olduğu her bağlantı nesnesinden oluşan, sort_order değerine göre sıralanmış bir dizi döndürür. Bağlantısı olmayan bir hesap boş dizi alır.

connections kapsamlı bir OAuth2 erişim token'ını da kabul eder; bu kapsamı olmayan bir token 403 MISSING_OAUTH_SCOPE alır.

Hız sınırı¶

connection:list kovasında her hesap için dakikada 60 istek.

Bağlantı sağlayıcılarını listele¶

GET /users/@me/connections/providers

Sağlayıcı bağlantı türlerini ve her birinin bu örnekte etkin olup olmadığını döndürür.

Yanıt¶

Bağlantı başlat¶

POST /users/@me/connections

Alan adı sahipliği doğrulamasını başlatır ve bir bağlantı doğrulama nesnesi döndürür. Henüz bağlantı oluşturulmaz.

JSON gövdesi¶

Yanıt¶

Hız sınırı¶

connection:create kovasında her hesap için dakikada 5 istek.

Doğrula ve bağlantı oluştur¶

POST /users/@me/connections/verify

Bir başlatma token'ı için alan adı sahipliği kanıtını denetler; başarılı olursa bağlantı nesnesini oluşturur ve 201 durumuyla döndürür.

JSON gövdesi¶

Yanıt¶

Başlatma token'ı süresi dolana kadar kullanılabilir kalır; bu yüzden kanıtı henüz görünür olmayan bir istemci aynı token ile yeniden deneyebilir.

Yan etkiler¶

Başarı durumunda eksiksiz, sıralanmış liste hesabın oturumlarına {"connections": [...]} yüküyle bir USER_CONNECTIONS_UPDATE Gateway olayı olarak gönderilir.

Hız sınırı¶

connection:verify_and_create kovasında her hesap için dakikada 5 istek.

Bir bağlantıyı yeniden doğrula¶

POST /users/@me/connections/{type}/{connection_id}/verify

Mevcut bir domain bağlantısının sahiplik kanıtını yeniden çalıştırır. Başarılı olursa güncellenmiş bağlantı nesnesini döndürür.

Yol parametreleri¶

Yanıt¶

Başarısız bir kanıt, daha önce doğrulanmış bir bağlantıyı doğrulanmamış olarak işaretler ve bu da onu profilden kaldırır. Bir hesabın doğrulanmış alan adı bağlantılarını yeniden denetleyen bir arka plan görevi de aynısını yapabilir.

Hız sınırı¶

connection:verify kovasında her hesap için dakikada 5 istek.

Bağlantıyı güncelle¶

PATCH /users/@me/connections/{type}/{connection_id}

Bir bağlantının görünürlüğünü veya konumunu günceller. Atlanan alan değişmeden kalır. Güncellenmiş bağlantı nesnesini döndürür.

Yol parametreleri¶

JSON gövdesi¶

İki yol parametresi de aynı bağlantıyı belirtmelidir: yanlış tür altında doğru bir kimlik 404 döndürür. İki bağlantı aynı sort_order değerini paylaşabilir.

Yanıt¶

Yan etkiler¶

Eksiksiz listeyi USER_CONNECTIONS_UPDATE içinde gönderir.

Hız sınırı¶

connection:update kovasında her hesap için dakikada 30 istek; Bağlantıları yeniden sırala ile paylaşılır.

Bağlantıyı sil¶

DELETE /users/@me/connections/{type}/{connection_id}

Bir bağlantıyı kaldırır. 204 döndürür.

Yol parametreleri¶

Yanıt¶

Silme işlemi anında gerçekleşir ve geri alınamaz. Diğer bağlantılar sort_order değerlerini korur. Bir sağlayıcı bağlantısını silmek harici hizmette hiçbir şeyi iptal etmez.

Yan etkiler¶

Kalan listeyi USER_CONNECTIONS_UPDATE içinde gönderir.

Hız sınırı¶

connection:delete kovasında her hesap için dakikada 10 istek.

Bağlantıları yeniden sırala¶

PATCH /users/@me/connections/reorder

Listelenen bağlantıların görüntülenme sırasını dizideki konumlarına göre ayarlar. 204 döndürür.

JSON gövdesi¶

Listelenen her bağlantı, sıfırdan başlayan dizi indeksini sort_order olarak alır. Bilinmeyen kimlikler yok sayılır; listelenmeyen bağlantılar mevcut değerlerini korur, bu yüzden kısmi bir liste iki bağlantının aynı konumu paylaşmasına yol açabilir.

Yan etkiler¶

Hiçbir şey değişmemiş olsa bile eksiksiz listeyi USER_CONNECTIONS_UPDATE içinde gönderir.

Hız sınırı¶

connection:update kovasında her hesap için dakikada 30 istek; Bağlantıyı güncelle ile paylaşılır.

Sağlayıcı yetkilendirmesini başlat¶

POST /users/@me/connections/{provider}/authorize

Harici bir hesabı bağlamayı başlatır. {"authorize_url": string} döndürür; bu URL bir tarayıcı penceresinde açılır (TEBHOS bir açılır pencere açar).

Yol parametreleri¶

Yanıt¶

Akışı tamamlama¶

Harici hizmet tarayıcıyı API üzerindeki GET /connections/{provider}/callback adresine geri döndürür. İstemciler bu yolu kendileri çağırmaz. Yol, sonucu bildiren ve kısa bir süre sonra pencereyi kapatan küçük bir HTML sayfasıyla yanıt verir.

Yetkilendirme durumu on dakika geçerlidir ve bir kez tamamlanabilir. Spotify ve X, PKCE kullanır.

Başarı durumunda TEBHOS, id değeri harici hizmetteki hesap kimliği, name değeri o hesabın görünen adı olan, EVERYONE görünürlüğünde doğrulanmış bir bağlantı oluşturur ve USER_CONNECTIONS_UPDATE gönderir. Aynı harici hesabı yeniden bağlamak, kopya oluşturmak yerine adını ve doğrulama zamanını yeniler. Kullanıcı iptal ettiğinde, durumun süresi dolduğunda, değişim başarısız olduğunda veya hesabın zaten 20 bağlantısı olduğunda sayfa bir hata bildirir.

Bluesky yolları¶

Bu yollar, Bluesky bağlantıları için geliştirilmiş istemcilerin açık bir yanıt alması için vardır. Bluesky TEBHOS'ta etkin değildir.