CountdownMail API

Hizli Baslangic

Bu bolum sizi CountdownMail API'yi kullanmaya hazirlar ve ilk API istegini nasil yapacaginizi gosterir.

1. API anahtarinizi alin:
   • CountdownMail hesabiniza giris yapin.
   • Profil » API adresine gidin.
   • API anahtarinizi kopyalayin.
2. Ilk API isteginizi yapin:
   • "Zamanlayici olustur" endpoint'ini ornek olarak kullanacagiz.
   • https://countdownmail.com/api/create adresine POST istegi gondermek icin cURL veya Postman gibi bir arac kullanin.
   • API anahtarinizi Authorization basligina ekleyin.
   • Gerekli zamanlayici ayrintalarini istek govdesine ekleyin (JSON formatinda).

Iste cURL kullanan bir ornek:

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 gercek API anahtarinizi yazin.
• Her sey calisiyorsa, su sekilde bir yanit alirsiniz:

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

Bu yanit bir zamanlayici kodu (orn. "td") ve zamanlayici gorseli icin bir URL icerir.

Kimlik Dogrulama

CountdownMail API'yi kullanmak icin her istegi API anahtarinizla dogrulamaniz gerekir. Iste nasil:

• Isteginize bir Authorization basligi ekleyin. Degeri API anahtarinizdir.
• Alternatif olarak, temel kimlik dogrulama kullanin: API anahtarinizi kullanici adi olarak ayarlayin ve sifreyi bos birakin.

Authorization Basligi Ornegi (cURL):

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

• YOUR_API_KEY yerine gercek API anahtarinizi yazin.
• Her zaman kimlik dogrulama ekleyin, aksi takdirde 401 Unauthorized hatasi alirsiniz.

Postman Kullanimi

Postman kullaniyorsaniz, API isteklerini test etmeyi kolaylastirir. CountdownMail ile kullanmak icin:

• CountdownMail API koleksiyonunu iceri aktarmak icin tiklayin.
• API anahtarinizi koleksiyonun kimlik dogrulama ayarlarina ekleyin ve istek gondermeye hazirsiniz.

Hatalar

Bazen API istekleri basarisiz olur. CountdownMail API, neyin yanlis gittigini bildirmek icin HTTP durum kodlari kullanir. Iste olasi hatalarin listesi, anlamlari ve ne yapilmasi gerektigi:

Ornek Hata Yaniti (401 Unauthorized):

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

Bir hata gorurseniz, durum kodunu ve mesaji kontrol edin, ardindan onerilen islemi izleyin.

Zamanlayici Modeli

Zamanlayici kaynagi, geri sayim zamanlayicisi hakkindaki tum bilgileri icerir. Geri sayim zamanlayicisi tanimlamak icin kullanilabilir alanlar sunlardir:

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

Zamanlayici Olustur

Bu endpoint bir zamanlayici olusturmaniza olanak tanir. Yeni bir zamanlayici olusturmak icin tum gerekli ozellikleri saglامalizdir.

Ornek Istek:

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-02-02 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"
    }
}
                                    

Zamanlayici Guncelle

Bu endpoint herhangi bir zamanlayici oznitelигini guncellemenize olanak tanir. Bir zamanlayiciyi guncellemek icin, guncellemek istediginiz alanlarla birlikte /update/{code} adresine PUT istegi gonderin. {code} yerine zamanlayici kodunu yazin (orn. "td").

Ornek Istek:

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-02-02 20:00:00"
}'
                                    

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

Zamanlayici kopyala

Mevcut bir zamanlayicinin kopyasini olusturmak icin /duplicate/{code} adresine POST istegi gonderin. {code} yerine kopyalamak istediginiz zamanlayicinin benzersiz kodunu yazin. Bu, orijinaliyle ayni ayarlarla baslayan yeni bir zamanlayici olusturur.

Istek govdesine bir JSON nesnesi ekleyerek yeni zamanlayicinin ayrintalarini guncelleyebilirsiniz. Bu, bitis zamani veya ad gibi belirli oznitelikleri degistirmenize olanak tanirken diger her seyi orijinaliyle ayni tutar. Guncelleyebileceginiz oznitelikler, yeni bir zamanlayici olustururken ayarlayabildiginiz ozniteliklerle aynidir (tam liste icin Zamanlayici Modeli bolumune bakin). Bir ozniteligi dahil etmezseniz, orijinal zamanlayicidakiyle ayni kalir.

Onemli: Orijinal zamanlayici degismez. Yalnizca yeni zamanlayici istekte gonderdiginiz guncellemelerden etkilenir.

Ornek Istek:

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-02-02 20:00:00"
}'
                                    

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

Zamanlayiciyi devre disi birak

Bir zamanlayiciyi durdurmak (arsivlemek) icin /deactivate/{code} adresine GET istegi gonderin. {code} yerine zamanlayici kodunu yazin.

Zamanlayiciyi etkinlestir

Bir zamanlayiciyi tekrar etkinlestirmek icin /activate/{code} adresine GET istegi gonderin. {code} yerine zamanlayici kodunu yazin.

Zamanlayici Sil

Bir zamanlayiciyi silmek icin /delete/{code} adresine DELETE istegi gonderin. {code} yerine zamanlayici kodunu yazin.