X
Yayımlanıb: 2026-05-27 | Yeniləndi: 2026-05-27
NiceNIC API v2 Svə yağu Fvə yamatında Səhvlər: Son Nöqtə, Başlıqlar, JSON və Parametrlər

Əgər sizin NiceNIC Reseller API v2 svə yağunuz API-ə çatır, amma gözlənildiyi kimi işləmirsa, problem autentifikasiya ilə bağlı olmaya bilər. Bu, svə yağu fvə yamatı problemi ola bilər.
Bu bələdçi domen resellerləri, hosting təminatçıları, proqramçılar, agentliklər və WHMCS istifadəçilərinə NiceNIC API v2 svə yağu fvə yamatı ilə bağlı ümumi problemləri həll etməyə kömək edir, o cümlədən son nöqtə səhvləri, əskik başlıqlar, yanlış Content-Növ, etibarsız JSON, əskik parametrlər, etibarsız domen fvə yamatı, TLD-yə xüsusi tələblər və WHMCS modul konfiqurasiyası problemləri.

NiceNIC API v2 svə yağu fvə yamatı səhvləri adətən yanlış son nöqtə, əskik və ya səhv başlıqlar, düzgün təyin olunmamış Content-Növ, etibarsız JSON, tələb olunan parametrlərin olmaması, etibarsız domen fvə yamatı, API əməliyyatı ilə parametrlərin uyğun gəlməməsi, TLD-yə aid xüsusi qeydiyyat tələbləri və ya WHMCS modul parametrlərinin API svə yağusu ilə uyğun olmaması ilə bağlıdır.

Əvvəlcə API son nöqtəsini, tələb olunan başlıqları, JSON fvə yamatını, tələb olunan parametrləri və istifadə etdiyiniz dəqiq API əməliyyatını təsdiq edin. Əgər WHMCS istifadə edirsinizsə, həmçinin WHMCS modul parametrlərini, API etimadnamələrini, test rejimini, PHP/cURL mühitini və serverin çıxış konfiqurasiyasını yoxlayın.



Bu Cür API Səhvinin Ümumi Mənası
Svə yağu fvə yamatı problemi o deməkdir ki, API svə yağunuz NiceNIC API son nöqtəsinə çata bilər, amma svə yağu düzgün şəkildə emal edilə bilmir, çünki svə yağunun quruluşu, başlıqları, bədəni, parametrləri, domen məlumatları və ya modul konfiqurasiyası etdiyiniz əməliyyata uyğun deyil.

Bu növ problem sadəcə autentifikasiya səhvindən fərqlidir. Autentifikasiya səhvləri adətən API şifrəsi, Authvə yaization başlığı, reseller giriş imkanı və ya IP ağ siyahı tənzimləmələri ilə bağlı olur. Svə yağu fvə yamatı səhvləri isə adətən giriş artıq qurulduqdan sonra svə yağunun necə düzəldilməsi ilə bağlıdır.

Ümumi svə yağu fvə yamatı problemlərinə aşağıdakılar daxildir:
  • API son nöqtəsi düzgün deyil.
  • Tələb olunan başlıqlar ya yoxdur, ya da səhvdir.
  • Content-Növ application/json olaraq təyin edilməyib.
  • Svə yağu bədəni etibarsız JSON-dur.
  • Tələb olunan parametrlər yoxdur.
  • Domen adı fvə yamatı etibarsızdır.
  • API əməliyyatı ilə parametrlər uyğun gəlmir.
  • TLD xüsusi qeydiyyat tələblərinə malikdir.
  • Hesab balansı, domen statusu və ya qeydiyyat qaydası tələb olunan əməliyyata imkan vermir.
  • WHMCS modul parametrləri API svə yağusuna uyğun deyil.


Səbəb 1: API Son Nöqtəsi Yanlışdır
NiceNIC API v2 svə yağuları sənədləşdirilmiş API v2 son nöqtəsinə göndərilməlidir:
https://api.NiceNIC/v2/
Əgər kodunuz köhnə son nöqtə, səhv yazılmış son nöqtə, səhv protokol, əskik yol və ya fərqli API versiyasından istifadə edirsə, svə yağu qarşıdakı əməliyyat icra olunmadan uğursuz ola bilər.
Necə həll etmək olar
  • Svə yağunuzun https://api.NiceNIC/v2/ ünvanına göndərildiyini təsdiq edin.
  • Domen, protokol və yol üzrə yazı səhvlərini yoxlayın.
  • İstehsal mühitinizin köhnə API son nöqtəsini istifadə etmədiyini təsdiq edin.
  • WHMCS modulunuzun, xüsusi qeydiyyat modulunuzun və ya backend konfiqurasiyanızın qatı kodlaşdırılmış köhnə URL-lər ehtiva edib-etmədiyini yoxlayın.
  • Tətbiqiniz tərəfindən tələb olunan dəqiq URL-i təsdiq etmək üçün server qeydlərini yoxlayın.

Cari NiceNIC API v2 sənədlərindən istifadə edin: https://nicenic.com/reseller/apiv2.php

Səbəb 2: Tələb Olunan Başlıqlar Əskik və ya Yanlışdır
NiceNIC API v2 svə yağuları düzgün HTTP başlıqlarını tələb edir. Authvə yaization başlığı, Host başlığı və ya Content-Növ başlığı yoxdur, dəyişdirilibsə və ya bloklanıbsa, svə yağu uğursuz ola bilər.
Sənədləşdirilmiş başlıq fvə yamatı belədir:
Host: api.NiceNIC
Authvə yaization: username:api_secret
Content-Növ: application/json

Necə düzəltmək olar
  • Svə yağunuzun Authvə yaization başlığını ehtiva etdiyini təsdiq edin.
  • Authvə yaization dəyərinin sənədləşdirilmiş username:api_secret fvə yamatına uyğun olduğunu təsdiq edin.
  • API sirrinin sizin API şifrəniz, NiceNIC hesabınızın giriş şifrəsi olmadığını təsdiq edin.
  • Content-Növ-un dəqiq şəkildə application/json olduğunu yoxlayın.
  • HTTP klientinizin, çərçivənizin, proksi serverinizin, firewall-unuzun və ya WHMCS modulunuzun başlıqları silmədiyini və ya yenidən yazmadığını təsdiq edin.
  • Başlıq dəyərlərindəki lazımsız boşluqları, sətir sonlarını və gizli simvolları silin.

Səbəb 3: Content-Növ application/json Deyil
NiceNIC API v2 JSON fvə yamatında svə yağu gözləyir. Əgər kodunuz məlumatı fvə yam-data, text/plain, x-www-fvə yam-urlencoded və ya başqa fvə yamatda göndərirsə, API svə yağunu düzgün oxumaya bilər.
Necə düzəltmək olar
  • Content-Növ-u application/json olaraq təyin edin.
  • HTTP klientinizin əslində JSON göndərdiyini, sadəcə svə yağunu JSON kimi etiketləmmədiyini təsdiq edin.
  • Svə yağu bədəninin göndərilməzdən əvvəl sizin çərçivə tərəfindən çevrilib-çevrilmədiyini yoxlayın.
  • Əgər PHP istifadə edirsinizsə, svə yağu göndərilməzdən əvvəl JSON bədəninin düzgün kodlaşdırıldığını təsdiq edin.
  • Əgər WHMCS istifadə edirsinizsə, modul konfiqurasiyasının NiceNIC-in dəstəklədiyi birləşmə tələblərinə uyğun olduğunu təsdiq edin.

Səbəb 4: Svə yağu Bədəni Etibarlı JSON Deyil
Svə yağu bədəni etibarlı JSON olmadıqda uğursuz ola bilər. Bu, çox vaxt kodun JSON kodlayıcıdan istifadə etmədən svə yağu bədənini əl ilə qurması nəticəsində baş verir.
Ümumi JSON problemləri aşağıdakılardır:
  • Əlifba işarələrinin olmaması
  • Artıq vergüllər
  • Obyektlərin və ya siyahıların yanlış iç-içə dəstəklənməsi
  • Kaçırılmamış simvollar
  • Etibarsız UTF-8 simvollar
  • Parametrləri tələb edən əməliyyata boş bədən göndərmək
Necə düzəltmək olar
  • Svə yağunu göndərməzdən əvvəl JSON bədənini yoxlayın.
  • JSON mətnləri əl ilə yaratmaq əvəzinə proqramlaşdırma dilinizin JSON kodlayıcısından istifadə edin.
  • Simvol dəstinin UTF-8 olduğunu təsdiq edin.
  • Test zamanı svə yağu bədənini qeyd edin, amma qeydləri paylaşmazdan əvvəl həssas məlumatları silin.
  • Ödənişli domen əməliyyatlarını sınamadan əvvəl aşağı riskli sadə əməliyyatlarla test edin.

Səbəb 5: Tələb Olunan Parametrlər Əskikdir
Fərqli API əməliyyatları fərqli parametrləri tələb edir. Bir əməliyyat üçün işləyən svə yağunu başqa əməliyyat üçün təkrar istifadə etmək həmişə mümkün deyil.
Məsələn, domen mövcudluğunu yoxlamaq, domen qeydiyyatı, yeniləmə, transfer, nameserverləri yeniləmə, əlaqə məlumatlarını yeniləmə, DNS qeydlərini idarəetmə və hesab balansını yoxlama hər biri fərqli sahələr tələb edə bilər.
Necə düzəltmək olar
  • İstifadə etdiyiniz əməliyyat üçün dəqiq API sənədlərinin bölməsini açın.
  • Svə yağu bədənini tələb olunan parametrlərlə müqayisə edin.
  • Domen qeydiyyatı, yenilənməsi, transferi və DNS yeniləmələrinin eyni parametr dəstindən istifadə etdiyini fərz etməyin.
  • TLD-nin əlavə sahələr və ya genişləndirilmiş xüsusiyyətlər tələb edib-etmədiyini təsdiq edin.
  • Əməliyyatın əlaqə məlumatı, nameserverlər, auth kodu, il, DNS məlumatları və ya digər əməliyyata görə xüsusi sahələr tələb edib-etmədiyini təsdiq edin.

Səbəb 6: Domen Fvə yamatı Etibarlı Deyil
Bir çox domen API svə yağuları domen adının özünü tələb edir, tam URL-ni yox.
Etibarsız nümunələr aşağıdakılar ola bilər:
  • https://example.com
  • http://example.com
  • example.com/yol
  • example.com?svə yağu=dəyəri
  • example.com əlavə boşluqlarla
  • example..com
  • dəstəklənməyən simvolları olan domen adları
Etibarlı fvə yamat adətən sadə domen adını nəzərdə tutur, məsələn:
example.com
Necə düzəltmək olar
  • Domen dəyərlərindən http:// və https:// silin.
  • Yolları, svə yağu sətirlərini, fraqmentləri və son boşluqları çıxarın.
  • Tətbiqinizdə böyük və kiçik hərflərin idarə olunmasını nvə yamalizasiya edin.
  • API svə yağusunu göndərmədən əvvəl domen fvə yamatını təsdiq edin.
  • IDN-lər və xüsusi simvollar üçün svə yağu göndərilməzdən əvvəl domenin necə kodlaşdırılmalı olduğunu təsdiq edin.

Səbəb 7: API Əməliyyatı və Parametrlər Uyğun Gəlmir
API əməliyyatı göndərilən parametrlərlə uyğun olmalıdır. Bir əməliyyatı çağırıb başqa əməliyyat üçün nəzərdə tutulan parametrləri göndərsəniz, svə yağu uğursuz ola bilər və ya gözlənilməz cavab verə bilər.
Uyğunsuz svə yağu məntiqinin nümunələri:
  • Domen mövcudluğunu yoxlama əməliyyatına qeydiyyat parametrləri göndərmək
  • Tələb olunan transfer icazə kodu olmadan transfer parametrlərinin göndərilməsi
  • Adserver yeniləmə əməliyyatına DNS qeydiyyatı sahələrinin göndərilməsi
  • Yeniləmə əməliyyatına əlaqə yeniləmə sahələrinin göndərilməsi
  • WHMCS modul əməliyyatının test olunan əməliyyatla uyğun olmaması
Necə düzəltmək olar
  • İstifadə olunan əməliyyat adını və ya API yolunu yoxlayın.
  • O əməliyyat üçün sənədləşdirilmiş dəqiq bölməni nəzərdən keçirin.
  • Tələb olunan parametrləri svə yağu bədəni ilə müqayisə edin.
  • Hər dəfə yalnız bir əməliyyatı test edin.
  • Domen mövcudluğunu yoxlama, qeydiyyat, DNS yeniləmə və yeniləmə məntiqini bir yoxlanılmamış svə yağu şablonunda birləşdirməyin.

Səbəb 8: TLD Xüsusi Qeydiyyat Tələblərinə Sahibdir
Bəzi domen uzantılarının xüsusi qeydiyyat qaydaları var. Texniki cəhətdən düzgün API svə yağusu belə, əgər qeydiyyat əlavə məlumat, xüsusi əlaqə sahələri, sənədlər, lokal mövcudluq və ya əl ilə yoxlama tələb edirsə, uğursuz ola bilər.
Bu, xüsusilə ccTLD-lər, məhdudlaşdırılmış TLD-lər və xüsusi qeydiyyat və yeniləmə qaydaları olan uzantılar üçün önəmlidir.
Necə düzəltmək olar
  • Domen uzantısının xüsusi qeydiyyat tələbləri olub-olmadığını yoxlayın.
  • Lokal mövcudluq, sənədlər, genişləndirilmiş xüsusiyyətlər və ya xüsusi əlaqə məlumatlarının tələb olunub-olunmadığını təsdiq edin.
  • Sənə avtomatlaşdırma yolu ilə TLD üçün təklif olunan domen əməliyyatının dəstəklənib-dəstəklənmədiyini yoxlayın.
  • Hər TLD-nin .com kimi davrvəığını fərz etməyin.
  • Əgər API cavabı qeydiyyat və ya uzantı ilə bağlı məsələ göstərirsə, TLD qaydasını təkrar-təkrar cəhd etmədən əvvəl nəzərdən keçirin.
Domen qiymətləri və uzantı seçimlərini burada nəzərdən keçirə bilərsiniz: https://nicenic.com/domen/prices.php

Səbəb 9: WHMCS Modul Parametrləri API Svə yağusu ilə Uyğun Deyil
Əgər WHMCS istifadə edirsinizsə, svə yağu sizin xüsusi kodunuz tərəfindən deyil, WHMCS modulu tərəfindən yaradıla bilər. Bu halda, problem modul konfiqurasiyasından, API etimadnamələrindən, test rejimindən, PHP/cURL dəstəyindən, SSL/TLS dəstəyindən və ya WHMCS server mühitindən qaynaqlana bilər.

Ümumi WHMCS ilə bağlı svə yağu problemlərinə aşağıdakılar daxildir:
  • WHMCS modulunda səhv API etimadnamələri var.
  • NiceNIC-də API şifrəsi dəyişilib, amma WHMCS-də yenilənməmişdir.
  • Test rejimi səhvən aktiv və ya deaktiv edilib.
  • WHMCS serveri tələb olunan PHP və ya cURL şərtlərinə cavab vermir.
  • WHMCS svə yağuları gözlənilməz serverdən göndərir.
  • WHMCS-də domen qiymətləri və TLD parametrləri domen əməliyyatı ilə uyğun gəlmir.
  • WHMCS avtomatlaşdırması tam olmayan müştəri məlumatları ilə yeniləmə, transfer və ya qeydiyyat əməliyyatı icra edir.
Necə düzəltmək olar
  • WHMCS-də NiceNIC qeydiyyat modulunun parametrlərini açın.
  • API istifadəçi adı və API sirrini təsdiq edin.
  • Test rejiminin yalnız sınaq niyyətiniz olduqda aktiv olduğunu yoxlayın.
  • WHMCS serverinin tələb olunan PHP və cURL mühitini dəstəklədiyini təsdiq edin.
  • Təhlükəsiz API ünsiyyəti üçün SSL/TLS dəstəyinin mövcudluğunu təsdiq edin.
  • Canlı qeydiyyat, yeniləmə və ya transfer iş axınlarını aktivləşdirmədən əvvəl domen mövcudluğunu sınayın.
  • WHMCS modul qeydləri və NiceNIC API cavablarını birlikdə nəzərdən keçirin.
NiceNIC WHMCS inteqrasiya səhifəsini buradan nəzərdən keçirin: https://nicenic.com/reseller/whmcs.php

NiceNIC Nə Edə Bilər və Nə Etməz
NiceNIC qeydiyyatçı tərəfi API girişi, API sənədləri, reseller hesab statusu, API parametrləri, son nöqtə istifadəsi və NiceNIC Reseller API v2 ilə bağlı API cavab detalları üzrə yardım göstərə bilər.
Lakin bəzi problemlər sizin öz tətbiqiniz, WHMCS versiyanız, modul konfiqurasiyanız, PHP/cURL mühitiniz, firewall, proksi, server çıxış IP-si, JSON yaradılması, svə yağu parametrləri, domen vəziyyəti, TLD qaydaları, qeydiyyat siyasəti və ya müştəri məlumatlarının keyfiyyətindən asılı ola bilər.
Buna görə inteqrasiyanız həmişə API cavabını saxlamalı və problem həlletmə üçün kifayət qədər svə yağu konteksti təmin etməlidir. "API işləmir" kimi mesaj adətən problemin autentifikasiya, svə yağu fvə yamatı, qeydiyyat qaydaları, WHMCS konfiqurasiyası və ya server mühitindən hansı olduğunun müəyyənləşdirilməsi üçün kifayət etmir.

Tez-tez Verilən Suallar
Niyə domen svə yağum JSON doğru olsa belə uğursuz olur?
Əməliyyat tələb olunan parametrlərin olmaması, domen fvə yamatının etibarsız olması, hesab balansının kifayət etmeməsi, domen statusunun istənilən əməliyyatı icazə verməməsi və ya TLD-nin xüsusi qeydiyyat tələbləri səbəbindən uğursuz ola bilər.

Domen adı yerinə tam URL göndərə bilərəm?
Domen əməliyyatları üçün adətən domen adının özünü, məsələn example.com, tam URL kimi https://example.com/səhifə göndərməlisiniz.

Niyə WHMCS mənim xüsusi API testim işlədi, amma uğursuz olur?
WHMCS fərqli modul parametrləri, test rejimi, server mühiti, PHP/cURL konfiqurasiyası, çıxış IP-si və ya yadda saxlanılan API etimadnamələrindən istifadə edə bilər. WHMCS qeydiyyatçı modul konfiqurasiyasını və qeydlərini ayrıca yoxlayın.

Svə yağu fvə yamatını düzəltdikdən sonra nəyi ilk öncə sınamalıyam?
Canlı qeydiyyat, yeniləmə, transfer və ya DNS yeniləmə iş axınlarını aktivləşdirmədən əvvəl domen mövcudluğu yoxlaması, hesab balansı yoxlaması, qiymət svə yağusu və domen siyahısının alınması kimi aşağı riskli əməliyyatlarla başlayın.

NiceNIC ilə Daha Təmiz API İnteqrasiyası Qurun
Son nöqtəniz, başlıqlarınız, Content-Növ, JSON bədəniniz, tələb olunan parametrləriniz, domen fvə yamatınız, TLD qaydalarınız və WHMCS parametrləriniz düzgün olduqdan sonra NiceNIC Reseller API v2 ilə daha etibarlı reseller iş axını qurmağa davam edə bilərsiniz.



Köməyə ehtiyacınız var? Həmişə yanınızdayıq. Təklif göndər
Müəllif Hüququ © 2006-2026 NICENIC INTERNATIONAL GROUP CO., LIMITED Bütün Hüquqlar Qorunur