Vanliga frågor om NiceNIC Domän-API v2

NiceNIC:s domän-API v2 är ett HTTPS- och JSON-baserat API för att automatisera domänhantering via ditt NiceNIC-konto.

Det stöder grundläggande arbetsflöden som kontroller av domäntillgänglighet, registrering, förnyelse, överföring, portföljfrågor, namnserver- och kontaktuppdateringar, prissättning, DNS-poster, underordnade namnservrar, kontoinformation och regelefterlevnadsåtgärder.

Använd API:et när du vill ansluta NiceNIC:s domäntjänster direkt till en webbplats, hostingplattform, faktureringssystem, internt verktyg eller annan applikation.

Alla aktiva NiceNIC-konton kan använda domän-API v2. API-åtkomst finns för både marknadskonton och återförsäljarkonton.

Du behöver inte bli återförsäljare enbart för att få API-åtkomst. Kontotypen har fortfarande betydelse för prissättningen: betalda API-operationer använder den prissättning som är kopplad till det NiceNIC-konto som skickar förfrågan.

Öppna API-inställningar →

Ja. API-åtkomsten i sig är gratis. Det tillkommer ingen separat avgift för att aktivera API-åtkomst eller skicka API-förfrågningar som stöds.

Betalda åtgärder som domänregistrering, förnyelse och överföring debiteras enligt ditt kontos prislista och tillämpliga domänregler.

Nej. API-åtkomst och återförsäljarpriser är separata.

Du kan använda domän-API v2 med ett vanligt marknadskonto hos NiceNIC. Uppgradera till ett återförsäljarkonto endast när återförsäljarpriser eller andra återförsäljarförmåner är till nytta för din affärsvolym.

Jämför återförsäljarplaner →

Domän-API v2 använder den aktuella API-strukturen hos NiceNIC med HTTPS-förfrågningar, JSON-svar, autentisering via headers och dokumentation organiserad kring enskilda domän- och kontoarbetsflöden.

Om du underhåller en integration som bygger på ett äldre NiceNIC API bör du granska parametrarna och svarshanteringen i API v2 innan du migrerar produktionstrafik, i stället för att anta att de två versionerna är utbytbara.

Logga in på ditt NiceNIC-konto och öppna API-inställningar. API v2-förfrågningar använder ditt NiceNIC-användarnamn och din API-hemlighet för autentisering.

Öppna API-inställningar →

Ja. NiceNIC tillhandahåller en API-sandlåda där utvecklare kan testa integrationer innan de ansluts till produktions-API:et.

Använd sandlådan för att validera autentisering, formatering av förfrågningar, tolkning av svar, felhantering och ditt applikationsarbetsflöde innan du aktiverar domänoperationer i produktion för kunder.

Öppna API-sandlådan →

API-sandlådan är avsedd för utveckling och integrationstestning. Produktions-API:et används för domänoperationer i produktion och betalda förfrågningar mot ditt NiceNIC-konto.

Vi rekommenderar att du validerar autentisering, hantering av förfrågningar, bearbetning av svar och fellogik i sandlådan innan du aktiverar kundinriktade produktionsoperationer.

Skicka API-förfrågningar över HTTPS och ta med ditt NiceNIC-användarnamn och din API-hemlighet i Authorization-huvudet.

Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json

Om IP-begränsningar är aktiverade för ditt konto måste förfrågningar även komma från en auktoriserad server-IP.

Läs API-autentisering →

Basändpunkten för produktions-API:et är:

https://api.nicenic.net/v2/

API-åtgärder väljs med hjälp av de parametrar som dokumenteras för varje ändpunkt, till exempel category och action. Följ alltid ändpunktens dokumentation för de obligatoriska och valfria parametrarna i en specifik operation.

Svar från API v2 använder JSON, och förfrågningsparametrar använder UTF-8.

{
  "code": 0,
  "msg": "success",
  "data": {}
}

Din applikation bör granska de returnerade värdena code och msg i stället för att anta att varje HTTP-svar representerar en slutförd domänoperation.

Genom de API:er som för närvarande är dokumenterade kan du automatisera arbetsflöden, inklusive kontroller av domäntillgänglighet, registrering, förnyelse och överföring, portföljlistning och domändetaljer, uppdateringar av namnservrar och domänkontakter, domänpriser, DNS-poster, underordnade namnservrar, kontoinformation samt övervakning av missbruk och regelefterlevnad.

Ytterligare arbetsflöden dokumenteras var för sig i API-navigeringen.

Börja med läsoperationer med låg risk, till exempel tillgänglighetskontroll av domäner, domänpriser, kontosaldo och domänlistning.

Verifiera därefter autentisering, parsning av svar, felhantering och hantering av väntande order innan du aktiverar registreringar, förnyelser eller överföringar i produktion.

Ja. Slutpunkten Kontrollera domäntillgänglighet stöder flera domännamn separerade med kommatecken.

example.com,example.net,example.org

Anta inte att varje API-operation stöder samma inmatningsformat för flera domäner. Registrering, förnyelse och överföring bör följa dokumentationen för respektive ändpunkt.

Använd slutpunkten Get Domain Pricing. De dokumenterade pristyperna inkluderar register, renew, transfer och all.

Registreringssvar kan även innehålla ett is_premium-värde som anger om den efterfrågade registreringen är premium.

Eftersom API-beställningar använder priser på kontonivå bör du hämta aktuella priser innan du skickar betalda kundbeställningar, i stället för att under obestämd tid förlita dig på cachelagrade priser.

Nej. Även om API-dokumentationen stöder perioder på upp till 1–10 år för tillämpliga domänändelser, kan enskilda TLD:er ha andra regler hos registret.

Registreringsperioder, förnyelseperioder, behörighet att överföra, kontaktkrav och verifieringskrav kan skilja sig åt mellan olika domänändelser. Din applikation bör följa de aktuella reglerna för den relevanta TLD:n.

Dessa är separata operationer och bör inte behandlas som om de vore utbytbara.

Använd alltid den returnerade koden och meddelandet när du fastställer statusen för en API-begäran.

Visa API-svarskoder →

Ett 201-svar innebär att åtgärden har accepterats för bearbetning, men att den inte nödvändigtvis har nått sitt slutgiltiga tillstånd.

För domänregistrering innebär ett 201-svar att beställningen har skickats in och väntar på slutlig handläggning hos registret.

Berätta inte för en slutkund att domänen är aktiv innan ditt system har bekräftat det slutgiltiga resultatet. Följ dokumentationen för registreringsslutpunkten för de senaste reglerna för hantering av väntande beställningar och återbetalningar.

En väntande överföring innebär att överföringsbegäran har accepterats för bearbetning, inte att domänen redan har överförts till NiceNIC.

Slutförandet av överföringen kan bero på handläggning hos registret och registraren samt på domänens aktuella överföringsstatus. Håll överföringen i vänteläge tills slutförandet har bekräftats.

Ja. API:et Lista domäner stödjer hämtning av portföljer med paginering, sortering och filtreringsalternativ.

Använd Hämta domäninformation när du behöver detaljerad information om en enskild domän, till exempel registreringsinformation, utgångsinformation, namnservrar och domänkontaktuppgifter.

NiceNIC domän-API v2 innehåller funktioner för missbruk och regelefterlevnad som är avsedda för plattformar och återförsäljare som hanterar kunders domänportföljer.

Du kan identifiera domäner som är kopplade till rapporter om missbruk och hämta maskinläsbar information om regelefterlevnad för enskilda domäner. Beroende på fallet kan svaret innehålla domänstatus, aktuell påverkan, rekommenderad åtgärd, spärrinformation, klagomålsinformation och rapporterade URL:er.

Detta gör det möjligt att visa regelefterlevnadsstatus direkt i din egen kundportal eller ditt operativa system.

Ja. NiceNIC tillhandahåller en WHMCS-registrarintegrering för företag som redan använder WHMCS för fakturering och provisionering.

Använd det direkta domän-API:et v2 när du bygger din egen applikation eller ditt eget arbetsflöde. Använd WHMCS-integrationen när du vill integrera domänoperationer i en befintlig WHMCS-miljö.

Visa WHMCS-integrationen →

Valfritt serverbaserat programmeringsspråk eller valfri körtidsmiljö som kan skicka HTTPS-anrop och tolka JSON kan integreras med Domän-API v2.

Vanliga val är PHP, Python, Node.js och Java. Förvara API-uppgifterna på serversidan och exponera aldrig din API-hemlighet i JavaScript i webbläsaren eller i nedladdningsbar klientkod.

Frekvensbegränsning kan tillämpas för att skydda API-stabiliteten och plattformssäkerheten.

Om din produktionsintegration förväntas generera en ihållande hög anropsvolym, kontakta NiceNIC innan lansering så att ditt förväntade användningsmönster kan granskas.

Inkludera tidsstämpeln för anropet, API-kategori och åtgärd, domännamn i förekommande fall, icke-känsliga anropsparametrar, returnerad svarskod och meddelande samt om anropet kom från sandlådan eller produktionsmiljön.

Skicka in ett supportärende →

Använd API-navigeringen i dokumentationen. Varje åtgärd har en egen sida med parametrar som stöds, exempel på anrop, exempel på svar och åtgärdsspecifikt beteende.

Vanliga frågor förklarar API:ets allmänna beteende; dokumentationen för den enskilda endpointen ska betraktas som den auktoritativa källan för det exakta anropsformatet.

Öppna API-dokumentationen →