وضعیت تأیید یک تراکنش

GET/v1/transactions/approvals

نشان می‌دهد هر حدنصاب چند تأیید و رد دارد و چه کسانی رأی داده‌اند. این مسیر فقط می‌خواند؛ تأیید هرگز با API انجام نمی‌شود.

دسترسی لازم

approve-read

سقف نرخ در دقیقه

120 برای هر کلید

درخواست

curl

curl 'https://api.romu.ir/v1/transactions/approvals?id=0192f1a2-5e4f-7a10-b2c3-d4e5f6a7b8c9' \
  -H "X-Custody-Key-Id: $KEY_ID" \
  -H "X-Custody-Timestamp: $TIMESTAMP" \
  -H "X-Custody-Nonce: $NONCE" \
  -H "X-Custody-Signature: $SIGNATURE"

TypeScript

import { romu } from "./romu.ts";

const res = await romu.get("/v1/transactions/approvals", {
  query: "id=0192f1a2-5e4f-7a10-b2c3-d4e5f6a7b8c9",
});
console.log(res.status, res.body);

Go

status, body, err := client.Get("/v1/transactions/approvals", "id=0192f1a2-5e4f-7a10-b2c3-d4e5f6a7b8c9")

Python

import romu

status, body = romu.get(
    "/v1/transactions/approvals",
    query="id=0192f1a2-5e4f-7a10-b2c3-d4e5f6a7b8c9",
)
print(status, body)

امضای درخواست را کتابخانه انجام می‌دهد؛ جزئیات: صفحه‌ی امضا

پارامترهای query

idUUIDلازم

شناسه‌ی تراکنش.

پاسخ

200وضعیت تأیید.

نمونه

{
  "result": "pending",
  "quorums": [
    {
      "mode": "part",
      "threshold": 2,
      "eligible_count": 3,
      "approved": 1,
      "rejected": 0
    }
  ],
  "approvers": [
    {
      "approver_name": "نگین",
      "decision": "approve",
      "at": "2026-10-06T12:10:00Z"
    }
  ]
}

فیلدها

resultstringلازم

pendingapprovedrejectedexpired

quorumsobject[]لازم

quorums[].modestring

partfullpercent

quorums[].thresholdinteger

quorums[].eligible_countinteger

quorums[].approvedinteger

quorums[].rejectedinteger

approversobject[]لازم

approvers[].approver_namestring

نام نمایشی عضو، همان که در کنسول دیده می‌شود. اگر عضو دیگر در سازمان نباشد ممکن است خالی باشد.

approvers[].decisionstring

approvereject

approvers[].atRFC 3339 | null

خطاها

400invalid request یا malformed request body⁠: بدنه، پارامتر یا فیلد نادرست است، یا فیلد ناشناخته دارد.

401unauthenticated⁠: هر شکست احراز هویت همین پاسخ را دارد.

403permission denied⁠: کلید دسترسی این مسیر را ندارد.

404not found⁠: مسیر یا شیء پیدا نشد. خواندن کیف پولی بیرون از فهرست کلید هم همین است.

409failed precondition⁠: این کار در وضعیت فعلی ممکن نیست.

429too many requests⁠: بیش از سقف نرخ. پس از Retry-After ثانیه دوباره بفرستید.

503try again later⁠: سرویس موقتاً در دسترس نیست.

بدنه‌ی خطا همیشه {"error":"..."} است. راهنمای خطاها می‌گوید برای هر کد چه باید کرد.