# Backslash Partners — API (agents)

Navigation index: https://backslash.co.kr/llms.txt · Full guide: https://backslash.co.kr/llms-full.txt

## Preferred base

`https://backslash.co.kr/api/v1`

Origin (same `/guest/*` resources): `https://ec2-15-165-221-95.ap-northeast-2.compute.amazonaws.com`

## Specs

- [OpenAPI JSON](https://backslash.co.kr/openapi.json)
- [OpenAPI YAML](https://backslash.co.kr/api/openapi.yaml)
- [Docs index JSON](https://backslash.co.kr/api/docs)
- [Health](https://backslash.co.kr/api/health)

## Operations

| operationId | Method | Path |
| --- | --- | --- |
| `guestPortfolioSearch` | GET | `/guest/portfolio` |
| `guestPortfolioGetByPublicId` | GET | `/guest/portfolio/{publicId}` |
| `guestPostSearch` | GET | `/guest/post` |
| `guestPostGetByPublicId` | GET | `/guest/post/{publicId}` |
| `guestInquiryCreate` | POST | `/guest/inquiry` |

Example: [GET /api/v1/guest/portfolio?limit=2](https://backslash.co.kr/api/v1/guest/portfolio?limit=2)

## Pagination (cursor)

List endpoints return `{ data, pagination }`:

```json
{
  "data": [ ... ],
  "pagination": {
    "limit": 20,
    "total": 42,
    "hasMore": true,
    "nextCursor": "...",
    "prevCursor": null
  }
}
```

- Preferred: `?limit=20`, then `?cursor={pagination.nextCursor}`
- Legacy: `?page=0&size=20` (when `cursor` is omitted)
- Defined in OpenAPI as `CursorPagination`, `GuestPortfolioCursorPage`, `GuestPostCursorPage`

## Versioning & deprecation

- URL path versioning: `/api/v1/` (breaking changes under `/api/v2/`)
- Response header: `API-Version: 1`
- Deprecated versions send `Deprecation` + `Sunset` (RFC 8594) for at least **90 days** before removal

## Rate limits

- Headers: `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` (+ `X-RateLimit-*`)
- HTTP **429** includes `Retry-After`
- Default window: **60 requests / minute / client** for `/api/v1/guest/*` (trust response headers)

## Auth

Guest endpoints are public (inquiry is write). Do not invent bearer tokens. Email contact@backslash.co.kr for admin access.

## Related

- [Docs agent notes](https://backslash.co.kr/docs/llms.txt)
- [HTML API docs](https://backslash.co.kr/docs)