QBuild for developers

Three integration paths: drop-in widget, JSON partner API, RSS feed. All read-only, served from aevion.tech.

1 · Drop-in widget

Render a styled list of your open vacancies on any HTML page. Zero framework deps, single <script> tag.

<div data-aevion-build
     data-key="qb_pk_..."
     data-limit="6"
     data-city="Astana"
     data-skill="welding"></div>
<script src="https://aevion.tech/api/build/public/widget.js" defer></script>
  • data-key — required, partner API key (mint at admin → partner keys)
  • data-limit — max vacancies to render, default 6
  • data-city / data-skill — server-side filters
  • data-vacancy-id — render exactly one role

2 · Partner JSON API

Same data the widget uses, exposed as JSON. Authenticated via X-Build-Key header. CORS allows any origin. Rate limit 60 req/min/key.

GET/api/build/public/v1/vacanciesPaginated feed of OPEN vacancies. Query: limit, offset, city, skill.
GET/api/build/public/v1/vacancies/:idSingle vacancy detail.
GET/api/build/public/v1/healthSanity check — returns { status: 'ok', apiVersion: 'v1' }.

Curl

curl https://aevion.tech/api/build/public/v1/vacancies?limit=10 \
  -H "X-Build-Key: qb_pk_..."

Response shape

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "...",
        "title": "Senior welder",
        "description": "...",
        "salary": 800000,
        "salaryCurrency": "RUB",
        "skills": ["welding", "blueprints"],
        "city": "Astana",
        "project": "Tower 7",
        "url": "https://aevion.tech/build/vacancy/...",
        "createdAt": "...",
        "expiresAt": "..."
      }
    ],
    "total": 1,
    "limit": 10,
    "offset": 0
  }
}

3 · RSS feed

Subscribe to the latest open vacancies in any RSS reader. No auth required.

https://aevion.tech/api/build/public/rss/vacancies.xml
https://aevion.tech/api/build/public/rss/vacancies.xml?city=Astana
https://aevion.tech/api/build/public/rss/vacancies.xml?skill=welding

4 · Sitemap

Standard XML sitemap covering all open vacancies, projects, top employers and product pages. 5 000 URLs cap. Refreshed automatically.

https://aevion.tech/sitemap.xml

Auth & limits

  • Mint a key at /build/admin/partner-keys. Plaintext shown ONCE.
  • Backend stores only sha256(key).
  • 60 requests/min per key (also per IP if missing).
  • Revoke instantly from the same admin page — revoked keys hard-fail with 401.
Need something else (webhooks, applicant push, multi-org)? Get in touch →