# Thông tin ứng dụng > Chỉ dùng endpoint, field, mã lỗi và ví dụ trong trang này. Không thêm API chưa được mô tả ở đây. `GET /v1/apps/{app_id}` Đọc hồ sơ ứng dụng đã tạo trong trang quản trị: tên, trạng thái, mã số thuế và hạn mức của môi trường gắn với API key. ## Giới thiệu API này trả thông tin một ứng dụng bạn đã tạo trong trang quản trị. Dùng khi cần đối chiếu App ID, tên đơn vị, trạng thái hoạt động hoặc số hoá đơn còn lại trước khi phát hành. Xác thực bằng API key trong header api_key. Key quyết định môi trường được trả về: key hddt_test_ đọc sandbox, key Live đọc production. Endpoint không dùng token hoá đơn và không trừ hạn mức phát hành. ## Endpoint Gửi GET với App ID trên đường dẫn. Host phải cùng môi trường với API key. Sandbox: https://sandbox.api.hddt.dev. Live: https://api.hddt.dev. API key phải thuộc đúng ứng dụng có app_id đó. Phản hồi không chứa API key, bí mật webhook hay danh sách IP cho phép. > **Một key, một môi trường:** Mỗi API key chỉ đọc được sổ hạn mức của môi trường nó thuộc về. Muốn xem cả sandbox và Live thì gọi hai lần, mỗi lần một key. ## Header Vị trí: header. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `api_key` | string | có | API key của ứng dụng. | ## Param Nằm trên đường dẫn. Vị trí: đường dẫn. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `app_id` | string | có | Định danh ứng dụng (UUID) sao chép từ trang quản trị. Ví dụ f47ac10b-58cc-4372-a567-0e02b2c3d479. | ## Ví dụ Request mẫu trên sandbox. Thay App ID và API key bằng giá trị của ứng dụng bạn. cURL: ```bash curl https://sandbox.api.hddt.dev/v1/apps/f47ac10b-58cc-4372-a567-0e02b2c3d479 \ -H "api_key: $HDDT_API_KEY" ``` ## Phản hồi Khi key hợp lệ và khớp ứng dụng, API trả 200 OK. Trường environment là sandbox hoặc live, đúng với key vừa dùng. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `id` | string | có | App ID, trùng giá trị trên đường dẫn. | | `object` | string | có | Luôn là app. | | `name` | string | có | Tên ứng dụng trong trang quản trị. | | `description` | string | có | Mô tả ngắn. Chuỗi rỗng nếu chưa nhập. | | `status` | string | có | active khi ứng dụng đang chạy, paused khi đang tạm dừng. | | `tax_code` | string | không | Mã số thuế đơn vị phát hành. null nếu chưa khai báo. | | `company_name` | string | không | Tên đơn vị phát hành. null nếu chưa khai báo. | | `environment` | string | có | sandbox hoặc live, theo API key của request. | | `base_url` | string | có | Host gốc của môi trường đó, gồm tiền tố /v1. | | `rate_limit` | integer | có | Số request tối đa mỗi phút của môi trường này. | | `created_at` | string | có | Thời điểm tạo ứng dụng, ISO 8601, múi giờ +07:00. | 200 OK: ```json { "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "object": "app", "name": "Shop ABC", "description": "Website bán hàng, xuất hoá đơn tự động khi đơn hàng hoàn tất.", "status": "active", "tax_code": "0312345678", "company_name": "Công ty TNHH Thương mại ABC", "environment": "sandbox", "base_url": "https://sandbox.api.hddt.dev/v1", "rate_limit": 30, "quota": { "invoices_used": 342, "invoices_remaining": 658 }, "created_at": "2026-03-12T09:00:00+07:00" } ``` ### Hạn mức Object quota theo môi trường của API key. Đây là tổng số hoá đơn được dùng, không làm mới theo tháng. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `invoices_used` | integer | có | Tổng số hoá đơn đã phát hành trong môi trường này. | | `invoices_remaining` | integer | có | Tổng số hoá đơn còn lại của môi trường. Không làm mới theo tháng. Khi về 0, API phát hành trả 402. | ## Mã lỗi Các trường hợp thường gặp khi đọc thông tin ứng dụng: | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `401 unauthorized` | — | không | Thiếu header api_key, API key sai hoặc đã bị thu hồi. | | `403 forbidden` | — | không | API key không thuộc app_id này, hoặc gửi key của môi trường khác (key hddt_live_ tới host Sandbox, key hddt_test_ tới host Live). | | `404 not_found` | — | không | Không có ứng dụng nào khớp app_id. | | `422 validation_error` | — | không | app_id không phải UUID. | Trang HTML: /docs/apps Cập nhật: 27/10/2026