Doanh nghiệp & Thuế entity-id/resolve/batch

Đối chiếu cả danh mục mã trong một lượt gọi, tối đa 500 mã

Thân yêu cầu gồm `scheme` (`isin`, `bic` hoặc `mic`) và `ids` (mảng mã). Trả về `results` dạng `mã => [mã pháp nhân, ...]`, kèm `unresolved` (đúng dạng nhưng chưa được ánh xạ), `invalid` (sai dạng, đã loại trước khi tra) và `edition` (ấn bản dữ liệu đang phục vụ). Endpoint này đọc bộ dữ liệu nội bộ nên nhanh và không giới hạn nhịp gọi, đổi lại chỉ trả mã pháp nhân chứ không kèm tên — cần tên thì gọi tiếp `GET api/entity-id/xref/{lei}`. Vượt 500 mã bị từ chối thay vì cắt bớt, vì cắt bớt im lặng khiến phần bị bỏ trông y hệt "không tìm thấy". Trả 503 `dataset_not_loaded` khi máy chủ chưa nạp bộ dữ liệu.

POST https://api-tools.hitechcloud.vn/api/entity-id/resolve/batch Đã chép

Cần khoá API

Tham số

scheme string · thân yêu cầu bắt buộc

Hệ mã cần tra: isin, bic hoặc mic.

ids string · thân yêu cầu bắt buộc

Mảng mã cần tra, tối đa 500 phần tử mỗi lượt.

Mã trả về

200 Thành công.

401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.

404 Không tìm thấy dữ liệu tương ứng.

429 Vượt hạn mức của khoá. Xem header Retry-After.

curl --location --request POST 'https://api-tools.hitechcloud.vn/api/entity-id/resolve/batch' \ --header 'X-API-Key: $HITECH_API_KEY' \ --header 'Accept: application/json' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'scheme=GIA_TRI' \ --data-urlencode 'ids=GIA_TRI'

$response = Http::withHeaders([ 'X-API-Key' => env('HITECH_API_KEY'), ])->post('https://api-tools.hitechcloud.vn/api/entity-id/resolve/batch', [ 'scheme' => 'GIA_TRI', 'ids' => 'GIA_TRI', ]); $data = $response->json();

const body = new URLSearchParams(); body.append('scheme', 'GIA_TRI'); body.append('ids', 'GIA_TRI'); const res = await fetch('https://api-tools.hitechcloud.vn/api/entity-id/resolve/batch', { method: 'POST', headers: { 'X-API-Key': process.env.HITECH_API_KEY, 'Content-Type': 'application/x-www-form-urlencoded', }, body, }); const data = await res.json();

import os, requests res = requests.post( "https://api-tools.hitechcloud.vn/api/entity-id/resolve/batch", headers={"X-API-Key": os.environ["HITECH_API_KEY"]}, data={ "scheme": "GIA_TRI", "ids": "GIA_TRI", }, ) data = res.json()