# Bonus Hediye API

Public read-only content API for agents and integrators.

## Base URL

`https://bonushediye.online`

## Endpoints

| Method | Path | Auth | Description |
|--------|------|------|-------------|
| GET | `/api/health` | none | Liveness |
| GET | `/api/sites` | none | Sponsor/bonus summary cards (`?tier=`) |
| GET | `/api/guides` | none | Editorial guide index |
| GET | `/openapi.json` | none | OpenAPI 3.1 |

## Discovery

- API catalog: `/.well-known/api-catalog`
- Auth (public): [`/auth.md`](https://bonushediye.online/auth.md)
- Skills: `/.well-known/agent-skills/index.json`
- MCP card: `/.well-known/mcp/server-card.json`

## Envelope

```json
{ "success": true, "data": {}, "error": null }
```

## Disclosure

Outbound site links may be affiliate/advertising links. See [metodoloji](https://bonushediye.online/metodoloji/).