# Beladed Java API client

Beladed Developer Platform generates this dependency-free client from the reviewed public OpenAPI contract. It includes exactly 283 approved operations; an operation absent from that contract is intentionally unavailable.

## Release identity

- Client version: `0.1.0-beta.1`
- API version: `2026-07-11`
- Release channel: `beta`
- Release status: `official-docs-hosted-beta`
- Contract hash: `sha256:478f3385fbfb86f845f794fe3e71f4f6411059faab2ad4605087d4e219bc6377`
- Owner: Beladed Developer Platform
- Runtime: Java 17+
- Platforms: server
- Source: https://docs.beladed.com/sdks/2026-07-11/java/source/BeladedClient.java
- Distribution: https://docs.beladed.com/sdks/2026-07-11/java/beladed-java-0.1.0-beta.1.tar.gz
- Package registry: not published; the docs-hosted archive is authoritative

## Environments

- Development: `https://api.beladed.dev`
- Production: `https://api.beladed.com`

Select the environment when constructing the client. Generated clients accept only these two Beladed API hosts.

## Credential boundaries

| Credential contract | Header | Allowed execution context |
| --- | --- | --- |
| Public | none | server or client |
| Publishable key | `X-Beladed-Public-Key` | server or origin-restricted client |
| Secret key | `X-Beladed-API-Key` | server only |
| OAuth access token | `Authorization: Bearer` | server only |
| Authenticated session | `Authorization: Bearer` | server or client |

Credentials are never accepted in query parameters. This distribution is for trusted server runtimes. Do not bundle its credentials into public application code.

## Request shape

Every generated operation method accepts the same three inputs:

- `path`: values for documented `{parameter}` segments;
- `query`: non-credential query values;
- `body`: the documented JSON body, when present.

Use the operation reference at https://docs.beladed.com/api for schemas, account eligibility, platform eligibility, errors, and response contracts.

## Integrity

Verify the archive SHA-256 from https://docs.beladed.com/sdks/checksums.sha256 and the per-file hashes in `manifest.json`. The contract hash is computed from canonical JSON for the exact generated OpenAPI contract.

## Support, security, and deprecation

- Support: Beladed supports defects in generated clients against the documented public API contract. Beta releases may add compatible conveniences, while breaking changes require a new client or API version. https://docs.beladed.com/support
- Security: Report suspected vulnerabilities through Beladed Security. Never place secret keys or OAuth client credentials in browsers, extensions, or mobile applications. https://docs.beladed.com/security
- Deprecation: A deprecated client version remains documented for at least 180 days unless an actively exploited security issue requires earlier withdrawal. Security withdrawals are announced in release notes.
- Versioning: Client versions use semantic versioning. Every distribution also records the date-based Beladed API version and exact generated contract hash.

This beta distribution does not claim publication to npm, PyPI, Packagist, RubyGems, Maven Central, NuGet, Swift Package Index, or another package registry.