Geliştirici API Portalı - Tekno Unlocking Server

Giriş & Genel Bilgi

GSMTekno API portalına hoş geldiniz. Bu arayüz üzerinden kendi web sitenizi veya bayi altyapınızı sistemimize tamamen entegre ederek sipariş süreçlerini tam otomatik hale getirebilirsiniz.

API'miz standart JSON formatını ve popüler bayi panellerinin kullandığı DHRU Fusion protokolünü tam uyumlu olarak desteklemektedir.

💡 Hız Sınırı (Rate Limit): Güvenlik ve kararlılık gereği, istemci IP adresi başına dakikada maksimum 60 istek yapılabilir. Sınır aşıldığında sistem HTTP 429 Too Many Requests yanıtı döndürecektir.

Kimlik Doğrulama

API entegrasyonu yapabilmeniz için öncelikle kullanıcı panelinizdeki API Yönetimi sayfasından bir API anahtarı üretmeniz ve sunucunuzun IP adresini beyaz listeye (IP Whitelist) eklemeniz gerekmektedir.

Her istekte kimlik doğrulaması amacıyla aşağıdaki parametreleri POST veya GET gövdesinde iletmeniz şarttır:

Parametre	Tür	Açıklama
`key`	`string`Zorunlu	Profil sayfanızda oluşturulan özel API Erişim Anahtarınız. (DHRU modunda `apiaccesskey` olarak da gönderilebilir).
`action`	`string`Zorunlu	Çalıştırılacak API komutunun adı (Örn: `getBalance`, `getServices` vb.)

Bakiye Sorgula (getBalance)

Hesabınızdaki güncel bakiye miktarını ve para birimi sembolünü çeker.

POST /api/v1/index.php?action=getBalance

İstek Parametresi	Tür	Değer
`action`	`string`	`getBalance`

Başarılı Yanıt Örneği (JSON)

{
  "status": "success",
  "balance": "1547.85",
  "currency": "$"
}

Hizmet Listesi (getServices)

Sistemde aktif olan tüm servisleri, kategorileriyle, teslim süreleriyle ve size özel kâr marjlı bayi fiyatlarıyla listeler.

POST /api/v1/index.php?action=getServices

İstek Parametresi	Tür	Değer
`action`	`string`	`getServices`

Başarılı Yanıt Örneği (JSON)

{
  "status": "success",
  "services": [
    {
      "id": 101,
      "name": "Xiaomi TaJtool.com Tool Qualcomm And Mediatek v5",
      "description": "Qualcomm and Mediatek EDL/FRP Reset support.",
      "category": "XIAOMI TaJtool TOOL",
      "service_type": "server",
      "delivery_time": 10,
      "price": "47.50"
    }
  ]
}

Sipariş Oluştur (newOrder)

Belirtilen servis kimliği (Service ID) ve IMEI numarası ile yeni bir sipariş oluşturarak bakiyenizden düşüm gerçekleştirir.

POST /api/v1/index.php?action=newOrder

İstek Parametresi	Tür	Açıklama
`action`	`string`	`newOrder`
`service`	`int`Zorunlu	Sipariş verilecek servisin benzersiz ID numarası.
`imei`	`string`Zorunlu	İşlem görecek 15 haneli IMEI numarası (veya cihaz seri numarası).
`custom_fields`	`array`	Servisin gerektirdiği özel ek alan verileri (Opsiyonel JSON/Metin).

Başarılı Yanıt Örneği (JSON)

{
  "status": "success",
  "order_id": 98574,
  "reference": "GSM20260519-0012",
  "charged": "47.50",
  "balance_left": "1500.35",
  "message": "Siparişiniz başarıyla alındı ve işleme sırasına eklendi."
}

Sipariş Durumu Sorgulama (getOrderStatus)

Daha önce oluşturulmuş bir siparişin durumunu, cevabını (kod, link veya açıklama) güncel olarak sorgular.

POST /api/v1/index.php?action=getOrderStatus

İstek Parametresi	Tür	Açıklama
`action`	`string`	`getOrderStatus`
`order_id`	`int`Zorunlu	Sorgulanacak siparişin sistemimizdeki ID numarası.

Başarılı Yanıt Örneği (JSON)

{
  "status": "success",
  "order_id": 98574,
  "order_status": "completed",
  "result": "✅ EDL_MODE_SUCCESS: EDL authorization granted. Token: 9A8B7C6D5E",
  "updated_at": "2026-05-19 12:15:45"
}

Sipariş Durumu Kodları (order_status):
• pending: Siparişiniz alındı, işlem sırası bekliyor.
• processing: Sunucularımız veya sağlayıcılar tarafından işleniyor.
• completed: Sipariş başarıyla tamamlandı. Detaylı çıktı result alanındadır.
• cancelled: Sipariş reddedildi veya iptal edildi. Ücret bakiyenize anında iade edilmiştir.
• refunded: Sipariş iade edildi.

DHRU Fusion Bağlantısı (DHRU Uyumlu Mod)

Eğer altyapı olarak **DHRU Fusion**, **DHRU Fusion V8+** veya benzeri standart XML/JSON API entegrasyonu kullanan bir yazılıma sahipseniz, sitemizi hiçbir kod değişikliği yapmadan doğrudan "Sağlayıcı (Provider)" olarak ekleyebilirsiniz.

API çekirdeğimiz DHRU parametrelerini otomatik olarak algılar ve standarda uygun şekilde XML/JSON formatında yanıt üretir.

DHRU Fusion Entegrasyon Bilgileri

API URL	`https://teknotamir.net/api/v1/index.php`
Yanıt Türü (Format)	`JSON` veya `XML` (Otomatik algılanır)
Username	Kendi üye kullanıcı adınız.
API Access Key	Profil sayfanızda oluşturulan API Anahtarınız.

🔑 Kurulum Notu: DHRU panelinizde yeni bir sağlayıcı eklerken, sitemizin ana URL adresini ve size özel üretilen anahtarı yukardaki gibi girmek entegrasyonu tamamlamak için yeterlidir. Hizmet listesi ve sipariş statüleri otomatik senkronize olacaktır.