Mail hesabı API

Stok ucu herkese açık, API key istemiyor

GET https://api.xmailhub.net/stock ucu anahtar, header veya hesap istemiyor. Bu bilinçli bir tercih ve entegrasyona buradan başlamak en mantıklısı. Cevap şöyle dönüyor: {"status":"success","code":200,"data":[{"Name":"Hotmail Fresh","Price":"0.004","Stock":34},{"Name":"Outlook Trusted","Price":"0.040","Stock":17}]}. Price sayı değil string geliyor, yani doğrudan float sanma, parse et. Stock ise tam sayı ve sürekli hareket ediyor, çünkü aynı stoktan başkaları da alıyor. İki dürüst not. Birincisi, data dizisinde ürün adları var, satın alma ucuna göndereceğin ürün kodları yok; kodların tek kesin listesi yukarıdaki tablo. İkincisi, stok rakamı uzun süreli bir önbellekten değil istek anında okunuyor, o yüzden bir çağrıda 34 gören bir sonraki çağrıda 0 görebilir. Uzun süren bir işin başında bir kez değil, satın almadan hemen önce sorgula.

API key nereden alınır, bakiye nasıl yüklenir

API anahtarın panelindeki API sayfasında duruyor ve kayıt olduğun anda üretiliyor. Başvuru formu, onay bekleme, kota talebi yok. Aynı sayfadan istediğin zaman yenileyebiliyorsun. Anahtar eski bir script'in içinde ya da paylaşılan bir config dosyasında uzun süredir bekliyorsa yenilemek iyi fikir: yenilemenin bedeli bir deploy, sızmış anahtarın bedeli bakiyen. Anahtarı üç şekilde gönderebiliyorsun ve üçü de aynı yere gidiyor: URL'de path parçası olarak, ?apiKey= ile query'de veya X-API-Key header'ında. Para tarafı sitedekiyle aynı işliyor. Ön ödemeli bakiyeni Plisio üzerinden kripto ile yüklüyorsun (USDT TRC20, Litecoin, Tron) ve her satın alma çağrısı bu bakiyeden düşüyor. Anlık bakiyeni GET /balance/ANAHTARIN ile okuyorsun; cevapta code, string olarak balance ve dd/mm/yyyy HH:MM:SS formatında date dönüyor.

API ile mail satın alma: /purchase/KEY/KOD/ADET

Satın alma tek istek: GET https://api.xmailhub.net/purchase/ANAHTARIN/Hotmail/10 çağrısı on adet taze Hotmail alıyor. KOD kısmına ürünün API kodu geliyor ve şu an dört tane canlı kod var: Hotmail, Outlook, Hotmail_Trusted ve Outlook_Trusted. Eşleşme büyük küçük harfe duyarsız, yani hotmail_trusted da çalışıyor. Her ürünün kodu /stock cevabındaki Account alanında da geliyor, yani bu listeyi koda gömmen gerekmiyor. Adet 1 ile 100.000 arasında ve birim fiyat adetle değişmiyor, on bin taze Hotmail on bin kere 0,004 dolar ediyor. Evet, para harcayan bir çağrının GET olması alışılmadık, bunu düzeltilmiş gibi anlatmayacağız. Sebebi eski sistemle uyum: URL'ler tam olarak böyleydi ve bugün hâlâ çalışan binlerce script bu adrese bakıyor, metodu değiştirmek hepsini bir kural uğruna kırardı. Sonuçlarını ciddiye al: bu URL gerçekten para harcıyor, yani körlemesine retry atan, link öngörüsü yapan veya tam URL'leri loglayan hiçbir yerde durmasın.

Satın alma cevabında ne dönüyor

Başarılı satın almada status, code, message, purchase_id, balance, price ve her hesap için bir nesne içeren data dizisi geliyor. Her nesnede Email, Password, AccessToken, RefreshToken ve ClientId alanları var. Son üçü OAuth2 alanları: hesabı IMAP veya Microsoft Graph üzerinden bağlamanı sağlıyorlar, yani Microsoft'un telefon numarası sorduğu giriş ekranına hiç uğramıyorsun. Hesapta token yoksa AccessToken alanı "-" olarak dönüyor, bir mail kütüphanesine vermeden önce bunu kontrol et. balance düşüm sonrası kalan bakiyen, price ise gerçekten ödediğin birim fiyat; ikisi de string. purchase_id sipariş numaran ve kaydetmeye değer tek alan o: bir hesap giriş yapmazsa destek bu numaradan bakıyor. Hesap bilgileri ayrıca sipariş geçmişinde duruyor, yani cevabı aldıktan sonra script'in çökerse hesapları kaybetmiş olmuyorsun.

Gelen kutusunu okuma: /mailreader ve /mailinfo

İki uç, senin satın aldığın hesaplar üzerinde çalışıyor. GET /mailreader/[email protected] gelen kutusunu okuyor; cevapta code, message ve email_address ile mesajları taşıyan bir data nesnesi var. Her mesajda date, sender_email, sender_name, subject, message, folder ve id alanları geliyor, yani doğrulama kodunu regex ile çekmek için yeterli. Sonuna &html eklersen temizlenmiş metin yerine ham HTML gövde dönüyor. GET /mailinfo/[email protected] ise tek hesabın saklı bilgilerini veriyor: mail, password, accessToken, refreshToken, clientId. İkisi de sahiplik kontrolü yapıyor, senin siparişlerinde olmayan bir adres 400 ve publicapi.invalid_mail anahtarıyla dönüyor. mail parametresi zorunlu, göndermezsen 400 ve publicapi.missing_params alıyorsun. Okuma harici bir mail servisine bağlı, o servise ulaşılamazsa boş kutu yerine 503 dönüyor. 503'ü "mail yok" değil "sonra tekrar dene" diye oku.

Hata kodları ve bilmen gereken tuhaflıklar

Hata gövdelerinde success: false, makine tarafında okunacak bir code ve hem messageKey hem messageText var; ikincisi Accept-Language başlığına veya ?lang= parametresine göre çevriliyor. Anahtar yoksa 401 ve API_KEY_MISSING, anahtar geçersizse yine 401 ama API_KEY_INVALID, anahtar askıya alınmış bir hesaba aitse 403 ve ACCOUNT_INACTIVE dönüyor. Bunları aynı kefeye koyma: 401 anahtarını düzelt demek, 403 destekle konuş demek ve ikisi de retry atmaya değmez. Bilinmeyen ürün kodu 404 dönüyor. Tedarikçide olandan fazlasını istersen 400 ve INSUFFICIENT_STOCK geliyor, mesaj kaç adet olduğunu da söylüyor, yani script adedi düşürüp tekrar deneyebiliyor. 1 ile 100.000 dışındaki adet 400 QUANTITY_OUT_OF_RANGE, yetersiz bakiye 400 INSUFFICIENT_BALANCE veriyor. İki gerçek tuhaflık: query formatında /purchase ucunu kod veya adet olmadan çağırırsan HTTP durumu 400 gelirken gövdedeki code alanı 403 yazıyor, ve bakım modunda bütün uçlar 503 ile code: 999 dönüyor.

İki URL formatı ve eski script'ler

Her uç aynı anda iki şekilde cevap veriyor. Eski path formatı anahtarı URL'ye koyuyor: /balance/KEY, /purchase/KEY/KOD/ADET, /mailinfo/KEY?mail=..., /mailreader/KEY?mail=.... Query formatı ise yolu temiz tutuyor: /balance?apiKey=KEY, /purchase?apiKey=KEY&code=Hotmail&quantity=10. İkisi de aynı handler'a gidiyor ve aynı gövdeyi döndürüyor; üçüncü seçenek olan X-API-Key header'ı da her ikisiyle çalışıyor. Bu, geri sayımı olan bir deprecation değil. İki format yan yana canlı, geçiş tarihi yok. Eski PHP subdomain'ine yıllar önce yazılmış bir script bu yüzden çalışmaya devam ediyor: adresi https://api.xmailhub.net yap, anahtarı koru, bitti. Yeni bir şey yazıyorsan header formatını tercih et. URL'deki anahtar erişim loglarına, tarayıcı geçmişine, proxy önbelleğine ve sonrasında açtığın sayfanın referrer'ına düşüyor; para harcayan bir anahtar için bunların hiçbiri iyi yer değil.

Sık sorulan sorular