Kendi uygulamalarınızdan talep açma (talep API'si)

Güncelleme: 19 Kas 2026 3 dakikalık okuma
Ticketix makalelerine göz atın

Bir eklenti, masaüstü uygulaması veya web sitesi gibi kendi uygulamalarınız, kullanıcıları için talep açabilir ve uygulamanın ya da sunucunun sürümü gibi teknik ayrıntıları da gönderebilir. Her uygulamanın kendi anahtarı vardır. Bir anahtarı iptal ettiğinizde o uygulama anında durur.

Nerede bulunur: Kurulum → Destek → Uygulama anahtarları (yalnızca yöneticiler).

Uygulama anahtarı oluşturma

  1. Kurulum → Destek → Uygulama anahtarları'nı açın.
  2. Uygulama adını girin, örneğin WordPress plugin. Personel bu adı, uygulamanın açtığı taleplerin kanalı olarak görür.
  3. İstek ürün belirtmediğinde kullanılacak ürün'ü veya İstek ürünü belirtmelidir seçeneğini seçin.
  4. Anahtar oluştur'a tıklayın.
  5. Anahtarı şimdi kopyalayın ve uygulamanın ayarlarında saklayın. Anahtar yalnızca bu seferlik gösterilir; Ticketix yalnızca anahtarın bir özetini (hash) saklar.

Liste her uygulamayı anahtarının başlangıcı, ürünü, talep sayısı, Son kullanım zamanı ve oluşturulma tarihiyle gösterir. İptal et bir anahtarı anında durdurur; uygulamanın açtığı talepler uygulamanın adını korur.

Talep açma

Kurulumunuzun adresi altındaki /api/ticket-create.php adresine JSON gövdeli bir POST isteği gönderin, örneğin https://support.example.com/api/ticket-create.php. Anahtarı Authorization: Bearer başlığında gönderin; sunucunuz Authorization başlığını kaldırıyorsa X-Ticketix-Key başlığını kullanın.

POST /api/ticket-create.php
Authorization: Bearer tkx_…
Content-Type: application/json

{
  "email": "customer@example.com",
  "name": "Customer Name",
  "product": "helpdesk",
  "subject": "Licence shows Inactive after moving the site",
  "message": "We moved the site to a new domain …",
  "priority": "normal",
  "technical_details": {
    "WordPress": "6.8",
    "PHP": "8.3",
    "Plugin version": "2.0.2"
  }
}
AlanZorunluAnlamı
emailEvetMüşterinin e-posta adresi; bilinmeyen bir adres için yeni bir müşteri oluşturulur
nameHayırMüşterinin adı, en fazla 120 karakter
productHayırBir ürün anahtarı; belirtilmezse anahtarın ürünü kullanılır
subjectEvetEn fazla 200 karakter
messageEvetDüz metin, en fazla 20.000 karakter
priorityHayırlow, normal (varsayılan) veya high
technical_detailsHayırEn fazla 30 ad ve değer; ad en fazla 60, değer en fazla 500 karakter; değerler metin, sayı veya true ve false olabilir

İstek gövdesi en fazla 64 KB olabilir.

Talebe ne olur

  • Talep anında açılır; anahtar isteğin güvenilirliğini doğruladığı için e-posta doğrulaması yapılmaz.
  • Müşteri, talep bağlantısını içeren olağan Talep oluşturuldu e-postasını alır; personel de olağan bildirimleri alır.
  • Yönlendirme kuralları, iş akışları, SLA politikaları ve yapay zekâ ön değerlendirmesi her yeni talepte olduğu gibi çalışır.
  • Talep ekranı, kanal olarak uygulamanın adını "teknik ayrıntılarla" ifadesiyle birlikte, teknik ayrıntıları da ilk mesajın altında ("Gönderen" ve uygulama adı) gösterir. Müşteri de kendi talebinde aynı ayrıntıları görür.

Yanıtlar

DurumAnlamı
201Talep açıldı; yanıt ticket_no ve status içerir
401Anahtar eksik, yanlış veya iptal edilmiş
405İstek bir POST değil
413Gövde 64 KB'tan büyük
415Gövde JSON değil (Content-Type: application/json)
422Bir alan hatalı; fields her alanı nedeniyle birlikte belirtir
429Çok fazla talep: uygulama başına saatte 60, müşteri başına saatte 10

Nginx kullanıyorsanız sunucunun api klasöründe PHP çalıştırması gerekir; bkz. Ticketix sunucu gereksinimleri.

İlgili makaleler

Bu sayfada

Talep gönder

Portal hesabı açmadan yeni bir destek talebi oluşturun.

Öncelik
Ekler
Talebi yalnız siz ve ekibimiz görür. Şifre veya lisans kodu göndermeyin.

Talebi takip et

Onay e-postanızdaki talep numarası ve şifreyi kullanın.

Numara ve şifre onay e-postanızda.

Giriş

Destek portalı hesabınıza erişin.

Hesabınız yok mu?

Hesap oluştur

Destek portalı hesabınızı oluşturun.

Hesabınız var mı?

Şifremi unuttum

Yeni şifre seçmeniz için e-postanıza bir bağlantı gönderiyoruz.

Yazışma

İşinize yaradı mı?
Makalenin tamamını aç
↑ ↓ gezinirEnter açarEsc kapatır