Tác vụ

Tác vụ bất đồng bộ (nhập, xuất, đồng bộ): theo dõi tiến độ và kết quả.

Endpoint

Method	Path	Tóm tắt	Quyền	Nhóm tốc độ	Tương tác
GET	/v1/jobs/{id}	Trạng thái tác vụ bất đồng bộ	Mọi khoá hợp lệ	read	Scalar

Chi tiết endpoint

GET /v1/jobs/{id}

Trạng thái tác vụ bất đồng bộ

Theo dõi nhập sao kê, xuất, đồng bộ… Khi state là queued hoặc running phản hồi có Retry-After (giây) cho lần hỏi kế. Tác vụ của người khác hoặc ngoài phạm vi trả 404 resource_not_found.

Quyền: Mọi khoá hợp lệ

• Nhóm tốc độ: read
• Phản hồi thành công 200: Tác vụ. — Job, application/json
• Mã lỗi riêng của endpoint: resource_not_found

Tham số

Tên	Vị trí	Bắt buộc	Kiểu	Mô tả
id	path	Có	JobId	Mã tác vụ bất đồng bộ (job_…).

curl

curl -sS -X GET "https://api.dongtien.pro/v1/jobs/$ID" \
  -H "Authorization: Bearer $DT_API_KEY"

TypeScript

import { createClient } from "@dongtien/sdk";

const dt = createClient({ apiKey: process.env.DT_API_KEY! });

const { data } = await dt.GET("/v1/jobs/{id}", {
  params: {
    path: { "id": "job_0f5k2m9q4h7t3n8r6v1w0x5yz0" },
  },
});

Python

import os

from dongtien import DongTien
from dongtien_api.api.tac_vu import get_job

with DongTien(api_key=os.environ["DT_API_KEY"]) as dt:
    result = get_job.sync(id="job_0f5k2m9q4h7t3n8r6v1w0x5yz0", client=dt.client)

Mở trong tài liệu tương tác

Đối tượng

Job

Trường	Kiểu	Bắt buộc	Mô tả
created_at	Timestamp	Có	—
error	JobError	Không	—
error.code	ErrorCode	Có	Giá trị: unauthenticated, invalid_api_key, api_key_expired, api_key_revoked, ip_not_allowed, permission_denied, scope_not_allowed, step_up_required, two_factor_required, hoadon_key_insufficient_scope, approver_same_as_maker, resource_not_found, account_scope_denied, impersonation_forbidden, staff_mfa_required, flag_approval_required, tenant_suspended, bad_request, invalid_json, validation_failed, invalid_cursor, unsupported_version, method_not_allowed, payload_too_large, unsupported_media_type, conflict, raw_expired, too_many_accounts, idempotency_key_required, idempotency_key_reused, idempotency_in_flight, rate_limited, quota_exceeded, spend_cap_reached, tx_not_verified, period_locked, balance_mismatch, memo_pattern_invalid, memo_pattern_in_use, account_alias_ambiguous, allocation_exceeds_tx, invoice_over_allocated, no_eligible_checker, retryable, upgrade_required, service_unavailable, hoadon_unavailable, internal_error, ai_not_enabled, ai_paused, ai_task_unassigned, key_required, forecast_unavailable.
error.detail	string	Không	—
finished_at	Timestamp | null	Có	—
id	JobId	Có	—
kind	JobKind	Có	—
object	string	Có	Giá trị: job.
progress	JobProgress	Có	—
progress.done	integer	Có	—
progress.message	string	Không	—
progress.total	integer | null	Có	null khi chưa biết tổng.
progress.unit	string	Không	Đơn vị đếm, vd. rows, transactions.
result	map<string, any>	Không	Kết quả khi succeeded (cấu trúc tuỳ kind).
state	JobState	Có	Giá trị: queued, running, succeeded, failed, cancelled.