GET /v1/keys
Lấy JWKS Ed25519 hiện tại
Không cần shield_key — công khai theo thiết kế (docs/đối tác fetch endpoint này không cần xác thực). Một shield_key hợp lệ tùy chọn sẽ gán lần fetch đó cho key đó chỉ để theo dõi go-live; một key thiếu/không hợp lệ vẫn được phục vụ JWKS, không tính. URL chuẩn: https://keys.vkl-shield.com/v1/keys (live) / https://keys.vkl-shield.com/sandbox/v1/keys (sandbox) — không bao giờ là một shield/park host. Cache-Control: public, max-age=600; tuân theo nó và loại bỏ các kid vắng mặt từ một lần fetch mới. Fail closed (503 SIGNING_UNAVAILABLE, no-store) thay vì bao giờ phục vụ một tập key rỗng/không đáng tin.
Tham số
| tên | vị trí | kiểu | mô tả | |
|---|---|---|---|---|
shield_key | query | string | tùy chọn | tùy chọn — gán lần fetch cho mục đích theo dõi go-live, không bao giờ dùng để chặn truy cập |
Phản hồi
304
không thay đổi (If-None-Match khớp ETag hiện tại)
503
SIGNING_UNAVAILABLE | SHIELD_REGISTRY_UNAVAILABLE | SHIELD_REGISTRY_STALE | SHIELD_ENV_MISCONFIGURED — fail-closed, không bao giờ phục vụ một tập key rỗng/sai (hình dạng V1Error)
V1Error