Izstrādātājiem · Ceļvedis

Izveido savu pirmo sludinājumu

No nulles līdz publicētam sludinājumam ar foto — piecos soļos. Katrs solis parādīts trīs veidos: tīrs REST (curl), CLI (bezbaseina) un AI asistents (ChatGPT/Claude/Codex caur MCP). Izvēlies vienu — visi izmanto vienus galapunktus. Pilnā atsauce: /developers.

Atsauce (/developers) ↗OpenAPI ↗Capabilities ↗

Pieslēdzies (Pro plāns)

Programmatiskai pieejai vajadzīgs Pro plāns. Divi veidi, kā iegūt tokenu:

CLI (ieteicams)

npm install -g bezbaseina        # vai: npx -y bezbaseina@latest <cmd>
bezbaseina login                 # apstiprini pārlūkā — bez paroles terminālī
bezbaseina whoami                # Konts, plāns, atlikušie limiti

Tokens tieši (curl / CI / aģenti)

Izveido personīgo tokenu panelī un liec to vidē:

export BB_TOKEN="bbk_xxxxxxxx_yyyy…"
curl https://bezbaseina.lv/api/v1/me -H "Authorization: Bearer $BB_TOKEN"

Neapstrādāto tokenu parāda tikai vienreiz (glabājam sha256). Aģentam nodod to kā BEZBASEINA_TOKEN.

Izveido sludinājumu

Obligāti: title, city (pilsētas slug, piem. riga), deal_type (rent · sale · nightly) un price_eur. Kontakts pēc noklusējuma — tavs konts. Uz Pro tas publicējas uzreiz un atgriež ad_… rokturi.

RESTcurl

curl -X POST https://bezbaseina.lv/api/v1/ads \
  -H "Authorization: Bearer $BB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Gaišs 3 istabu dzīvoklis Torņakalnā",
    "city": "riga", "deal_type": "rent", "price_eur": 375,
    "rooms": 3, "district": "Torņakalns",
    "amenities": ["wifi","stavvieta","kluss"],
    "description": "2. stāvā, autonoma gāzes apkure, daļēji mēbelēts.",
    "photo_urls": ["https://.../1.jpg","https://.../2.jpg"]
  }'
# → 201 { "ad": { "id": "ad_…", "status": "active", "url": "…/majoklis/…" } }

CLIbezbaseina

bezbaseina ads create \
  --title "Gaišs 3 istabu dzīvoklis Torņakalnā" \
  --city riga --deal rent --price 375 --rooms 3 --district "Torņakalns" \
  --amenities wifi,stavvieta,kluss \
  --description-file ./apraksts.txt \
  --photo-urls "https://.../1.jpg,https://.../2.jpg"
# → ✓ Izveidots: https://bezbaseina.lv/majoklis/…

AI asistentsdabiskā valodā

# Pieslēdz MCP (skat. 5. soli), tad vienkārši palūdz:
"Izveido īres sludinājumu Rīgā, Torņakalnā — 3 istabas, 375 €/mēn,
 ar wifi un stāvvietu, un pievieno šos foto: <urls>."
# → asistents izsauc MCP rīku create_ad ar tiem pašiem laukiem.

Foto var nodot kā photo_urls (jau mitināti) vai augšupielādēt failus atsevišķi (3. solis). Lauki: kind, season, size_m2, floor, total_floors, building_era, latitude/longitude, building_code/parcel_code.

Pievieno foto no faila

Ja neizmanto photo_urls, augšupielādē failus uz īpašumu (prop_… rokturis ir ad.property_id). Pirmais foto kļūst par galveno (hero).

RESTcurl

curl -X POST https://bezbaseina.lv/api/v1/photos/upload \
  -H "Authorization: Bearer $BB_TOKEN" \
  -F "property_id=prop_…" \
  -F "file=@./virtuve.jpg"
# → 201 { "photo_id": "photo_…", "url": "/api/img/…" }

CLIbezbaseina

bezbaseina photos upload prop_… ./virtuve.jpg
bezbaseina photos enhance photo_…     # drošs uzlabojums, oriģināls paliek

AI asistentsdabiskā valodā

"Pievieno šo virtuves foto sludinājumam un uzlabo to."
# → MCP rīki: (augšupielāde caur CLI/REST) + enhance_photo.

Rediģē, sakārto, publicē

Rediģēšana ir daļēja — sūti tikai tos laukus, ko maini. Foto secību iestata ar rokturu sarakstu (skati tos ar ads get). Publicēšana/apturēšana/dzēšana ir divpakāpju (apstiprinājums).

RESTcurl

# rediģē cenu + virsrakstu
curl -X PATCH https://bezbaseina.lv/api/v1/ads/ad_… \
  -H "Authorization: Bearer $BB_TOKEN" -H "Content-Type: application/json" \
  -d '{ "price_eur": 400, "title": "..." }'

# foto secība (pirmais = hero)
curl -X POST https://bezbaseina.lv/api/v1/ads/ad_…/photos-order \
  -H "Authorization: Bearer $BB_TOKEN" -H "Content-Type: application/json" \
  -d '{ "photo_ids": ["photo_b","photo_a","photo_c"] }'

# noņem no publiskā (arhivē) — apstiprini vienā solī
curl -X DELETE https://bezbaseina.lv/api/v1/ads/ad_… \
  -H "Authorization: Bearer $BB_TOKEN" -H "Content-Type: application/json" \
  -d '{ "confirm": true }'

CLIbezbaseina

bezbaseina ads get ad_…                 # rāda foto rokturus
bezbaseina ads update ad_… --price 400 --title "..."
bezbaseina photos reorder ad_… photo_b photo_a photo_c
bezbaseina ads pause ad_…                # parāda diff, prasa apstiprinājumu
bezbaseina ads delete ad_… --yes        # apstiprina uzreiz

AI asistentsdabiskā valodā

"Nomaini cenu uz 400 €, uztaisi pagalma foto par galveno un
 apturi sludinājumu." → asistents piedāvā izmaiņu (diff), tu apstiprini,
 tad tas izsauc confirm_action.

Pieslēdz AI asistentu (MCP)

Viena komanda dod ChatGPT/Claude/Codex/Antigravity pilnu rīku komplektu — meklēt, izveidot, rediģēt, kārtot foto, publicēt un sekot interesentiem. Riskantās darbības paliek aiz apstiprinājuma (confirm_action).

# terminālī (tokens no BEZBASEINA_TOKEN vai bezbaseina login):
bezbaseina mcp start

Claude Code / jebkurš MCP klients:

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

Rīki: create_ad, update_ad, delete_ad, reorder_photos, delete_photo, publish_ad, pause_ad, change_ad_price, confirm_action, plus lasīšana un AI palīgi.

Tālāk

· Pilnais galapunktu, tiesību un plānu saraksts: /developers
· Mašīnlasāmi: OpenAPI · capabilities · llms.txt
· Jautājumi: hello@bezbaseina.lv

Izveido savu pirmo sludinājumu

Pieslēdzies (Pro plāns)

Programmatiskai pieejai vajadzīgs Pro plāns. Divi veidi, kā iegūt tokenu:

CLI (ieteicams)

npm install -g bezbaseina        # vai: npx -y bezbaseina@latest <cmd>
bezbaseina login                 # apstiprini pārlūkā — bez paroles terminālī
bezbaseina whoami                # Konts, plāns, atlikušie limiti

Tokens tieši (curl / CI / aģenti)

Izveido personīgo tokenu panelī un liec to vidē:

export BB_TOKEN="bbk_xxxxxxxx_yyyy…"
curl https://bezbaseina.lv/api/v1/me -H "Authorization: Bearer $BB_TOKEN"

Neapstrādāto tokenu parāda tikai vienreiz (glabājam sha256). Aģentam nodod to kā BEZBASEINA_TOKEN.

Izveido sludinājumu

RESTcurl

curl -X POST https://bezbaseina.lv/api/v1/ads \
  -H "Authorization: Bearer $BB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Gaišs 3 istabu dzīvoklis Torņakalnā",
    "city": "riga", "deal_type": "rent", "price_eur": 375,
    "rooms": 3, "district": "Torņakalns",
    "amenities": ["wifi","stavvieta","kluss"],
    "description": "2. stāvā, autonoma gāzes apkure, daļēji mēbelēts.",
    "photo_urls": ["https://.../1.jpg","https://.../2.jpg"]
  }'
# → 201 { "ad": { "id": "ad_…", "status": "active", "url": "…/majoklis/…" } }

CLIbezbaseina

bezbaseina ads create \
  --title "Gaišs 3 istabu dzīvoklis Torņakalnā" \
  --city riga --deal rent --price 375 --rooms 3 --district "Torņakalns" \
  --amenities wifi,stavvieta,kluss \
  --description-file ./apraksts.txt \
  --photo-urls "https://.../1.jpg,https://.../2.jpg"
# → ✓ Izveidots: https://bezbaseina.lv/majoklis/…

AI asistentsdabiskā valodā

# Pieslēdz MCP (skat. 5. soli), tad vienkārši palūdz:
"Izveido īres sludinājumu Rīgā, Torņakalnā — 3 istabas, 375 €/mēn,
 ar wifi un stāvvietu, un pievieno šos foto: <urls>."
# → asistents izsauc MCP rīku create_ad ar tiem pašiem laukiem.

Pievieno foto no faila

Ja neizmanto photo_urls, augšupielādē failus uz īpašumu (prop_… rokturis ir ad.property_id). Pirmais foto kļūst par galveno (hero).

RESTcurl

curl -X POST https://bezbaseina.lv/api/v1/photos/upload \
  -H "Authorization: Bearer $BB_TOKEN" \
  -F "property_id=prop_…" \
  -F "file=@./virtuve.jpg"
# → 201 { "photo_id": "photo_…", "url": "/api/img/…" }

CLIbezbaseina

bezbaseina photos upload prop_… ./virtuve.jpg
bezbaseina photos enhance photo_…     # drošs uzlabojums, oriģināls paliek

AI asistentsdabiskā valodā

"Pievieno šo virtuves foto sludinājumam un uzlabo to."
# → MCP rīki: (augšupielāde caur CLI/REST) + enhance_photo.

Rediģē, sakārto, publicē

RESTcurl

# rediģē cenu + virsrakstu
curl -X PATCH https://bezbaseina.lv/api/v1/ads/ad_… \
  -H "Authorization: Bearer $BB_TOKEN" -H "Content-Type: application/json" \
  -d '{ "price_eur": 400, "title": "..." }'

# foto secība (pirmais = hero)
curl -X POST https://bezbaseina.lv/api/v1/ads/ad_…/photos-order \
  -H "Authorization: Bearer $BB_TOKEN" -H "Content-Type: application/json" \
  -d '{ "photo_ids": ["photo_b","photo_a","photo_c"] }'

# noņem no publiskā (arhivē) — apstiprini vienā solī
curl -X DELETE https://bezbaseina.lv/api/v1/ads/ad_… \
  -H "Authorization: Bearer $BB_TOKEN" -H "Content-Type: application/json" \
  -d '{ "confirm": true }'

CLIbezbaseina

bezbaseina ads get ad_…                 # rāda foto rokturus
bezbaseina ads update ad_… --price 400 --title "..."
bezbaseina photos reorder ad_… photo_b photo_a photo_c
bezbaseina ads pause ad_…                # parāda diff, prasa apstiprinājumu
bezbaseina ads delete ad_… --yes        # apstiprina uzreiz

AI asistentsdabiskā valodā

"Nomaini cenu uz 400 €, uztaisi pagalma foto par galveno un
 apturi sludinājumu." → asistents piedāvā izmaiņu (diff), tu apstiprini,
 tad tas izsauc confirm_action.

Pieslēdz AI asistentu (MCP)

# terminālī (tokens no BEZBASEINA_TOKEN vai bezbaseina login):
bezbaseina mcp start

Claude Code / jebkurš MCP klients:

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

Rīki: create_ad, update_ad, delete_ad, reorder_photos, delete_photo, publish_ad, pause_ad, change_ad_price, confirm_action, plus lasīšana un AI palīgi.

Tālāk

· Pilnais galapunktu, tiesību un plānu saraksts: /developers
· Mašīnlasāmi: OpenAPI · capabilities · llms.txt
· Jautājumi: hello@bezbaseina.lv