# API erişimini kullanın

> Betikler ve MCP istemcileri için kişisel erişim belirteçleri oluşturun ve webhook'larla Livespace'inizdeki olayları kendi sistemlerinize gönderin.

Ayarlar › **API Erişimi** bölümünde kişisel erişim belirteçleri oluşturabilirsiniz. Böylece bir betik veya MCP istemcisi Dvina'yı sizin adınıza kullanabilir. Yöneticiler, Livespace'teki olayları kendi sistemlerine göndermek için bu bölümde webhook da ekleyebilir.

API Erişimi, Enterprise planına dahildir. Her üye kendi belirteçlerini oluşturabilir; **Webhook'lar** bölümünü yalnızca sahipler ve yöneticiler görür.

## Belirteç oluşturun

1. Ayarlar'ı açın ve **API Erişimi**'ni seçin.
2. **Kişisel Erişim Belirteçleri** altında **Belirteç Oluştur**'u seçin.
3. Daha sonra belirtecin ne için kullanıldığını anlayabilmek için bir **Ad** girin.
4. **Erişim** türünü seçin: **Salt okunur** veya **Okuma ve yazma**.
5. **Son Kullanma Tarihi**'ni seçin: **30 gün sonra**, **90 gün sonra**, **365 gün sonra** veya **Süresiz**.
6. **Belirteç Oluştur**'u seçin.
7. **Belirtecinizi Kopyalayın** altında belirteci kopyalayın ve güvenli bir yerde saklayın. Belirteç yalnızca bu aşamada gösterilir.

Belirteç, oluşturduğunuz Livespace'te, oradaki güncel rolünüzle sizin adınıza çalışır. **Salt okunur** bir belirteç verileri okuyabilir ancak hiçbir şey ekleyemez veya değiştiremez.

Bir belirteci MCP istemcisiyle kullanmak için [OAuth yerine API anahtarıyla bağlanın](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth) bölümüne bakın.

## Belirteci kontrol edin, yenileyin veya iptal edin

Belirteçleriniz, erişim türleriyle birlikte **Kişisel Erişim Belirteçleri** altında listelenir. Bir belirteci seçerek **Başlangıç Karakterleri**'ni, **Erişim** türünü, **Son Kullanım** zamanını ve **Son Kullanma Tarihi**'ni görebilirsiniz.

- **Belirteci değiştirmek için** **Yenile…**'yi seçin, ardından onaylamak için **Yenile**'yi seçin. Yerine yeni bir belirteç oluşturulur ve eskisi hemen çalışmayı durdurur. **Belirtecinizi Kopyalayın** altında yeni belirteci kopyalayın.
- **Belirteci devre dışı bırakmak için** **İptal Et…**'i seçin, ardından onaylamak için **İptal Et**'i seçin. Belirteci kullanan her şey hemen çalışmayı durdurur.

Belirteç oluşturma, yenileme ve iptal etme işlemleri [denetim günlüğüne](/docs/teams/audit-log) kaydedilir.

## Webhook ekleyin

Webhook, Livespace'teki olayları seçtiğiniz bir adrese gönderir. Bunlar [denetim günlüğündeki](/docs/teams/audit-log) kayıtlarla aynıdır.

1. Ayarlar › **API Erişimi** bölümünde, **Webhook'lar** altında **Webhook Ekle**'yi seçin.
2. Bir **Ad** ve **URL** girin. Herkese açık bir HTTPS URL'si kullanın.
3. **Olaylar** alanını tüm olaylar için boş bırakın veya `member.added` ya da `sharing.*` gibi eylemleri ve alanları listeleyin.
4. **Ekle**'yi seçin.
5. **İmzalama Sırrını Kopyalayın** altında sırrı kopyalayın. Sır yalnızca bu aşamada gösterilir.

Dvina **Bu adrese Dvina'dan ulaşılamıyor** mesajını gösterirse herkese açık bir HTTPS URL'si kullanın.

### Her isteğin imzasını kontrol edin

Dvina, olayları JSON biçiminde toplu olarak gönderir ve her isteği imzalar. İsteğin Dvina'dan geldiğini doğrulamak için imzalama sırrını kullanın:

- Her istekte `t=<timestamp>,v1=<signature>` biçiminde bir `X-Dvina-Signature` üst bilgisi bulunur.
- İmza; zaman damgası, bir nokta ve istek gövdesinin birleştirilmesiyle elde edilen verinin, imzalama sırrınız kullanılarak hesaplanan onaltılık biçimdeki HMAC-SHA256 değeridir.
- Bu değeri kendiniz hesaplayıp karşılaştırın. İmzası eşleşmeyen veya zaman damgası çok eski olan istekleri reddedin.

## Bir webhook'u kontrol edin veya değiştirin

Webhook'larınız **Webhook'lar** altında durumlarıyla birlikte listelenir: **Açık**, **Duraklatıldı** veya **Hata Veriyor**. Ayrıntılarını görmek için birini seçin.

- **Değiştirmek için** **Ad**, **URL** veya **Olaylar** alanlarını düzenleyin, ardından **Kaydet**'i seçin.
- **Duraklatmak için** **Olayları Gönder**'i kapatın. Göndermeye devam etmek için tekrar açın.
- **Nasıl çalıştığını görmek için** **Durum**'unu ve **Gönderilen** olay sayısını kontrol edin. Hata veren bir webhook'un **Son Hata** bilgisi gösterilir. Dvina denemeye devam eder ve hatayı denetim günlüğüne kaydeder.
- **Gizli anahtarını değiştirmek için** **Yeni İmzalama Anahtarı…** seçeneğini seçin, ardından onaylayın. İstekler hemen yeni gizli anahtarla imzalanmaya başlar; bu nedenle alıcıyı gecikmeden güncelleyin.
- **Kaldırmak için** **Sil…** seçeneğini, ardından onaylamak için **Sil**'i seçin. Bu webhook'a artık hiçbir şey gönderilmez.

## İlgili konular

- [Dvina'yı MCP ile diğer uygulamalardan kullanın](/docs/dvina-mcp/overview)
- [Denetim günlüğünü kullanın](/docs/teams/audit-log)
- [Ekiplere genel bakış](/docs/teams/overview)