# References (/references)



Read the implementations alongside this reference. A working client shows the session handling,
retry behaviour, and error handling that a schema cannot.

## Official [#official]

| Source                                                                       | Covers                                                                                                                   |
| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| [BUFF developer documentation](https://buff.163.com/developer/documentation) | BUFF's own reference for the official API. Authoritative for bearer-token authentication, access tiers, and rate limits. |
| [BUFF developer console](https://buff.163.com/developer)                     | Token issuance and access-tier management.                                                                               |

## Clients [#clients]

| Project                                                | Language | Why read it                                                                                     |
| ------------------------------------------------------ | -------- | ----------------------------------------------------------------------------------------------- |
| [buff163-api](https://github.com/eastblue/buff163-api) | Python   | Wraps the internal price routes and shows the cookie handling an anonymous caller cannot avoid. |
| [BuffApi](https://github.com/HandsomeAlex/BuffApi)     | Python   | Catalog and sell-order polling against the internal routes.                                     |

Community clients for the internal routes are thinner than for Steam, and most are unmaintained.
Verify the current response shape before relying on one.

## Machine-readable [#machine-readable]

| Document                                               | Contents                                                                                             |
| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| [`/openapi.json`](/openapi.json)                       | Combined document backing this reference: 30 official operations and four internal price operations. |
| [`/unofficial-openapi.json`](/unofficial-openapi.json) | The four internal price operations on their own.                                                     |
| [`/unofficial-routes.json`](/unofficial-routes.json)   | Route evidence for the internal operations.                                                          |

Internal routes are unofficial and can change without notice. Where this reference and the live API
disagree, the API is right.