CountdownMail API

Hızlı Başlangıç

Bu bölüm sizi CountdownMail API'yi kullanmaya hazırlar ve ilk API isteğini nasıl yapacağınızı gösterir.

1. API anahtarınızı alın:
   • CountdownMail hesabınıza giriş yapın.
   • Profil » API adresine gidin.
   • API anahtarınızı kopyalayın.
2. İlk API isteğinizi yapın:
   • "Zamanlayıcı oluştur" endpoint'ini örnek olarak kullanacağız.
   • https://countdownmail.com/api/create adresine POST isteği göndermek için cURL veya Postman gibi bir araç kullanın.
   • API anahtarınızı Authorization başlığına ekleyin.
   • Gerekli zamanlayıcı ayrıntılarını istek gövdesine ekleyin (JSON formatında).

İşte cURL kullanan bir örnek:

curl -H "Content-Type: application/json" \
-H "Authorization: YOUR_API_KEY" \
-X POST "https://countdownmail.com/api/create" \
-d '{
    "skin_id": 1,
    "name": "Big Sale!",
    "time_end": "2025-04-21 20:00:00",
    "time_zone": "America/Los_Angeles",
    "font_family": "Roboto-Bold",
    "color_primary": "FF3A43",
    "color_text": "FFFFFF",
    "color_bg": "000000"
}'
                                    

• YOUR_API_KEY yerine gerçek API anahtarınızı yazın.
• Her şey çalışıyorsa, şu şekilde bir yanıt alırsınız:

{
    "status": "success",
    "message": {
        "id": 1057,
        "code": "td",
        "src": "http://i.countdownmail.com/td.gif"
    }
}
                                    

Bu yanıt bir zamanlayıcı kodu (örn. "td") ve zamanlayıcı görseli için bir URL içerir.

Kimlik Doğrulama

CountdownMail API'yi kullanmak için her isteği API anahtarınızla doğrulamanız gerekir. İşte nasıl:

• İsteğinize bir Authorization başlığı ekleyin. Değeri API anahtarınızdır.
• Alternatif olarak, temel kimlik doğrulama kullanın: API anahtarınızı kullanıcı adı olarak ayarlayın ve şifreyi boş bırakın.

Authorization Başlığı Örneği (cURL):

curl -H "Content-Type: application/json" \
-H "Authorization: YOUR_API_KEY" \
-X GET "https://countdownmail.com/api/some_endpoint"
                                    

• YOUR_API_KEY yerine gerçek API anahtarınızı yazın.
• Her zaman kimlik doğrulama ekleyin, aksi takdirde 401 Unauthorized hatası alırsınız.

Postman Kullanımı

Postman kullanıyorsanız, API isteklerini test etmeyi kolaylaştırır. CountdownMail ile kullanmak için:

• CountdownMail API koleksiyonunu içeri aktarmak için tıklayın.
• API anahtarınızı koleksiyonun kimlik doğrulama ayarlarına ekleyin ve istek göndermeye hazırsınız.

Hatalar

Bazen API istekleri başarısız olur. CountdownMail API, neyin yanlış gittiğini bildirmek için HTTP durum kodları kullanır. İşte olası hataların listesi, anlamları ve ne yapılması gerektiği:

Örnek Hata Yanıtı (401 Unauthorized):

{
    "status": "error",
    "message": "Unauthorized"
}
                                    

Bir hata görürseniz, durum kodunu ve mesajı kontrol edin, ardından önerilen işlemi izleyin.

Zamanlayıcı Modeli

Zamanlayıcı kaynağı, geri sayım zamanlayıcısı hakkındaki tüm bilgileri içerir. Geri sayım zamanlayıcısı tanımlamak için kullanılabilir alanlar şunlardır:

{
    "separator_color"  : "4275BC",
    "separator_size" : 1.3,
    "separator_style" : 6,
    "labels_color" : "A3A3A3"
}
                                    

Zamanlayıcı Oluştur

Bu endpoint bir zamanlayıcı oluşturmanıza olanak tanır. Yeni bir zamanlayıcı oluşturmak için tüm gerekli özellikleri sağlamalısınız.

Örnek İstek:

curl -H "Content-Type: application/json" \
-H "Authorization: YOUR_API_KEY" \
-X POST "https://countdownmail.com/api/create" \
-d '{
    "skin_id":3,
    "name":"Big Sale!",
    "time_end":"2026-10-05 20:00:00",
    "time_zone":"America\/Los_Angeles",
    "font_family":"Roboto-Bold",
    "color_primary":"FF3A43",
    "color_text":"FFFFFF",
    "color_bg":"000000",
    "transparent":"0",
    "font_size":"38",
    "lang":"en",
    "expired_mes_on":"1",
    "expired_mes":"This offer has expired",
    "labels":"1",
    "days":"days",
    "hours":"hours",
    "minutes":"minutes",
    "seconds":"seconds"
}'
                                    

{
    "status": "success",
    "message": {
        "id": 1057,
        "code": "td",
        "src": "http://i.countdownmail.com/td.gif"
    }
}
                                    

Zamanlayıcı Güncelle

Bu endpoint herhangi bir zamanlayıcı özniteliğini güncellemenize olanak tanır. Bir zamanlayıcıyı güncellemek için, güncellemek istediğiniz alanlarla birlikte /update/{code} adresine PUT isteği gönderin. {code} yerine zamanlayıcı kodunu yazın (örn. "td").

Örnek İstek:

curl -H "Content-Type: application/json" \
-H "Authorization: YOUR_API_KEY" \
-X PUT "https://countdownmail.com/api/update/{code}" \
-d '{
    "skin_id":6,
    "name":"Flash Sale!",
    "time_end":"2026-10-05 20:00:00"
}'
                                    

{
    "status": "success",
    "message": {
        "id": 1057,
        "code": "td",
        "src": "http://i.countdownmail.com/td.gif"
    }
}
                                    

Zamanlayıcı kopyala

Mevcut bir zamanlayıcının kopyasını oluşturmak için /duplicate/{code} adresine POST isteği gönderin. {code} yerine kopyalamak istediğiniz zamanlayıcının benzersiz kodunu yazın. Bu, orijinaliyle aynı ayarlarla başlayan yeni bir zamanlayıcı oluşturur.

İstek gövdesine bir JSON nesnesi ekleyerek yeni zamanlayıcının ayrıntılarını güncelleyebilirsiniz. Bu, bitiş zamanı veya ad gibi belirli öznitelikleri değiştirmenize olanak tanırken diğer her şeyi orijinaliyle aynı tutar. Güncelleyebileceğiniz öznitelikler, yeni bir zamanlayıcı oluştururken ayarlayabildiğiniz özniteliklerle aynıdır (tam liste için Zamanlayıcı Modeli bölümüne bakın). Bir özniteliği dahil etmezseniz, orijinal zamanlayıcıdakiyle aynı kalır.

Önemli: Orijinal zamanlayıcı değişmez. Yalnızca yeni zamanlayıcı istekte gönderdiğiniz güncellemelerden etkilenir.

Örnek İstek:

curl -H "Content-Type: application/json" \
-H "Authorization: YOUR_API_KEY" \
-X POST "https://countdownmail.com/api/duplicate/{code}" \
-d '{
    "skin_id":6,
    "name":"Flash Sale!",
    "time_end":"2026-10-05 20:00:00"
}'
                                    

{
    "status": "success",
    "message": {
        "id": 1057,
        "code": "td",
        "src": "http://i.countdownmail.com/td.gif"
    }
}
                                    

Zamanlayıcıyı devre dışı bırak

Bir zamanlayıcıyı durdurmak (arşivlemek) için /deactivate/{code} adresine GET isteği gönderin. {code} yerine zamanlayıcı kodunu yazın.

Zamanlayıcıyı etkinleştir

Bir zamanlayıcıyı tekrar etkinleştirmek için /activate/{code} adresine GET isteği gönderin. {code} yerine zamanlayıcı kodunu yazın.

Zamanlayıcı Sil

Bir zamanlayıcıyı silmek için /delete/{code} adresine DELETE isteği gönderin. {code} yerine zamanlayıcı kodunu yazın.