Bayi API bilgileri

Kredi satıcıları, Bayi API arayüzü aracılığıyla web mağazalarını chimeratool.com.cn'a çok kolay bir şekilde bağlayabilirler.

Bu belgenin düzeltme tarihi: 14 Eyl 2016 14:03:25, ve değiştirme tarihi: 6 Kas 2026 06:07:02.

back iconGeri
Bayi API bilgileri

Chimeratool.com sunucuları ile iletişim kurmak için PHP sınıfımızı kullanabilirsiniz: kredi transferi yapmak, kredi transferlerini iptal etmek, hesabınız hakkında bilgi toplamak (örneğin kredi bakiyeniz), transferlerinizi listelemek ve chimeratool kullanıcılarını belirlemek.

PHP sınıfımız HTTPS protokolü üzerinden iletişim kurar ve GET metodunu kullanarak JSON formatındaki verileri alır.

PHP çağrısını buradan indirebilirsiniz.

Hata kodları ve mesajları

API çağrıları farklı hata kodlarıyla yanıt verebileceğinden hatayı kolayca tespit edebilirsiniz.

Bağlantı hataları

000

API'ye bağlanılamadı

001

API sunucusundan yanıt yok

Kimlik doğrulama hataları

100

Kullanıcı adı veya API anahtarı verilmediği için oturum açma başarısız oldu

101

Belirtilen kullanıcı adı veya API anahtarıyla kullanıcı kimliği doğrulanamıyor

102

Kullanıcı şu anda etkin değil

103

Kullanıcı kilitli (yasaklanmış)

104

Kullanıcının okunmamış önemli bir reseller mesajı var. https://chimeratool.com.cn/reseller/ adresinden okunabilir. (Bağlantıyı açmadan önce giriş yapmanız gerekir) Okuyup kabul ettikten sonra API tekrar çalışacaktır.

105

Kullanıcı bayi statüsüne uygun değil

Transfer hataları

400

'userId' parametresi ayarlanmamış

401

'miktar' parametresi ayarlanmamış

402

'miktar' değeri sayısal değil

403

'miktar' değeri 1.0 veya daha büyük olmalıdır

404

Yeterli krediniz yok.

405

Belirtilen 'userId' ile tanımlanan kullanıcı bulunamadı

406

Kendinize transfer edemezsiniz

407

İşlem sırasında bir istisna meydana geldi. (Derhal destek ekibiyle iletişime geçin)

408

Bir bayiye aktarılabilecek minimum tutar 20000 kredidir

409

Transfer edilebilecek maksimum tutar 18000 kredidir

410

'userId' değeri sayısal olmalıdır.

Listeleme hataları

200

'limit' değeri 200'den büyük olamaz

201

'sayfa' numarası pozitif bir sayı olmalıdır

202

'limit' sayısı pozitif bir sayı olmalıdır

Hataları iptal et

300

'transferId' parametresini ayarlamanız gerekiyor

301

Belirtilen kimliğe sahip transfer kaydı bulunamadı

302

Transfer 1 günden eski olduğu için iptal edilemiyor

303

Kullanıcının iptal etmek için yeterli kredisi yok

304

Transfer zaten iptal edildi

Kullanıcı hatalarını kontrol edin

500

Belirtilen parametrelere sahip kullanıcı bulunamadı

501

'user' parametresi verilmedi

502

Kullanıcı izniyle ilgili hatalar

ChimeraCard hatalarını kontrol edin

600

'seri numarası' parametresi eksik

601

ChimeraCard bulunamadı

602

ChimeraCard durum hatası

Kullanıcı lisans hatalarını kontrol edin

700

'user' parametresi eksik

701

Kullanıcı bulunamadı

702

Bilinmeyen hata

Lisans hatalarını sat

801

'targetid' parametresi eksik

802

'targettype' parametresi eksik

803

'licencename' parametresi eksik

804

Lisans bulunamadı

805

hedef türü hatası

806

Hedef kontrol hatası

807

Yeterli kredi yok

808

Kullanıcı/ChimeraCard bulunamadı

809'targetid' tam sayı olmalıdır

Lisans hatalarını uzat

901

'userlicenceid' parametresi eksik

902

Lisans bulunamadı

903

Kullanıcı kontrol hatası

904

Lisans uzatılamaz

905

Yeterli kredi yok

Lisans yükseltme hataları

1001

'userlicenceid' parametresi eksik

1002

Lisans bulunamadı

1003

Kullanıcı kontrol hatası

1004

Lisans yükseltilemez

1005

'licencename' parametresi geçerli değil

1006

Yeterli kredi yok

1007

Kullanıcı lisansı ile aynı 'lisans adı'

Lisans hatalarını iptal et

1100

actionID geçersiz

1101

eylem bulunamadı

1102

lisans iptal edilemiyor çünkü transfer 1 günden eski

1104

eylem türü "Lisans satışı" değil

1105

eylem zaten iptal edildi

1107

bilinmeyen hata

 

API fonksiyonları

Tüm işlevler, her zaman 'success' adlı bir boolean tipi öğesi olan ilişkisel bir diziyle döner. Değeri FALSE ise, API çağrısı başarısız olmuştur ve yanıt dizisinde 'code' ve 'message' anahtarlarını da bulabilirsiniz. 'code' ve 'message' öğeleri hatayı açıklar. Hata kodları yukarıda listelenmiştir.

Hata olmadığı durumda çeşitli yanıtlar olabilir. Aşağıdaki liste, her fonksiyonu parametreleri ve dönüş değerleriyle birlikte açıklar. Dönüş değerlerinin listesi, döndürülen ilişkisel dizinin anahtarlarını belirtir.

ChimeraApi::getTransferList($sayfa = 1, $sınır = 50)

İşlemlerinizi bu yöntemle sorgulayabilir/listeleyebilirsiniz. İptal etmek istediğiniz işlemlerin ID'lerini alabilirsiniz. Oluşturulan liste tarihe göre azalan düzende sıralanır.

Parametreler:

  • $page - sonuç kümesinin sayfası (ilk sayfa 1'dir)
  • $limit - bir sayfadaki sonuç sayısı (200'den büyük olamaz)

Standart bir sayfalama işlevi gibidir. 500 işleminiz varsa ve $limit 50 olarak ayarlanmışsa, ilk sayfa 1-50 arasındaki işlemlerin sonuçlarını gösterir ve ikinci sayfa 51-100 arasındaki işlemleri gösterir.

Geri dönmek:

  • başarı - çağrının başarılı olup olmadığını gösterir (boolean)
  • transferler - kredi transferleri listesi (ilişkisel dizi)
    • id - transfer kimliği (int)
    • tarih - transfer tarihi (ilişkisel dizi, serileştirilmiş DateTime nesnesi)
    • from - kredilerin geldiği kullanıcının adı (dize)
    • kime - kredilerin gönderildiği kullanıcının adı (dize)
    • miktar - transfer edilen kredi miktarı (ondalık)
    • iptal edildi - işlemlerin iptal edildiğini gösterir (Boolean)

ChimeraApi::getInfo()

Hesabınız hakkında bilgi verir.

Parametreler: -

Geri dönmek:

  • başarı - çağrının başarılı olup olmadığını gösterir (boolean)
  • creditBalance - mevcut kredi bakiyeniz
  • transfersCount - kredi transferlerinizin sayısı

ChimeraApi::transferCredit($kullanıcıKimliği, $tutar)

Hesabınızdaki '$amount' tutarındaki krediyi '$userId' hesabına aktarır.

Parametreler:

  • $userId - Kredi göndermek istediğiniz kullanıcının kimliği
  • $miktar - transfer etmek istediğiniz kredilerin sayısı

Geri dönmek:

  • başarı - çağrının başarılı olup olmadığını gösterir (boolean)
  • transferId - Kredi transferinin kimliği (tam sayı)
  • mesaj - insan tarafından okunabilen başarı mesajı

ChimeraApi::transferi iptal et($transferId)

'$transferId' ile tanımlanan transferi iptal edin.

Parametreler:

  • $transferId - İptal etmek istediğiniz kredi transferinin kimliği (transferCredit'ten alın)

Geri dönmek:

  • başarı - çağrının başarılı olup olmadığını gösterir (boolean)
  • mesaj - insan tarafından okunabilen başarı mesajı

ChimeraApi::checkUser($kullanıcıadı, $e-posta)

Bu fonksiyon ile bir kullanıcıyı doğrulayabilirsiniz. Verilen kullanıcının ID'si ile cevap verir.

Parametreler:

  • $username - kullanıcının adı

Geri dönmek:

  • başarı - çağrının başarılı olup olmadığını gösterir (boolean)
  • userId - Belirtilen kullanıcının kimliği

ChimeraApi::checkChimeraCard($serinumarası)

Bu fonksiyonla ChimeraCard'ı doğrulayabilirsiniz.

Parametreler:

  • $serialnumber - kartın seri numarası

Geri dönmek:

  • başarı - çağrının başarılı olup olmadığını gösterir (boolean)
  • seri numarası - ChimeraCard'ın seri numarası (dize)
  • haslicence - ChimeraCard'ın bir lisansa sahip olup olmadığını gösterir (Boolean)
  • lisans adı - ChimeraCard'ın bir lisansı varsa lisans adı (dize) burada, aksi takdirde null

ChimeraApi::checkUserLicences($kullanıcıadı, $e-posta)

Kullanıcı lisanslarını kontrol edin.

Parametreler:

  • $username - kullanıcının adı

Geri dönmek:

  • başarı - çağrının başarılı olup olmadığını gösterir (boolean)
  • userId - Belirtilen kullanıcının kimliği
  • lisanslar - kullanıcı lisansları (dizi)

ChimeraApi::sellLicence($hedefkimliği, $hedeftürü, $lisansadı)

Lisans satışı.

Parametreler:

  • $targetid - hedefin kimliği (userID veya ChimeraCard seri numarası)
  • $targettype - 'kullanıcı' veya 'chimeracard'
  • $licencename - lisansın adı

Geri dönmek:

  • başarı - çağrının başarılı olup olmadığını gösterir (boolean)
  • actionId - Bayi eyleminin kimliği (tam sayı)

ChimeraApi::extendLicence($userlicenceid)

Lisansı uzatın.

Parametreler:

  • $userlicenceid - Kullanıcının lisansının kimliği

Geri dönmek:

  • başarı - çağrının başarılı olup olmadığını gösterir (boolean)

ChimeraApi::upgradeLicence($userlicenceid, $licencename = 'Pro')

Lisansınızı yükseltin.

Parametreler:

  • $userlicenceid - Kullanıcının lisansının kimliği
  • $licencename - 'Pro' veya 'Premium', varsayılan olarak 'Pro'dur (isteğe bağlı)

Geri dönmek:

  • başarı - çağrının başarılı olup olmadığını gösterir (boolean)

ChimeraApi::kullanılabilirLisanslar()

Mevcut lisansları listeler

Parametreler:

  • -

Geri dönmek:

  • lisanslar - mevcut lisanslar (dizi)

ChimeraApi::buyLicencePrices($userId)

Kullanıcı için lisans fiyatlarını hesaplar

Parametreler:

  • $kullanıcıKimliği

Geri dönmek:

  • lisanslar - mevcut lisanslar (dizi)

ChimeraApi::getSoldLicenceList($sayfa, $sınır)

Satılan lisansların listesini döndürür

Parametreler:

  • $page - sayfa numarası
  • $limit - sayfa başına sonuç

Geri dönmek:

  • başarı
  • soldLicences - (dizi)
  • sayfalama - sayfalama için bilgiler

ChimeraApi::lisansı iptal et($actionId)

Satılan bir lisansı iptal eder (mümkünse)

Parametreler:

  • $actionId - Eylemin kimliği (sellLicence ve getSoldLicenceList'ten alınır)

Geri dönmek:

  • başarı