mirror of
https://github.com/Finb/Bark.git
synced 2025-12-08 21:36:01 +00:00
docs/ has been updated. Turkish language added.
This commit is contained in:
parent
19f51b5948
commit
f8caf77d22
@ -1,4 +1,5 @@
|
||||
* Translations
|
||||
- [:cn: 简体中文](/)
|
||||
- [:uk: English](/en-us/)
|
||||
- [:tr: Türkçe](/tr/)
|
||||
|
||||
|
||||
@ -23,7 +23,7 @@
|
||||
subMaxLevel: 4,
|
||||
loadNavbar: true,
|
||||
auto2top: true,
|
||||
coverpage: ['/', '/en-us/'],
|
||||
coverpage: ['/', '/en-us/', '/tr/'],
|
||||
}
|
||||
</script>
|
||||
<!-- Docsify v4 -->
|
||||
|
||||
34
docs/tr/README.md
Normal file
34
docs/tr/README.md
Normal file
@ -0,0 +1,34 @@
|
||||
|
||||
### Bark <!-- {docsify-ignore-all} -->
|
||||
- Ücretsiz, hafif! Kendi iPhone'unuza anlık bildirimler göndermek için arayüzü çağırmanız yeterlidir.
|
||||
- Apple APN'lerine bağlıdır, zamanında, istikrarlı ve güvenilirdir
|
||||
- Cihazın pil gücünü tüketmez. Sistem anlık bildirim hizmeti ve anlık bildirim uzantısına bağlı olarak, APP'nin kendisinin çalışması gerekmez.
|
||||
- Gizlilik ve güvenlik. Yazarın kendisi de dahil olmak üzere hiç kimsenin bazı yollarla gizliliğinizi çalamayacağından emin olabilirsiniz.<br>*[Gizlilik ve güvenliğin](/tr/privacy) nasıl sağlanacağına ilişkin ayrıntılar için tıklayın*
|
||||
|
||||
### Kaynak Kodu
|
||||
- [Bark](https://github.com/Finb/Bark) özel anlık bildirimler almak için tamamen açık kaynaklı bir iOS uygulamasıdır
|
||||
- [bark-server](https://github.com/Finb/bark-server) kullanıcı anlık bildirim isteklerini almak ve bunları Apple APNS'ye iletmek için tamamen açık kaynaklı bir Bark hizmeti arka ucudur.
|
||||
|
||||
### Geri Bildirim
|
||||
- [Telegram Grubu](https://t.me/joinchat/OsCbLzovUAE0YjY1) (Not: gruba katılmak için doğrulamaya tıklayın)
|
||||
- [GitHub Sorunlar](https://github.com/Finb/Bark/issues)
|
||||
|
||||
### Ücretsiz
|
||||
Bark **Temmuz 2018**'de başlatıldı ve en az **Temmuz 2031**'e kadar işletilmeye devam edecek. *("Kalıcı" kelimesini söyleyemem, hala talep varsa daha sonra yenileyelim.)*<br>
|
||||
Uygulama, bakım süresi boyunca herhangi bir şekilde ücretlendirilmeyecek veya reklam içermeyecektir. Kullanmaktan çekinmeyin.
|
||||
|
||||
### Sponsorluk
|
||||
Şu anda yalnızca GitHub sponsorluğunu kabul ediyoruz. Her sponsor için çok teşekkür ederim<br>
|
||||
Sponsorlar:[https://github.com/sponsors/Finb](https://github.com/sponsors/Finb)
|
||||
|
||||
### Dokümantasyon
|
||||
- **Uygulama**
|
||||
- [Öğretici](/tr/tutorial)
|
||||
- [Şifreleme](/tr/encryption)
|
||||
- [SSS](/tr/faq)
|
||||
- **Sunucu**
|
||||
- [Dağıtım](/tr/deploy)
|
||||
- [Doğrudan Gönderim](/tr/apns)
|
||||
- [Oluşturmak](/tr/build)
|
||||
- [Sertifika](/tr/cert)
|
||||
- [Gizlilik](/tr/privacy)
|
||||
11
docs/tr/_coverpage.md
Executable file
11
docs/tr/_coverpage.md
Executable file
@ -0,0 +1,11 @@
|
||||

|
||||
|
||||
# Bark <small></small>
|
||||
|
||||
> Gizlilik odaklı, güvenli ve kontrol edilebilir bir özel anlık bildirim aracı.
|
||||
|
||||
- Ücretsiz, basit ve güvenli
|
||||
- Kullanıma hazır
|
||||
|
||||
[GitHub](https://github.com/finb/bark)
|
||||
[Başlamak](#bark)
|
||||
11
docs/tr/_sidebar.md
Normal file
11
docs/tr/_sidebar.md
Normal file
@ -0,0 +1,11 @@
|
||||
- [Bark](/tr/#bark)
|
||||
- **Uygulama**
|
||||
- [Öğretici](/tr/tutorial)
|
||||
- [Şifreleme](/tr/encryption)
|
||||
- [SSS](/tr/faq)
|
||||
- **Sunucu**
|
||||
- [Dağıtım](/tr/deploy)
|
||||
- [Doğrudan Gönderim](/tr/apns)
|
||||
- [Oluşturmak](/tr/build)
|
||||
- [Sertifika](/tr/cert)
|
||||
- [Gizlilik](/tr/privacy)
|
||||
55
docs/tr/apns.md
Normal file
55
docs/tr/apns.md
Normal file
@ -0,0 +1,55 @@
|
||||
### APNS Arayüzünü Doğrudan Kullanma
|
||||
Eğer cihazınızın DeviceToken'ı varsa (Uygulama içinde bulunabilir), doğrudan Apple APNS arayüzünü çağırarak cihaza anlık bildirim gönderebilirsiniz. Ayrıca, Uygulamaya sunucu eklemeye gerek yoktur.<br>
|
||||
Aşağıda komut satırında anlık bildirim gönderme örneği verilmiştir:
|
||||
|
||||
```shell
|
||||
# Çevresel değişkenleri ayarla
|
||||
# Key'i indir https://raw.githubusercontent.com/Finb/bark-server/master/deploy/AuthKey_LH4T9V5U4R_5U8LBRXG3A.p8
|
||||
# Key dosyasının yolunu aşağıya gir
|
||||
TOKEN_KEY_FILE_NAME=
|
||||
# Uygulama ayarlarından kopyalanan DeviceToken'ı buraya yapıştır
|
||||
DEVICE_TOKEN=
|
||||
|
||||
# Aşağıdakileri değiştirmeyin !!!
|
||||
TEAM_ID=5U8LBRXG3A
|
||||
AUTH_KEY_ID=LH4T9V5U4R
|
||||
TOPIC=me.fin.bark
|
||||
APNS_HOST_NAME=api.push.apple.com
|
||||
|
||||
# TOKEN oluştur
|
||||
JWT_ISSUE_TIME=$(date +%s)
|
||||
JWT_HEADER=$(printf '{ "alg": "ES256", "kid": "%s" }' "${AUTH_KEY_ID}" | openssl base64 -e -A | tr -- '+/' '-_' | tr -d =)
|
||||
JWT_CLAIMS=$(printf '{ "iss": "%s", "iat": %d }' "${TEAM_ID}" "${JWT_ISSUE_TIME}" | openssl base64 -e -A | tr -- '+/' '-_' | tr -d =)
|
||||
JWT_HEADER_CLAIMS="${JWT_HEADER}.${JWT_CLAIMS}"
|
||||
JWT_SIGNED_HEADER_CLAIMS=$(printf "${JWT_HEADER_CLAIMS}" | openssl dgst -binary -sha256 -sign "${TOKEN_KEY_FILE_NAME}" | openssl base64 -e -A | tr -- '+/' '-_' | tr -d =)
|
||||
# Eğer koşullar elverişliyse, en iyi performans için bu betiği geliştirerek TOKEN'ı önbelleğe almanız iyi olur.
|
||||
# Aynı TOKEN'i 30 dakika içinde tekrar kullanmak, her 30 dakikada bir yeniden oluşturmaktan daha iyidir.
|
||||
# Apple dokümantasyonu, TOKEN'ın en erken 20 dakika arayla yeniden oluşturulabileceğini belirtmektedir. TOKEN'ın maksimum geçerlilik süresi 60 dakikadır.
|
||||
# Ancak, sık sık yeniden oluşturmak TOKEN'ın başarısız olmasına neden olabilir.
|
||||
# Bu bilgiyi paylaşmak istiyoruz, belki sık sık TOKEN oluşturmak nedeniyle anlık bildirim gönderiminde sorun yaşanabilir.
|
||||
AUTHENTICATION_TOKEN="${JWT_HEADER}.${JWT_CLAIMS}.${JWT_SIGNED_HEADER_CLAIMS}"
|
||||
|
||||
# Anlık bildirim gönderme
|
||||
curl -v --header "apns-topic: $TOPIC" --header "apns-push-type: alert" --header "authorization: bearer $AUTHENTICATION_TOKEN" --data '{"aps":{"alert":"test"}}' --http2 https://${APNS_HOST_NAME}/3/device/${DEVICE_TOKEN}
|
||||
|
||||
```
|
||||
|
||||
### Push Parametre Formatı
|
||||
Bknz. https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/generating_a_remote_notification<br>
|
||||
"mutable-content" : 1 getirdiğinizden emin olun, aksi takdirde anlık bildirim uzantısı çalışmayacak ve anlık bildirimi kaydetmeyecektir.
|
||||
|
||||
Örnek:
|
||||
```js
|
||||
{
|
||||
"aps": {
|
||||
"mutable-content": 1,
|
||||
"alert": {
|
||||
"title" : "Başlık",
|
||||
"body": "İçerik"
|
||||
},
|
||||
"category": "bildirimGrubu",
|
||||
"sound": "minuet.caf"
|
||||
},
|
||||
"icon": "https://day.app/assets/images/avatar.jpg"
|
||||
}
|
||||
```
|
||||
47
docs/tr/build.md
Normal file
47
docs/tr/build.md
Normal file
@ -0,0 +1,47 @@
|
||||
## Kaynak Kodu İndirme
|
||||
GitHub'dan kaynak kodunu indirin: [bark-server](https://github.com/Finb/bark-server)
|
||||
|
||||
veya
|
||||
```sh
|
||||
git clone https://github.com/Finb/bark-server.git
|
||||
```
|
||||
## Gerekli Bağımlılıkları Yapılandırma
|
||||
- Golang 1.18+
|
||||
- Go Mod (env GO111MODULE=on)
|
||||
- Go Mod Proxy (env GOPROXY=https://goproxy.cn)
|
||||
- [go-task](https://taskfile.dev/installation/) kurulu olmalı.
|
||||
|
||||
## Tüm Platformlar İçin Çapraz Derleme
|
||||
```sh
|
||||
task
|
||||
```
|
||||
|
||||
## Belirli Bir Platform İçin Derleme
|
||||
```sh
|
||||
task linux_amd64
|
||||
task linux_amd64_v3
|
||||
```
|
||||
|
||||
## Desteklenen Platformlar
|
||||
|
||||
- linux_386
|
||||
- linux_amd64
|
||||
- linux_amd64_v2
|
||||
- linux_amd64_v3
|
||||
- linux_amd64_v4
|
||||
- linux_armv5
|
||||
- linux_armv6
|
||||
- linux_armv7
|
||||
- linux_armv8
|
||||
- linux_mips_hardfloat
|
||||
- linux_mipsle_softfloat
|
||||
- linux_mipsle_hardfloat
|
||||
- linux_mips64
|
||||
- linux_mips64le
|
||||
- windows_386.exe
|
||||
- windows_amd64.exe
|
||||
- windows_amd64_v2.exe
|
||||
- windows_amd64_v3.exe
|
||||
- windows_amd64_v4.exe
|
||||
- darwin_amd64
|
||||
- darwin_arm64
|
||||
6
docs/tr/cert.md
Normal file
6
docs/tr/cert.md
Normal file
@ -0,0 +1,6 @@
|
||||
Bark'ı kendi sistemine entegre etmeniz veya arka uç kodunu yeniden uygulamanız gerektiğinde, anlık bildirim sertifikasına ihtiyacınız olabilir.
|
||||
|
||||
##### Geçerlilik Süresi: *Süresiz*
|
||||
##### Anahtar Kimliği (Key ID):*LH4T9V5U4R*
|
||||
##### Ekip Kimliği (TeamID):*5U8LBRXG3A*
|
||||
##### İndirme Bağlantısı:[AuthKey_LH4T9V5U4R_5U8LBRXG3A.p8](https://github.com/Finb/bark-server/releases/download/v1.0.2/AuthKey_LH4T9V5U4R_5U8LBRXG3A.p8)
|
||||
86
docs/tr/deploy.md
Normal file
86
docs/tr/deploy.md
Normal file
@ -0,0 +1,86 @@
|
||||
|
||||
## Docker
|
||||
```
|
||||
docker run -dt --name bark -p 8080:8080 -v `pwd`/bark-data:/data finab/bark-server
|
||||
```
|
||||
|
||||
## Docker-Compose
|
||||
```
|
||||
mkdir bark && cd bark
|
||||
curl -sL https://git.io/JvSRl > docker-compose.yaml
|
||||
docker-compose up -d
|
||||
```
|
||||
## Manuel Dağıtım
|
||||
|
||||
1. Platforma göre çalıştırılabilir dosyayı indirin.<br> <a href='https://github.com/Finb/bark-server/releases'>https://github.com/Finb/bark-server/releases</a><br>
|
||||
veya kendiniz derleyin<br>
|
||||
<a href="https://github.com/Finb/bark-server">https://github.com/Finb/bark-server</a>
|
||||
|
||||
2. Çalıştırın
|
||||
```
|
||||
./bark-server_linux_amd64 -addr 0.0.0.0:8080 -data ./bark-data
|
||||
```
|
||||
3. Gerekebilir
|
||||
```
|
||||
chmod +x bark-server_linux_amd64
|
||||
```
|
||||
Lütfen unutmayın ki bark-server varsayılan olarak verileri saklamak için /data dizinini kullanır. Bark-server'ın /data dizinine okuma ve yazma izinlerine sahip olduğundan emin olun veya farklı bir dizini belirtmek için `-data` seçeneğini kullanabilirsiniz.
|
||||
|
||||
## Sunucusuz Mimari (Serverless)
|
||||
|
||||
|
||||
Heroku ücretsiz dağıtım sunar (2022-11-28 tarihine kadar).<br>
|
||||
[](https://heroku.com/deploy?template=https://github.com/finb/bark-server)<br>
|
||||
|
||||
Web yönlendirmelerini destekleyen diğer serverless sunucuları, Serverless modunu etkinleştirmek için `bark-server -serverless true` komutunu kullanabilirsiniz.
|
||||
|
||||
Etkinleştirildiğinde, bark-server sistem ortam değişkenleri BARK_KEY ve BARK_DEVICE_TOKEN'ı okuyacaktır. Bu değerleri önceden ayarlamanız gerekmektedir.
|
||||
|
||||
| Değişken Adı | Gereksinimler |
|
||||
| ---- | ---- |
|
||||
| BARK_KEY | "push" dışında herhangi bir değer girilebilir. |
|
||||
| BARK_DEVICE_TOKEN | Bark App ayarlarında görünen DeviceToken. Bu Token gerçek APNS cihaz tokenidir, lütfen sızdırmayın. |
|
||||
|
||||
Lütfen Serverless modunun yalnızca bir cihaza izin verdiğini unutmayın.
|
||||
|
||||
## Render
|
||||
Render, ücretsiz bir bark-server oluşturmayı çok kolay hale getirir.
|
||||
1. [Render](https://dashboard.render.com/register/) hesabı oluşturun.
|
||||
2. [Yeni Web Hizmeti](https://dashboard.render.com/select-repo?type=web) oluşturun.
|
||||
3. Aşağıdaki URL'yi **Public Git repository** giriş kutusuna girin
|
||||
```
|
||||
https://github.com/Finb/bark-server
|
||||
```
|
||||
4. **Devam et**'i tıklayın ve formu doldurun
|
||||
* **Name** - Ad, herhangi bir ad seçin, örneğin bark-server.
|
||||
* **Region** - Sunucu bölgesi, size en yakın olanı seçin.
|
||||
* **Start Command** - Programı çalıştırma komutu, `./app -serverless true` şeklinde doldurun. (Lütfen ./app öncesindeki noktayı unutmayın)
|
||||
* **Instance Type** - *Free*'yi seçin, ücretsiz olan yeterlidir.
|
||||
* Seçenekleri genişletmek için **Advanced**'e tıklayın.
|
||||
* **Add Environment Variable**'a tıklayarak Serverless modu için gereken BARK_KEY ve BARK_DEVICE_TOKEN alanlarını ekleyin. (Gereksinimler için [Serverless](#Serverless) bölümüne bakın) <br><img src="_media/environment.png" />
|
||||
* Diğer seçenekler değiştirilmez
|
||||
5. Sayfanın alt kısmında **Create Web Service** düğmesine tıklayın ve durumun **In progress**'ten **Live**'a geçmesini bekleyin, bu birkaç dakika ila on dakika sürebilir.
|
||||
6. Sayfanın üst kısmında sunucu URL'nizi bulun, bu bark-server sunucu URL'si, Bark App'e ekleyebilirsiniz
|
||||
```
|
||||
https://[sizin-sunucu-adiniz].onrender.com
|
||||
```
|
||||
7. Sunucu ekleme başarısız olursa bir süre bekleyebilir ve tekrar deneyebilirsiniz. Servis henüz hazır olmayabilir.
|
||||
8. Bark App'e ekleme yapmanıza gerek yoktur, doğrudan çağrı yaparak anlık bildirim gönderebilirsiniz. BARK_KEY yukarıda doldurduğunuz anahtardır.
|
||||
```
|
||||
https://[sizin-sunucu-adiniz].onrender.com/BARK_KEY/推送内容
|
||||
```
|
||||
|
||||
## Test
|
||||
```
|
||||
curl http://0.0.0.0:8080/ping
|
||||
```
|
||||
Eğer **pong** dönerse, dağıtım başarılı demektir.
|
||||
|
||||
## Diğer
|
||||
|
||||
1. Uygulama tarafı sunucu tarafına <a href="https://developer.apple.com/documentation/uikit/uiapplicationdelegate/1622958-application">DeviceToken</a>göndermekten sorumludur.<br>Sunucu tarafı bir push isteği aldığında, Apple sunucusuna bir anlık bildirim gönderir. Ardından cep telefonu anlık bildirimi alır.
|
||||
|
||||
2. Sunucu kodu:<a href='https://github.com/Finb/bark-server'>https://github.com/Finb/bark-server</a><br>
|
||||
|
||||
3. Uygulama Kodu: <a href="https://github.com/Finb/Bark">https://github.com/Finb/Bark</a>
|
||||
|
||||
36
docs/tr/encryption.md
Normal file
36
docs/tr/encryption.md
Normal file
@ -0,0 +1,36 @@
|
||||
#### Anlık Bildirim şifreleme nedir?
|
||||
Anlık bildirim şifreleme, Anlık bildirim içeriğini korumak için bir yöntemdir ve gönderme ve alma sırasında Anlık bildirim içeriğini şifrelemek ve şifresini çözmek için özel bir anahtar kullanır. Bu şekilde, Anlık bildirim içeriği iletim sırasında Bark sunucusu ve Apple APNs sunucusu tarafından elde edilemez veya sızdırılamaz.
|
||||
|
||||
#### Özel anahtar ayarlama
|
||||
1. Uygulama ana sayfasını açın.
|
||||
2. "Anlık Bildirim Şifreleme"yi bulun, Şifreleme Ayarları'na tıklayın.
|
||||
3. Şifreleme algoritmasını seçin, ANAHTARI gerektiği gibi doldurun, özel anahtarı kaydetmek için Bitti'ye tıklayın.
|
||||
|
||||
#### Şifreli anlık bildirim gönderme
|
||||
Şifrelenmiş bir anlık bildirim göndermek için önce Bark istek parametrelerini json formatında bir dizeye dönüştürmeniz, ardından dizeyi şifrelemek için önceden ayarlanmış anahtarı ve ilgili algoritmayı kullanmanız ve son olarak şifrelenmiş şifre metnini sunucuya "ciphertext" parametresi olarak göndermeniz gerekir.<br><br>
|
||||
**Örneğin:**
|
||||
```sh
|
||||
#!/usr/bin/env bash
|
||||
|
||||
set -e
|
||||
|
||||
# bark anahtarı
|
||||
deviceKey='F5u42Bd3HyW8KxkUqo2gRA'
|
||||
# anlık bildirim gönderilen veri
|
||||
json='{"body": "test", "sound": "birdsong"}'
|
||||
|
||||
# 16 bit uzunluğunda olmalıdır
|
||||
key='1234567890123456'
|
||||
iv='1111111111111111'
|
||||
|
||||
# openssl, manuel anahtarların ve IV'lerin ASCII kodlamasını değil, Hex kodlamasını gerektirir.
|
||||
key=$(printf $key | xxd -ps -c 200)
|
||||
iv=$(printf $iv | xxd -ps -c 200)
|
||||
|
||||
ciphertext=$(echo -n $json | openssl enc -aes-128-cbc -K $key -iv $iv | base64)
|
||||
|
||||
# Konsol şunları yazdıracaktır "d3QhjQjP5majvNt5CjsvFWwqqj2gKl96RFj5OO+u6ynTt7lkyigDYNA3abnnCLpr"
|
||||
echo $ciphertext
|
||||
|
||||
curl --data-urlencode "ciphertext=$ciphertext" http://api.day.app/$deviceKey
|
||||
```
|
||||
46
docs/tr/faq.md
Normal file
46
docs/tr/faq.md
Normal file
@ -0,0 +1,46 @@
|
||||
#### Anlık bildirim kullanım limiti <!-- {docsify-ignore-all} -->
|
||||
Normal isteklerin (HTTP durum kodu 200) sınırı yoktur.<br>
|
||||
Ancak 5 dakika içinde 1000'den fazla hata isteği (HTTP durum kodu 400 404 500) yapılırsa, <b>IP 24 saat boyunca YASAKLANACAKTIR.</b>
|
||||
|
||||
#### Zamana duyarlı bildirimler çalışmıyor
|
||||
Sorunu çözmek için <b>cihazınızı yeniden başlatmayı</b> deneyebilirsiniz.
|
||||
|
||||
#### Bildirim geçmişi kaydedilemiyor veya kopyala düğmesine tıklamadan kilit ekranında aşağı iterek veya sola kaydırarak kopyalanamıyor
|
||||
Sorunu çözmek için <b>cihazınızı yeniden başlatmayı</b> deneyebilirsiniz.<br />
|
||||
Bazı nedenlerden dolayı, anlık bildirim hizmeti uzantısı ([UNNotificationServiceExtension](https://developer.apple.com/documentation/usernotifications/unnotificationserviceextension)) düzgün bir şekilde çalıştırılamadı ve bildirimleri kaydetme kodu düzgün bir şekilde yürütülmedi.
|
||||
|
||||
#### Otomatik kopyalama anlık bildirim hatası
|
||||
iOS 14.5 sürümünden sonra, izinlerin sıkılaştırılması nedeniyle, push bildirimi alırken içeriği otomatik olarak panoya kopyalamak mümkün değildir. <br/>
|
||||
Geçici olarak push bildirimini aşağı çekebilir veya ekran kilidinde sola kaydırarak görüntüleyip otomatik olarak kopyalayabilirsiniz, veya açılır penceredeki kopyala düğmesine tıklayabilirsiniz.
|
||||
|
||||
#### Bildirim geçmişi sayfasını varsayılan olarak aç
|
||||
Uygulamayı tekrar açtığınızda, son açılan sayfaya atlayacaktır.<br />
|
||||
Eğer geçmiş mesaj sayfasındaysanız, uygulamadan çıkın. Uygulamayı tekrar açtığınızda yine geçmiş mesaj sayfasında olacaksınız.
|
||||
|
||||
#### Anlık Bildirim API POST isteğini destekliyor mu?
|
||||
Bark GET POST'u destekler, Json kullanımını destekler.<br>
|
||||
Hangi istek yöntemi olursa olsun, parametre adları aynıdır. Bakınız [kullanım öğreticisi](tr/tutorial)
|
||||
|
||||
#### Özel karakterler anlık bildirim işleminde başarısızlığa neden oluyor. Örneğin: İtme içeriği bağlantı içeriyor veya + gibi özel karakterler boşluğa dönüşüyor.
|
||||
Bunun nedeni düzensiz bağlantı sorunudur. Sıklıkla olur<br>
|
||||
URL eklerken, URL kodlama parametrelerine dikkat edin
|
||||
|
||||
```sh
|
||||
# Örneğin
|
||||
https://api.day.app/key/{push content}
|
||||
|
||||
# Eğer {anlık bildirim içeriği} ise
|
||||
"a/b/c/"
|
||||
|
||||
# O zaman URLnin son durumu şöyledir
|
||||
https://api.day.app/key/a/b/c/
|
||||
# İlgili rota bulunamaz ve arka uç programı 404 döndürür
|
||||
|
||||
#Eklemeden önce {anlık bildirim içeriği} öğesini url kodlamalısınız
|
||||
https://api.day.app/key/a%2Fb%2Fc%2F
|
||||
```
|
||||
Gelişmiş bir HTTP kütüphanesi kullanırsanız, parametreler otomatik olarak işlenecek ve manuel kodlamaya ihtiyaç duymayacaksınız. <br>
|
||||
Ancak URL'yi kendiniz eklerseniz, parametrelerdeki özel karakterler için özel dikkat göstermeniz gerekir. **Özel karakterlerin varlığını dikkate almadan ve otomatik olarak URL kodlama katmanı uygulamak genellikle daha iyi bir yaklaşımdır.**
|
||||
|
||||
#### Gizlilik ve güvenlik nasıl sağlanır?
|
||||
Bakınız [gizlilik güvenlik](/tr/privacy)
|
||||
31
docs/tr/privacy.md
Normal file
31
docs/tr/privacy.md
Normal file
@ -0,0 +1,31 @@
|
||||
#### Gizlilik Nasıl Sızdırılır? <!-- {docsify-ignore-all} -->
|
||||
Bir anlık bildirimin gönderilmesinden alınmasına kadar geçtiği yol şöyledir:<br />
|
||||
Gönderici<font color='red'> → Sunucu①</font> → Apple APNS sunucusu → Aygıtınız → <font color='red'>Bark Uygulaması②</font>。
|
||||
|
||||
Kırmızıyla işaretlenen bu iki yerde gizlilik sızdırma riski olabilir:<br>
|
||||
* Gönderen HTTPS kullanmıyor veya herkese açık bir sunucu kullanıyor (yazarlar istek günlüklerini görecektir)
|
||||
* Bark Uygulaması kendisi güvenli değilse, App Store'a yüklenen sürümde değişiklikler yapılmış olabilir.
|
||||
|
||||
#### Sunucu Gizlilik Sorununu Nasıl Çözebilirsiniz
|
||||
* Açık kaynaklı sunucu kodunu kullanarak [kendi sunucunuzu kurarak](/tr/deploy.md) ve HTTPS'yi etkinleştirerek.
|
||||
* [Şifreli Push Bildirimi](/tr/encryption) kullanarak, içerikleri şifreleyebilirsiniz.
|
||||
|
||||
#### Uygulamanın Tamamen Açık Kaynak Kodlarla İnşa Edildiğini Sağlama
|
||||
Uygulamanın güvenli olmasını ve hiç kimse tarafından (yazar dahil) değiştirilmemesini sağlamak için Bark, GitHub Actions tarafından oluşturulur ve ardından App Store'a yüklenir.<br />
|
||||
GitHub Çalıştırma Kimliği, Bark uygulama ayarlarında bulunabilir; burada derlemenin geçerli sürümü için kullanılan yapılandırma dosyası, derlemede kullanılan kaynak kodu, App Store'a yüklenen sürümün derleme numarası ve daha fazlası hakkında bilgi bulabilirsiniz.<br>
|
||||
|
||||
|
||||
Aynı derleme numarası App Store'a yalnızca bir kez yüklenebilir, bu nedenle benzersizdir.<br>
|
||||
Bu numarayı, Mağazadan indirilen Bark Uygulamalarını karşılaştırmak için kullanabilirsiniz ve eşleşirse, App Store'dan indirilen Uygulamanın tamamen açık kaynak kodundan oluşturulduğunu kanıtlar.
|
||||
|
||||
Örnek: Bark 1.2.9 - 3<br>
|
||||
https://github.com/Finb/Bark/actions/runs/3327969456
|
||||
|
||||
1. Derleme sırasındaki commit kimliğini bulun ve derleme sırasında kullanılan kaynak kodlarını görüntüleyin.
|
||||
2. .github/workflows/testflight.yaml dosyasını inceleyin, tüm işlemleri doğrulayın ve bu işlemlerin kayıtlarının değiştirilmediğinden emin olun.
|
||||
3. Action Günlüklerini görüntüleyin: https://github.com/Finb/Bark/actions/runs/3327969456/jobs/5503414528
|
||||
4. Paketlenen Uygulama Kimliği (App ID), Ekip Kimliği (Team ID), App Store'a yüklenen sürüm ve derleme numarası gibi bilgileri bulun.
|
||||
5. Mağaza için ilgili sürümün IPA dosyasını indirin ve derleme numarasını kayıtlardakiyle karşılaştırın *(Bu numara her uygulama için benzersizdir ve bir kez yüklendikten sonra aynı derleme numarasıyla başka bir sürüm yüklenemez)*.
|
||||
|
||||
|
||||
*Bu kapsamda iOS'un gizlilik açısından incelenmesi dikkate alınmamıştır*
|
||||
71
docs/tr/tutorial.md
Normal file
71
docs/tr/tutorial.md
Normal file
@ -0,0 +1,71 @@
|
||||
## Anlık Bildirim Gönderimi
|
||||
1. Uygulamayı açın, test URL'sini kopyalayın.
|
||||
|
||||
<img src="_media/example.jpg" width=365 />
|
||||
|
||||
2. İçeriği değiştirin ve URL'ye istek atın.<br>
|
||||
GET veya POST isteği gönderebilirsiniz, istek başarılıysa hemen bir push alacaksınız.
|
||||
|
||||
## URL Formatı
|
||||
URL, bir anlık bildirim anahtarı, "title" parametresi ve "body" parametresinden oluşur. İki farklı kombinasyon şekli vardır:
|
||||
|
||||
```
|
||||
/:key/:body
|
||||
/:key/:title/:body
|
||||
```
|
||||
|
||||
## İstek Yöntemi
|
||||
##### GET isteği parametreleri URL'nin sonuna eklenir, örneğin:
|
||||
```sh
|
||||
curl https://api.day.app/your_key/BildirimIcerigi?group=Grup©=KopyalanacakIcerik
|
||||
```
|
||||
*Elle parametreleri URL'ye eklerken URL kodlama sorunlarına dikkat etmelisiniz, [Sıkça Sorulan Sorular: URL Kodlama](tr/faq?id=%C3%96zel-karakterler-anl%C4%B1k-bildirim-i%C5%9Fleminde-ba%C5%9Far%C4%B1s%C4%B1zl%C4%B1%C4%9Fa-neden-oluyor-%C3%96rne%C4%9Fin-%C4%B0tme-i%C3%A7eri%C4%9Fi-ba%C4%9Flant%C4%B1-i%C3%A7eriyor-veya-gibi-%C3%B6zel-karakterler-bo%C5%9Flu%C4%9Fa-d%C3%B6n%C3%BC%C5%9F%C3%BCyor)*
|
||||
|
||||
##### POST isteği parametreleri istek gövdesine yerleştirilir, örneğin:
|
||||
```sh
|
||||
curl -X POST https://api.day.app/your_key \
|
||||
-d'body=Push İçeriği&group=Grup©=Kopyala'
|
||||
```
|
||||
##### POST isteği JSON'ı destekler, örneğin:
|
||||
```sh
|
||||
curl -X "POST" "https://api.day.app/your_key" \
|
||||
-H 'Content-Type: application/json; charset=utf-8' \
|
||||
-d $'{
|
||||
"body": "Test Bark Server",
|
||||
"title": "Test Başlık",
|
||||
"badge": 1,
|
||||
"category": "benimBildirimGrubum",
|
||||
"sound": "minuet.caf",
|
||||
"icon": "https://day.app/assets/images/avatar.jpg",
|
||||
"group": "test",
|
||||
"url": "https://mritd.com"
|
||||
}'
|
||||
```
|
||||
|
||||
##### JSON isteği anahtarı istek gövdesine yerleştirilebilir, URL yolu */push* olmalıdır, örneğin
|
||||
```sh
|
||||
curl -X "POST" "https://api.day.app/push" \
|
||||
-H 'Content-Type: application/json; charset=utf-8' \
|
||||
-d $'{
|
||||
"body": "Test Bark Server",
|
||||
"title": "Test Başlık",
|
||||
"device_key": "sizin_anahtarınız"
|
||||
}'
|
||||
```
|
||||
|
||||
## İstek Parametreleri
|
||||
Desteklenen parametrelerin listesi, belirli bir etkiyi uygulamada nasıl görüneceğini görmek için uygulama içinden önizleme yapabilirsiniz.
|
||||
|
||||
| Parametre | Açıklama |
|
||||
| ----- | ----------- |
|
||||
| title | Anlık bildirim başlığı |
|
||||
| body | Anlık bildirim içeriği |
|
||||
| level | Anlık bildirim kesme seviyesi. <br>**active:** Varsayılan değer, sistem bildirimi hemen göstermek için ekranı aydınlatacaktır.<br>**timeSensitive:** Zamana duyarlı bildirim, odaklanmış durumda bildirim gösterebilir.<br>**passive:** Bildirimi yalnızca bildirim listesine ekler, hatırlatmak için ekranı aydınlatmaz. |
|
||||
| badge | Anlık bildirim rozeti, herhangi bir sayı olabilir. |
|
||||
| autoCopy | iOS 14.5'ten önce otomatik olarak anlık bildirim içeriğini kopyalar, iOS 14.5'ten sonraysa manuel olarak uzun basmalı veya anlık bildirim aşağı çekilmelidir |
|
||||
| copy | Bir anlık bildirim kopyalanırken, kopyalanacak içeriği belirtin; bu parametre belirtilmezse tüm anlık bildirim içeriğini kopyalar. |
|
||||
| sound | Anlık bildirim için bir ses seçebilirsiniz. |
|
||||
| icon | Anlık bildirim için özel bir simge ayarlayın ve ayarlanan simge varsayılan Bark simgesinin yerini alacaktır. Simgeler otomatik olarak yerel olarak önbelleğe alınır ve aynı simge URL'si yalnızca bir kez indirilir. |
|
||||
| group | Bildirimleri gruplandırın, anlık bildirimler gruplanmış bir şekilde bildirim merkezinde görüntülenir.<br>Ayrıca geçmiş mesajlar listesinde farklı grupları görüntülemeyi de seçebilirsiniz. |
|
||||
| isArchive | 1 ile gönderirseniz, anlık bildirim kaydedilir; diğer bir değer gönderirseniz kaydedilmez. Göndermezseniz, kaydetme ayarlarına göre karar verilir. |
|
||||
| url | Anlık bildirime tıklanınca gidilecek URL, URL Şeması ve Evrensel Bağlantıları destekler. |
|
||||
Loading…
x
Reference in New Issue
Block a user