# arvaidasrekis.lt — developer resources

Viešosios programinės sąsajos ir mašininio skaitomo turinio šaltiniai.

## Kontaktų užklausų API

- Endpoint'as: `POST https://arvaidasrekis.lt/send-contact.php`
- Schema (OpenAPI 3.1): `https://arvaidasrekis.lt/openapi.json`
- operationId: `sendContactMessage`
- Formatas: `application/x-www-form-urlencoded`; atsakymai JSON `{ok, message}`
- Būsenos kodai: `200` sėkmė · `405` ne POST · `422` validacija · `429` per daug užklausų · `500` serverio klaida
- Privalomas vartotojo sutikimas: `rules_consent=1` (BDAR, niekada nepažymima automatiškai)
- Taisyklės: `https://arvaidasrekis.lt/uzklausos-taisykles.md`

### Pavyzdys

```bash
curl -X POST https://arvaidasrekis.lt/send-contact.php \
  -d "name=Vardenis" \
  -d "email=vardenis@example.com" \
  -d "message=Sveiki, norėčiau svetainės pasiūlymo." \
  -d "lang=lt" \
  -d "rules_consent=1"
```

### Dažnumo ribojimas

5 užklausos per valandą iš vieno IP. Atsakyme grąžinamos RFC antraštės:
`RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset`; peržengus ribą —
`429` su `Retry-After`.

## Mašininis turinys

- `llms.txt`: `https://arvaidasrekis.lt/llms.txt` — svetainės žemėlapis agentams su „kada naudoti“ gairėmis
- Markdown turinio derėjimas: GET `https://arvaidasrekis.lt/` su antrašte `Accept: text/markdown` grąžina puslapio markdown variantą (`Vary: Accept`)
- Sitemap: `https://arvaidasrekis.lt/sitemap.xml`
- robots.txt: `https://arvaidasrekis.lt/robots.txt` (visi AI crawleriai leidžiami)

## Autentifikacija

Vieša API autentifikacijos nenaudoja. Mokėjimų bei administravimo API
(`/mokejimai-api.php`) yra privati, tokenais apsaugota ir viešai
nedokumentuojama.