Talep oluşturun
CLI’dan şunu çalıştırın:source değerini cli yapar. --diagnostics yalnızca ikili dosya
adını, CLI sürümünü, işletim sistemini ve mimariyi ekler. Tüm seçenekler için
logbrew support --help komutunu çalıştırın.
CLI, talep oluştururken yeniden deneme anahtarı göndermez. Sonuç belirsizse
komutu yeniden çalıştırmadan önce logbrew support list --json komutunu
çalıştırın. Aksi hâlde ikinci bir talep oluşturabilirsiniz.
API’den source, category, title ve description alanlarıyla
POST /api/support/tickets isteği gönderin. Yeniden denemeyi güvenli hâle
getirmek için rapor başına bir kez yeniden deneme anahtarı oluşturun ve bunu
Idempotency-Key başlığında gönderin. Bu örnek yapay değerler kullanır:
Idempotency-Key başlığı
isteğe bağlıdır. Bu başlık olmadan tekrarlanan bir istek başka bir talep
oluşturabilir.
İsteğe bağlı alanlar project_id, environment, runtime, framework,
sdk_package, sdk_version, release, trace_id, event_id ve
diagnostics alanlarıdır. Sorun belirli bir projeye ait değilse project_id
alanını göndermeyin. project_id, hesabınızdaki etkin bir projeyi
tanımlamalıdır.
Başarılı bir istek HTTP
200 döndürür:
sup_ ile başlar. next alanını bir kişiye yönlendirme
olarak, next_action alanını program akışı için kullanın.
Bir projeyi silmek için proje ayarlarını veya logbrew projects delete
komutunu kullanın. Proje silme işlemini destek talebiyle istemeyin.
Yararlı bir rapor yazın
- Her talepte tek bir sorun bildirin.
- En yakın
categorydeğerini seçin.otherdeğerini yalnızca hiçbir kategori uymadığında kullanın. titlealanında tek bir belirti ve tek bir yüzey belirtin.descriptionalanına önce adımları, ardından beklenen ve gözlemlenen sonucu yazın.- Proje, sürüm, iz veya olay kimliklerini yalnızca aynı hatayı tanımlıyorlarsa ekleyin.
diagnostics anahtarlarını kullanın:
diagnostics, gizlemeden sonra en fazla 16 KB olan bir JSON nesnesidir.
Anahtarı bir kimlik bilgisini, oturumu veya e-posta adresini adlandıran bir
değeri LogBrew [redacted] ile değiştirir. Kimlik bilgisine, URL’ye veya yerel
yola benzeyen metni de değiştirir. LogBrew ayrıca uzun metinleri kısaltır ve
iç içe yapıları, anahtarları ve liste öğelerini sınırlar. Bu gizlemeye
güvenmeyin. İsteği göndermeden önce özel verileri çıkarın.
Talebi takip edin
Liste
project_id, status, source, category, release ve limit
parametrelerini kabul eder. Varsayılan limit 100, en büyük değer 500 olur.
Cursor ile sayfalama için pagination=cursor gönderin. Sonraki sayfalarda
aynı filtreleri tekrarlayın ve next_cursor içindeki cursor_time ve
cursor_id değerlerini gönderin. Cursor kimliği bir sup_ talep kimliğidir.
next_cursor değeri null olduğunda durun. CLI --project, --status,
--source, --category, --release, --limit, --pagination,
--cursor-time ve --cursor-id seçeneklerini kullanır.
Durum değerleri open, routed, in_progress, waiting_on_user,
resolved ve closed olur. Yalnızca open veya closed ayarlayabilirsiniz.
Tekrarlanan bir kapatma veya yeniden açma isteği, hiçbir şeyi değiştirmeyen
başarılı bir istektir. Bu yüzden aynı isteği yeniden deneyebilirsiniz.
Döndürülen durumu ve next_action alanını izleyin:
İstenen bağlamı ekleyin
Talep bağlam istediğinde yanıt verin. Böyle bir talebin durumuwaiting_on_user, next_action.code değeri provide_context olur.
context ve isteğe bağlı diagnostics alanlarını içerir.
context metni 1 ile 4.000 arasında karakter içermelidir. context içine
kimlik bilgisi, URL, ana bilgisayar adı veya yerel yol yazmayın. API bu metni
422 ile reddeder. Idempotency-Key başlığında bir yeniden deneme anahtarı
gönderin. Bağlam rotası bu başlığı zorunlu tutar. Anahtar, boşluk içermeyen 1
ile 128 arasında görünür ASCII karakterden oluşur. Her yanıt için yeni bir
anahtar kullanın. Bir anahtarı yalnızca aynı yanıtı yeniden denemek için
tekrar kullanın.
API, talep open, routed, in_progress veya waiting_on_user durumundayken
bağlam kabul eder. Talebin her durumu için 1 yanıt kabul eder. Bir yanıttan
sonra daha fazla bağlam göndermeden önce durumun değişmesini bekleyin.
waiting_on_user durumundaki bir talebe verilen yanıt, talebi open yapar. Bu
değişikliği varsaymak yerine döndürülen status değerini okuyun.
Başarılı bir yanıt ticket_id, context_id, status, created_at, next
ve next_action döndürür. context_id, ctx_ ile başlar. Sonraki bir isteği
yanıtlamadan önce talebi yeniden okuyun.
GET /api/support/tickets/{ticket_id}/context, en son 20 bağlam kaydını en
eskiden başlayarak döndürür. Her kayıtta context_id, context,
diagnostics ve created_at bulunur. Bu listede cursor yoktur.
resolved veya closed durumundaki bir talebe verilen yanıt,
code: "validation_failed" ile 422 döndürür. Talebi yalnızca kullanıcı o
destek isteğine devam etmek istiyorsa yeniden açın. Bir next_action, agent’a
hesap durumunu değiştirme izni vermez.
Hatalardan kurtarın
Hata yanıtları
error, code, next ve next_action alanlarını içerir.
Bkz. API hataları.
