API'ye giriş

MailGraf REST API, kendi sistemlerinizle bir MailGraf hesabı arasında veri alışverişi yapmanızı sağlar. Bir CRM, e-ticaret platformu, form veya iş akışı; kişileri MailGraf'a ekleyecek, liste üyeliğini yönetecek ya da kampanya sonuçlarını okuyacaksa API'yi kullanabilirsiniz.

Neler yapabilirsiniz

Mevcut public API şu işleri destekler:

• email adresini kullanarak kişi oluşturma veya güncelleme
• kişileri görüntüleme ve listeleri bulma
• bir kişiyi listeye ekleme veya listeden çıkarma
• bir email adresini hesabın engel listesine ekleme
• otomasyonları başlatabilen özel davranış olayları gönderme
• kampanyaları ve teslimat raporlarını okuma

Kampanya oluşturma, kampanya gönderme ve hesap yönetimi MailGraf uygulamasında yapılır.

Erişim nasıl çalışır

1. API anahtarı oluşturun

   Ayarlar > API sayfasını açın ve API anahtarı oluştur butonuna tıklayın. Anahtarın tamamı yalnızca bir kez gösterilir. Anahtarı gizli anahtar yöneticinize veya güvenli sunucu yapılandırmanıza kopyalayın.

2. Her isteğin kimliğini doğrulayın

   Anahtarı Authorization başlığında bearer token olarak gönderin. Bir servisi canlı kullanıma bağlamadan önce Kimlik doğrulama yazısını okuyun.

3. Public API'ye istek gönderin

   İsteklerinizi https://api.mailgraf.com/v1 adresine gönderin. Önce İlk API isteğinizi gönderin yazısındaki salt okunur hesap kontrolünü deneyin.

Doğru kaynağı kullanın

Yardım Merkezi yazıları işleri ve entegrasyon kararlarını anlaşılır bir dille açıklar. Endpoint yolları, istek alanları, yanıt şemaları ve hata kodları için geçerli sözleşme API referansıdır. İki kaynak arasında fark görürseniz API referansını esas alın ve düzeltebilmemiz için Yardım Merkezi yazısını bildirin.

Tam referans nerede

Kullanılabilir tüm endpointleri ve güncel sözleşmelerini API referansında inceleyebilirsiniz.