API ir kūrėjams

arvaidasrekis.lt — ištekliai kūrėjams

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

curl -X POST https://arvaidasrekis.lt/send-contact.php \
  -d "name=Vardenis" \
  -d "[email protected]" \
  -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 — 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
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.