# Developers

The Sma Das API at https://sma-das.blog/api/v1 lists, fetches, and searches public research on sma-das.blog.

GET is public. An API key is optional identity. Agents that want a bearer token follow [auth.md](https://sma-das.blog/auth.md).

## Quickstart

```
curl https://sma-das.blog/api/v1/posts
curl "https://sma-das.blog/api/v1/search?q=enginered"
curl https://sma-das.blog/api/v1/posts/enginered-asymmetric-ai-warfare
```

## API keys

POST https://sma-das.blog/api/v1/keys with an optional JSON or form field `label`. Send the returned key as `Authorization: Bearer sdr_live_...`. Invalid tokens receive HTTP 401 with `WWW-Authenticate: Bearer resource_metadata="https://sma-das.blog/.well-known/oauth-protected-resource"`.

## Sandbox

The HTML portal at [https://sma-das.blog/developers](https://sma-das.blog/developers) includes a live search form against GET /api/v1/search.

## Endpoints

- GET /api/v1
- GET /api/v1/posts
- GET /api/v1/posts/{slug}
- GET /api/v1/search?q=
- POST /api/v1/keys

OpenAPI: [https://sma-das.blog/openapi.json](https://sma-das.blog/openapi.json).