Ry.hk Ry.hk

API

Управљајте доменима из програма, а не са странице у исто време.

Жичана регистрација, провере доступности, DNS и управљање вашим сопственим системима: масовно наручивање, обнова прегледа, контролна табла за ваше клијенте.

API је улазна тачка машине за исте операције које нуди клијентско подручје. Оно што можете да урадите на страници, можете да скриптујете.

РЕСТ HTTPS са одговорима JSON
API кључеви Креиран и опозван у клијентској области
Потпуна покривеност Исте операције као и подручје клијента
Проверљиво Позиви се снимају на налог

Шта је то

  • Крајње тачке су груписане према ресурсима – доступности, доменима, серверима имена, контактима, поруџбинама и фактурама – и враћају JSON.
  • Аутентификација користи кључ API генерисан у клијентској области, који се може опозвати и заменити у било ком тренутку.
  • Уобичајене употребе: групна регистрација, преглед истека, синхронизација стања домена са сопственим системом, самоуслужни панел за клијенте и аутоматизовани радни ток сертификата.
  • Важе иста пословна правила као на вебу: домен се не може регистровати из ничега, а за пренос је и даље потребан откључан домен и 60 дана.

Како то ради

01

Направите кључ

Генеришите кључ API у области клијента, у зависности од тога шта треба да уради.

02

Прочитајте документацију

Крајње тачке, параметри и облици одговора.

03

Тест мали

Испробајте крајње тачке само за читање или неколико домена пре аутоматизације.

04

Крените уживо са евидентирањем

Додајте поновне покушаје и евидентирање пре него што дође до производње.

Доступност и претрага

Проверите више имена одједном за праћење и избор.

Регистрација и обнова

Наручите, обновите и прочитајте статус поруџбине.

DNS и сервери имена

Пусх записе и промене сервера имена у великом броју.

Контакт менаџмент

Прочитајте и ажурирајте регистранта, администратора, технику и наплату.

Поруџбине и фактуре

Прочитајте поруџбине, фактуре и статус плаћања.

Ротација кључа

Опозовите и замените кључеве; држати сваки систем на свом кључу.

Шта покрива API

По ресурсу

РесурсШта можеш да урадиш
ДомениПроверите доступност, региструјте се, обновите, прочитајте статус и истекне
DNSЧитање и подешавање сервера имена, одржавање записа DNS
Приватност и контактиПодесите ниво приватности, ажурирајте све четири улоге контакта
Поруџбине и фактурисањеПрочитајте поруџбине, фактуре и статус плаћања
НалогПрочитајте стање и основне детаље рачуна

Шта треба да имате на месту пре него што се повежете

Четири мале ствари које штеде већину отклањања грешака

  • Стање или исправан начин плаћања: регистрација и обнова су стварне поруџбине, а позив неће успети у кораку наручивања без средстава.
  • Поновни покушаји и руковање грешкама: дешавају се грешке мреже, ограничења брзине и кашњења узводно. Поновите идемпотентно читање; за поруџбине, пошаљите јединствену референцу и проверите пре него што поново пишете.
  • Евидентирање: забележите референцу, домен и код одговора. Када се нешто касније оспори, ти балвани су једини доказ да се акција десила.
  • Најмања привилегија: не користите кључ за писање за посао само за читање и дајте сваком систему сопствени кључ како би један могао да буде опозван, а да се други не покваре.

Кључ API је еквивалентан лозинки налога. Чувајте га у променљивој окружења на страни сервера или у менаџеру тајни, никада у фронт-енд коду и никада у спремишту.

Како га људи користе

Уобичајени обрасци

  • Групни регистратор: пошаљите избор за регистрацију и запишите резултате назад у своју позадину.
  • Обнављање: повуците домене који се приближавају истеку сваке ноћи и подигните сопствени подсетник или задатке обнове.
  • Панои са белим ознакама: омогућите клијентима да управљају доменима унутар вашег производа, без пријављивања овде.
  • Помирење: извуците податке о домену и наруџбини према распореду и упарите их са сопственом књигом.

Шта укључује свака наруџбина

API управљање кључевима

Креирајте, опозовите и одвојите кључеве према сврси.

Документација

Крајње тачке, параметри и одговори.

Домен и крајње тачке DNS

Претражујте, региструјте, обновите, DNS и сервере имена.

Крајње тачке за наручивање и обрачун

Поруџбине, фактуре и статус плаћања.

Историја позива

Забележено на рачуну ради решавања проблема.

Подршка

Отворите карту ако се интеграција не понаша лоше.

Уобичајена питања

Постоји ли додатна накнада за API?

Сам API се не наплаћује посебно; плаћате за пословне операције које обавља. Постоји разумно ограничење стопе да се спречи случајна или злоупотреба.

Да ли постоји СДК?

API је стандардни HTTPS и JSON, тако да сваки клијент HTTP ради. Документација укључује примере захтева који се могу директно прилагодити.

Шта ако кључ процури?

Опозовите га у клијентској области и генеришете нову. Опозив ступа на снагу одмах и захтеви који користе стари кључ се одбијају.

Да ли тестирање нешто кошта?

Позиви само за читање не коштају ништа. Регистрација и обнова су стварне поруџбине и коштају, па прво проверите логику на малом броју домена.

Може ли API да управља доменима регистрованим на другом месту?

Не. Функционише на доменима на овом налогу, баш као што ради и област за клијенте.

Имајте на уму

  • Чувајте кључеве API на серверу. Кључ који се испоручује у коду претраживача или пакету за мобилне уређаје је објављени кључ.
  • За наручивање крајњих тачака, пошаљите јединствену референцу захтева и проверите пре писања, тако да се поновни покушај мреже не региструје или наплаћује двапут.

Спремни за почетак?

Отворите страницу за ову услугу и завршите у неколико корака. Ако бисте радије питали прво, карта стиже до особе.