REST API

Hivesigner API'si https://hivesigner.com/api/ manzilida joylashgan. U tizimga kirgan foydalanuvchining hisobini qaytaradi, uning nomidan posting amallarini tarmoqqa yuboradi, kodlarni tokenlarga almashtiradi va Hivesigner'dan foydalanadigan ilovalarni roʻyxatlaydi. Bu sahifa har bir manzilni soʻrovlari, javoblari va xatolari bilan tavsiflaydi.

Soʻrovlar va autentifikatsiya

• Asosiy manzil: https://hivesigner.com/api/. Quyidagi har bir manzil https://hivesigner.com ga nisbatan beriladi.
• Token: uni Authorization sarlavhasida qanday boʻlsa shundayligicha yuboring: Authorization: ACCESS_TOKEN. Bearer prefiksi ham qabul qilinadi. Uni soʻrov qatorida yoki tanada access_token sifatida ham yuborishingiz mumkin, ammo sarlavha tokenni URL manzillari va jurnallardan tashqarida saqlaydi.
• Tanalar: Content-Type: application/json bilan JSON yoki forma (application/x-www-form-urlencoded).
• Javoblar: JSON.
• Brauzerlar: API domenlararo soʻrovlarga ruxsat beradi, shuning uchun veb-ilova uni bevosita chaqira oladi.

Token olish uchun qarang: OAuth2 orqali kirish. Token nimalarni saqlashi haqida qarang: Tokenlar.

Xatolar

Xato javobi HTTP xato holatiga va shunday tanaga ega boʻladi:

{
  "error": "invalid_scope",
  "error_description": "The access_token scope does not allow the following operation(s): transfer"
}

GET /api/me

Token tegishli boʻlgan hisobni qaytaradi. Undan kim kirganini bilish yoki tokenni tekshirish uchun foydalaning.

• Usullar: GET yoki POST.
• Token: kirish tokeni, shu jumladan ilovani koʻrsatadigan login tokeni.

curl https://hivesigner.com/api/me -H 'Authorization: ACCESS_TOKEN'

Qisqartirilgan javob:

{
  "user": "alice",
  "_id": "alice",
  "name": "alice",
  "account": { "id": 1370484, "name": "alice" },
  "scope": [
    "vote",
    "comment",
    "delete_comment",
    "comment_options",
    "custom_json",
    "claim_reward_balance",
    "account_update2"
  ],
  "user_metadata": { "profile": { "name": "Alice", "version": 2 } }
}

/api/me token qaysi ilova uchun yaratilganini aytmaydi. Buni tekshirish uchun tokenni dekodlang: qarang: API'dan soʻrang.

POST /api/broadcast

Token foydalanuvchisi uchun posting amallarini @hivesigner posting kaliti bilan imzolaydi va ularni Hive tarmogʻiga yuboradi.

• Usul: POST.
• Token: token oqimidan yoki kod oqimidan olingan posting kirish tokeni.
• Avval nima boʻlishi kerak: foydalanuvchi ilova hisobingizga posting vakolatini bergan boʻlishi (buni ruxsat ekrani bajaradi) va ilova hisobingiz @hivesigner'ga posting vakolatini bergan boʻlishi kerak.
• Tana: { "operations": [...] }, bunda har bir amal Hive blokcheynidagidek [name, fields] koʻrinishida boʻladi. Bitta soʻrovdagi barcha amallar bitta tranzaksiyaga tushadi.

POST /api/broadcast HTTP/1.1
Host: hivesigner.com
Authorization: ACCESS_TOKEN
Content-Type: application/json

{
  "operations": [
    ["vote", { "voter": "alice", "author": "bob", "permlink": "my-first-post", "weight": 10000 }]
  ]
}

Xuddi shu soʻrov curl bilan:

curl -X POST https://hivesigner.com/api/broadcast \
  -H 'Authorization: ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"operations":[["vote",{"voter":"alice","author":"bob","permlink":"my-first-post","weight":10000}]]}'

Obuna bu custom_json amali:

{
  "operations": [
    ["custom_json", {
      "required_auths": [],
      "required_posting_auths": ["alice"],
      "id": "follow",
      "json": "[\"follow\",{\"follower\":\"alice\",\"following\":\"bob\",\"what\":[\"blog\"]}]"
    }]
  ]
}

Hive tuguni tranzaksiyani qabul qilishi bilanoq API javob beradi. result.id bu tranzaksiya identifikatori:

{
  "result": { "id": "TRANSACTION_ID" }
}

Tarmoq tranzaksiyani rad etganda javob server_error bilan 500 boʻladi. Uning error_description maydoni tarmoq xabarini, response esa xom xatoni olib keladi.

broadcast nimani qabul qiladi

Posting tokeni API'ga faqat shu amallarni yuborishga ruxsat beradi, boshqasiga emas. Ularning har birida token foydalanuvchisi koʻrsatilgan maydondagi hisob boʻlishi kerak:

• Boshqa har qanday amal invalid_scope bilan rad etiladi. login tokeni hech qanday amalga ruxsat bermaydi.
• Boshqa hisob uchun amal unauthorized_client bilan rad etiladi. Token faqat oʻz foydalanuvchisi nomidan tranzaksiya yuboradi.
• account_update2 faqat hisobning profil maʼlumotlarini oʻzgartira oladi. owner, active yoki posting maydoni bor amal unauthorized_client bilan rad etiladi.
• custom_json: required_auths maydonini boʻsh qoldiring. API posting vakolati bilan imzolaydi, shuning uchun active vakolat talab qiladigan amal tarmoqda muvaffaqiyatsiz tugaydi.

Pul oʻtkazmalari va hamyon bilan bogʻliq boshqa amallar foydalanuvchining active kalitini talab qiladi. Ularni buning oʻrniga imzo havolasi sifatida yuboring.

POST /api/oauth2/token

Kodni tokenlarga yoki yangilash tokenini yangi tokenlarga almashtiradi. Uni faqat serveringizdan chaqiring. Qarang: Kod oqimi.

• Usul: POST, qiymatlar tanada.
• Tana: code va client_secret yoki refresh_token va client_secret.
• Sarlavhalar: Authorization sarlavhasini yubormang.

curl -X POST https://hivesigner.com/api/oauth2/token \
  -H 'Content-Type: application/json' \
  -d '{"code": "CODE", "client_secret": "CLIENT_SECRET"}'

{
  "access_token": "ACCESS_TOKEN",
  "refresh_token": "REFRESH_TOKEN",
  "expires_in": 604800,
  "username": "alice"
}

Har bir chaqiruv yangi kirish tokeni va yangi yangilash tokenini qaytaradi. Ikkalasini ham @hivesigner imzolaydi. expires_in bu kirish tokenining sekundlardagi amal qilish muddati (7 kun).

Xatolar: 401 invalid_grant. Yuborilgan qiymat yaroqli kod yoki yangilash tokeni boʻlmaganda tavsif «The token has invalid role» boʻladi. Kod yoki maxfiy kalit mos kelmaganda esa «The code or secret is not valid» boʻladi.

POST /api/oauth2/token/revoke

Hivesigner'ga foydalanuvchi ilovangizdan chiqqanini bildiradi. Tokenni ilovangiz oʻzi tashlab yuboradi.

• Usul: POST.
• Token: kirish tokeni, Authorization sarlavhasida.

curl -X POST https://hivesigner.com/api/oauth2/token/revoke -H 'Authorization: ACCESS_TOKEN'

{ "success": true }

JavaScript SDK'sining revokeToken() funksiyasi shu chaqiruvni bajaradi va keyin tokenni unutadi. Ilovangiz ruxsatini butunlay olib tashlash uchun foydalanuvchi uni https://hivesigner.com/authorized-apps sahifasida oʻchiradi. Qarang: Chiqish va ruxsatni olib tashlash.

GET /api/apps

Ochiq ilovalar katalogi: Hivesigner orqali tranzaksiya yuboradigan ilovalar, ulardan qancha odam foydalanishiga qarab tartiblangan. Unga token kerak emas. https://hivesigner.com/apps xuddi shu roʻyxatni koʻrsatadi.

curl https://hivesigner.com/api/apps

{
  "updated_at": "2026-09-19T06:00:00.000Z",
  "building": false,
  "window_days": 7,
  "featured": ["myapp"],
  "apps": [
    {
      "username": "myapp",
      "name": "My App",
      "about": "A short description from the app's profile.",
      "website": "https://myapp.example",
      "site": "ok",
      "users": 412,
      "requests": 9310,
      "first_seen": "2026-08-01",
      "last_seen": "2026-09-19",
      "new": false
    }
  ]
}

Javob 5 daqiqagacha keshlanishi mumkin. Katalog birinchi marta tuzilgunicha API unavailable bilan 503 javobini beradi. Keyinroq qayta urinib koʻring.

Nomlar va tavsiflarni har bir ilova hisobi oʻzi eʼlon qiladi. Hivesigner ularni tekshirmaydi.