Autional Autional
API Reference GitHub autional.com →

POST /internal/secret/batch

Batch retrieve plaintext values of multiple secrets via internal API. Returns each secret's value or error; partial failures do not affect other secrets.

Secret Service - Internal API `ApiKeyAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
X-API-Key header string Yes Internal API key
X-Tenant-ID header string Yes Tenant ID

Request Body

Schema: gitee_com_linmes_authms_micro-services_secret-service_internal_handler_dto.BatchGetRequest

FieldTypeRequiredExampleConstraintsDescription
keys array of

string

Yes

Responses

StatusDescriptionSchema
200Batch get resultdto.DataResponse-gitee_com_linmes_authms_micro-services_secret-service_internal_handler_dto_BatchGetResponse
400Invalid request parametersdto.Problem
401Unauthorizeddto.Problem
500Internal server errordto.Problem

Referenced Schemas

dto.DataResponse-gitee_com_linmes_authms_micro-services_secret-service_internal_handler_dto_BatchGetResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data gitee_com_linmes_authms_micro-services_secret-service_internal_handler_dto.BatchGetResponse No
message string No
timestamp string No

dto.FieldViolation

FieldTypeRequiredExampleConstraintsDescription
code string No Code is the error code (optional). Used by programs to identify the error type, such as "required", "format", "range".
description string No Description is a human-readable error description. Should explain which rule was violated, e.g., "must be a valid email address".
field string No Field is the path to the error field. Use dot notation for nested fields, e.g., "user.email" or "addresses[0].city".
value object No Value is the value that caused the error (optional, used in development mode). May not be returned in production to avoid leaking sensitive information.

dto.Problem

FieldTypeRequiredExampleConstraintsDescription
code integer No Code is the business error code. Used by programs to handle specific error scenarios. Example: 30101001.
detail string No Detail is a human-readable explanation for this specific error instance. Can include specific error details, e.g., "Field 'email' is required".
errors array of

See dto.FieldViolation

No Errors is a list of field-level validation errors (extended field). Follows Web API standard practice; each error contains field name and error message.
i18n_args object No I18nArgs are internationalization parameters. Used to dynamically fill translation templates.
i18n_key string No I18nKey is the internationalization key. Used for client-side localization of error messages. Example: "error.user_not_found".
instance string No Instance is the specific URI reference where the problem occurred. Usually the request URL, may include query parameters. Example: "/api/v1/users?limit=invalid".
request_id string No RequestID is the unique request identifier. Used for log correlation and issue tracking. Example: "req_550e8400-e29b-41d4-a716-446655440000".
retry_after integer No RetryAfter is used for 429 Too Many Requests responses. Indicates how many seconds the client should wait before retrying (RFC 6585).
service string No Service is the service name. Used in microservice architectures to locate the error source. Example: "auth-service".
span_id string No SpanID is the current span identifier. Used to precisely locate the current node in a distributed trace.
status integer No Status is the generated HTTP status code. Used by clients to distinguish problem types; does not change with Accept-Language. Example: 400, 401, 403, 404, 500.
timestamp string No Timestamp is the time the error occurred. ISO 8601 format. Example: "2026-04-03T12:00:00Z".
title string No Title is a short, human-readable summary of the problem type. The same Type should always have the same Title (does not vary per instance). Example: "Invalid Request Parameters".
trace_id string No TraceID is the distributed trace identifier. Follows the W3C Trace Context standard. Example: "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01".
type string No Type is a URI reference that identifies the problem type. When dereferenced, it should provide human-readable documentation. Example: "https://api.example.com/errors/invalid-request".

gitee_com_linmes_authms_micro-services_secret-service_internal_handler_dto.BatchGetResponse

FieldTypeRequiredExampleConstraintsDescription
errors array of

See gitee_com_linmes_authms_micro-services_secret-service_internal_handler_dto.SecretErrorResponse

No
values array of

See gitee_com_linmes_authms_micro-services_secret-service_internal_handler_dto.SecretValueResponse

No

gitee_com_linmes_authms_micro-services_secret-service_internal_handler_dto.SecretErrorResponse

FieldTypeRequiredExampleConstraintsDescription
error string No secret not found
key string No missing.secret

gitee_com_linmes_authms_micro-services_secret-service_internal_handler_dto.SecretValueResponse

FieldTypeRequiredExampleConstraintsDescription
encoding string No utf-8
key string No jwt_secret
status string No active
value string No my-secret-value
version integer No 1