Pārvaldi sludinājumus programmatiski

Divi veidi, abi ar vienādām tiesībām:

Personīgais tokens (bbk_…)

curl https://bezbaseina.lv/api/v1/me \
  -H "Authorization: Bearer bbk_xxxxxxxx_yyyy…"

Neapstrādāto tokenu parāda tikai vienreiz; glabājam tikai sha256. Atsaukšana ir tūlītēja.

Ierīces pieslēgšanās (CLI / asistenti)

Termināls sāk pieprasījumu, tu to apstiprini pārlūkā (/savienot), un tiek izsniegts tokens — bez paroles terminālī. To dara bezbaseina login.

ID ir necaurspīdīgi: ad_…, prop_…, lead_…, photo_…. Publiskie sludinājumi izmanto savu slug. Iekšējos datubāzes ID nekad neatklājam.

Publiski (bez konta)

Ar autentifikāciju

Trūkstoša tiesība → 403 forbidden_scope. Tiesības:

• ads:read — Skatīt tavus sludinājumus un īpašumus
• ads:write — Rediģēt sludinājumu tekstu un cenas
• ads:publish — Publicēt vai apturēt sludinājumus (ar apstiprinājumu)
• photos:write — Augšupielādēt un uzlabot fotoattēlus
• ai:assist — Lietot AI palīgu (teksts, cena, analīze)
• leads:read — Skatīt interesentu pieprasījumus
• leads:write — Atzīmēt un atbildēt interesentiem (ar apstiprinājumu)
• billing:read — Skatīt plāna un limitu stāvokli

Publicēšana, apturēšana, cenas maiņa un dzēšana ir divpakāpju, lai automatizēts rīks nekad neizmainītu tavus sludinājumus nejauši:

# 1. Piedāvā — atgriež 409 ar apstiprinājuma objektu (izmaiņu diff)
curl -X POST https://bezbaseina.lv/api/v1/ads/ad_123/publish -H "Authorization: Bearer $TOKEN"
# → 409 { "error": { "code": "confirmation_required",
#          "confirmation": { "id": "cnf_…", "diff": {…} } } }

# 2. Piemēro
curl -X POST https://bezbaseina.lv/api/v1/confirmations/cnf_… -H "Authorization: Bearer $TOKEN"
# → { "applied": true }

Apstiprinājumi ir idempotenti un beidzas pēc 30 min. Automatizācijai: sākotnējā pieprasījumā nosūti { "confirm": true } (CLI --yes), lai piedāvātu un piemērotu vienā solī.

npm install -g bezbaseina
# vai bez instalēšanas:
npx -y bezbaseina@latest login
bezbaseina login
bezbaseina ads list
bezbaseina ads create --title "…" --city riga --deal rent --price 375   # jauns sludinājums
bezbaseina ads update ad_123 --price 400 --title "…"                    # rediģē laukus
bezbaseina ads delete ad_123                                            # noņem (apstiprina)
bezbaseina ads analyse ad_123
bezbaseina ads suggest-price ad_123
bezbaseina ads publish ad_123        # parāda diff, prasa apstiprinājumu
bezbaseina photos upload prop_123 ./virtuve.jpg
bezbaseina photos reorder ad_123 photo_b photo_a   # pirmais = hero
bezbaseina photos delete photo_123
bezbaseina leads draft-reply lead_123

--json jebkurai komandai → neapstrādāts JSON skriptiem/aģentiem. --yes piemēro uzreiz. Kļūdas → ne-nulles izejas kods. Soli-pa-solim ceļvedis: /developers/guide.

Attālais serveris (ieteicams): https://bezbaseina.lv/mcp — Streamable HTTP, der claude.ai pielāgotajiem savienotājiem (custom connectors), ChatGPT aplikācijām, Claude Code un Codex. Bez konta pieejami publiskie lasīšanas rīki (sludinājumu meklēšana, viens sludinājums, tirgus statistika); pilnais īpašnieka komplekts: https://bezbaseina.lv/mcp/owner (OAuth 2.1 + PKCE, bez tokenu kopēšanas) vai Authorization: Bearer bbk_… galvene.

Lietotājiem draudzīgā pamācība ar ekrāna soļiem: /ai. OAuth metadati: https://bezbaseina.lv/.well-known/oauth-authorization-server.

Lokālais serveris (stdio) — tas pats rīku komplekts caur CLI:

bezbaseina mcp start

Piemērs Claude Code:

{ "mcpServers": { "bezbaseina": {
  "command": "npx", "args": ["-y", "bezbaseina@latest", "mcp", "start"],
  "env": { "BEZBASEINA_TOKEN": "bbk_…" } } } }

Asistents (ChatGPT/Claude/Codex) var izveidot, rediģēt, dzēst, kārtot foto, publicēt un mainīt cenu — bet riskantās darbības ir divpakāpju: rīks atgriež apstiprinājumu ar izmaiņu diff, un aģents to piemēro tikai ar confirm_action. Tā pati aizsardzība kā CLI/REST — tu (vai aģents) redzi izmaiņu, pirms tā notiek.

Patēriņu var redzēt GET /me. Norēķini top; pašlaik plānu iestata BezBaseina komanda.

• ✓Publiskais API neatklāj īpašnieka e-pastu/tālruni, precīzu adresi, iekšējos ID, interesentus, tokenus vai nepublicētus datus.
• ✓Piederība tiek pārbaudīta serverī — vari lasīt/mainīt tikai savus datus.
• ✓Riskantas darbības prasa skaidru, idempotentu apstiprinājumu.
• ✓AI neizdomā faktus, telpas vai ērtības un nekad pats nemaina cenu.
• ✓Foto uzlabošana nekad nepārraksta oriģinālu — tā veido jaunu attēlu, ko izvēlies pats.
• ✓Katra API/CLI/MCP darbība tiek ierakstīta tavā aktivitāšu žurnālā.

Jautājumi: hello@bezbaseina.lv