Bayi ve geliştirici API dokümantasyonu

DHRU Fusion destekleyen panelinizi tek adımda bağlayın ya da kendi yazılımınızdan doğrudan istek gönderin.

DHRU Fusion bağlantı adımları

DHRU panelinizde tedarikçi (API) ayarlarına girmeniz gereken bilgiler.

Önemli bağlantı notuBu sitede API adresi doğrudan api.php dosyasıdır. Panelinizdeki adres kutusuna aşağıdaki adresin tamamını, sonunda api.php olacak şekilde yazın. Adrese başka bir bölüm eklemeyin.

API adresi

https://new.ghostunlocker.com/api.php

Panelinizdeki adres kutusuna yazın

Kullanıcı adı

your_username

Sitemizdeki kullanıcı adınız

API erişim anahtarı

your_api_key

Hesap ayarları > Güvenlik ve API bölümünden oluşturun

Hesap oluştur

Desteklenen işlemler

İşlem	Ne yapar	Yanıtın içeriği	Durum
accountinfo	Bakiye ve hesap bilgisi	{ SUCCESS: [{ AccoutInfo: { credit, mail, currency } }] }	Aktif
imeiservicelist	Açık servisler, fiyatlar ve istenen alanlar	{ SUCCESS: [{ LIST: { Grup: { SERVICES: {…} } } }] }	Aktif
placeimeiorder	Yeni sipariş gönderir	{ SUCCESS: [{ MESSAGE, REFERENCEID }] }	Aktif
getimeiorder	Sipariş durumunu ve sonucunu sorgular	{ SUCCESS: [{ STATUS: 4, CODE: "SONUÇ" }] }	Aktif

Entegrasyon rehberi

1. Bağlanın ve listeyi alın

Hesabınızda API erişiminin açık olduğunu ve izinli IP adresinizin tanımlı olduğunu kontrol edin. Panelinize adresi, kullanıcı adını ve anahtarı girin. Önce accountinfo ile bağlantıyı, sonra imeiservicelist ile servis listesini deneyin.

2. Alanları eksiksiz eşleştirin

Servis listesindeki Requires.Custom bölümünde fieldname, fieldtype, required ve fieldoptions değerleri gelir. Alanları ekrandaki etiketle değil fieldname ile eşleştirin. IMEI veya seri numarası ana alandır, diğer istenen bilgiler CUSTOMFIELD içinde gönderilir.

3. Gönderin ve sonucu izleyin

Servis kimliğini (ID), miktarı (QNT) ve zorunlu alanları gönderin. Dönen REFERENCEID değerini saklayın. Durumu bu numarayla getimeiorder üzerinden sorgulayın. Teslim kararı için SUCCESS değil STATUS değerine bakın.

4. Aynı siparişi tekrar göndermeyin

İstek zaman aşımına uğrarsa hemen yeniden göndermeyin. Önce siparişlerinizi kontrol edin, böylece aynı IMEI için çift kesinti olmaz. Sorguları makul aralıklarla yapın, saniyede birkaç kez denemeyin.

Anahtar güvenliği

Anahtarı tarayıcıda çalışan koda ya da herkese açık bir depoya koymayın. Yalnızca sunucunuzdan, HTTPS üzerinden kullanın. İzinli IP, tarayıcınızın değil entegrasyon sunucunuzun dış IP adresidir. Kayıtlarda anahtarı ve müşteri bilgilerini gizleyin.

Hataları doğru okuyun

HTTP 200 tek başına başarı anlamına gelmez. Yanıtta ERROR mu SUCCESS mu geldiğine bakın. Hata mesajını kendi kayıtlarınıza yazın ama müşterinize teknik ayrıntıyı olduğu gibi göstermeyin. Fiyat değişebilir, her zaman güncel listeyi esas alın.

Sipariş durum kodları

Alındı / bekliyor

İşleniyor

Reddedildi / iptal

Tamamlandı

Özel PHP ve cURL ile kullanım

Her istek POST ile api.php adresine gider. Yanıt JSON olarak döner.

POST

https://new.ghostunlocker.com/api.php

Alan açıklamaları

username

Kullanıcı adınız

apiaccesskey

API anahtarınız

action

İşlem adı (küçük harfle)

parameters

JSON içeriğin base64 hali

PHP örneği: sipariş gönderme

<?php
$apiUrl   = 'https://new.ghostunlocker.com/api.php';
$username = 'kullanici_adiniz';
$apiKey   = 'API_ANAHTARINIZ';

$parameters = base64_encode(json_encode([
    'ID'   => 102,               // servis kimliği
    'IMEI' => '353912345678901', // IMEI veya seri numarası
    'QNT'  => 1,
]));

$ch = curl_init($apiUrl);
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS     => http_build_query([
        'username'     => $username,
        'apiaccesskey' => $apiKey,
        'action'       => 'placeimeiorder',
        'parameters'   => $parameters,
    ]),
]);
$reply = json_decode(curl_exec($ch), true);
curl_close($ch);

if (isset($reply['ERROR'])) {
    echo $reply['ERROR'][0]['MESSAGE'];
} else {
    echo $reply['SUCCESS'][0]['REFERENCEID'];
}

Sipariş durum kodları

Alındı / bekliyor

İşleniyor

Reddedildi / iptal

Tamamlandı

Henüz API erişiminiz yok mu?

API, uygun hesaplarda destek ekibi tarafından açılır. Hesabınızı oluşturup destekten erişim isteyebilirsiniz.

Hesap oluştur Bayi programı