Himk
ՄուտքԳրանցվել
Փաստաթղթեր

Կառավարեք գրառումները API-ով

Թարմացվել է 10 նոյեմբերի, 2026 թ. · 1 րոպե · Նաև՝ English, Русский

Այն ամենը, ինչ գրառումների հետ անում եք վահանակում, կարող եք անել նաև API-ով․ դա հարմար է տեղակայումների, CI խողովակաշարերի և սկրիպտների համար։ Ձեզ անհրաժեշտ է API թոքեն՝ պահված HIMK_TOKEN միջավայրի փոփոխականում։

1. Ստեղծեք գրառում

Ուղարկեք POST հարցում գոտու գրառումներին․

bash
curl -X POST https://api.himk.am/v1/zones/example.am/records \
  -H "Authorization: Bearer $HIMK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type": "A", "name": "www", "content": "203.0.113.10", "ttl": 300}'

Հարցման մարմինն ունի չորս դաշտ․

  • type՝ A, AAAA, MX, TXT, CNAME տեսակներից մեկը։
  • name՝ անունը գոտու նկատմամբ, օրինակ՝ www։
  • content՝ արժեքը, օրինակ՝ IP հասցե կամ հոսթի անուն։
  • ttl՝ քանի վայրկյան ռեզոլվերները կարող են քեշավորել գրառումը։

2. Կարդացեք պատասխանը

API-ն վերադարձնում է նոր գրառումը․

json
{"id": "rec_8f2k1q", "name": "www.example.am", "type": "A", "ttl": 300}

Պահպանեք id-ն, եթե սկրիպտին հետագայում պետք կլինի փոխել կամ ջնջել գրառումը։

3. Գործարկեք CI-ից

Պահեք թոքենը ձեր CI համակարգում որպես HIMK_TOKEN անունով գաղտնի փոփոխական, երբեք՝ ռեպոզիտորիայում։ Յուրաքանչյուր խողովակաշարի համար օգտագործեք առանձին թոքեն, որպեսզի կարողանաք այն չեղարկել առանձին։

Հաջորդ քայլերը