pages

Create and publish a page

Creates the organization's public page and publishes it immediately. The response carries slug and public_url — point a QR code at that public_url (POST /api/v1/codes) to get a printable card.

Repeating the call updates the SAME page with a new version instead of creating a second one, and never changes the slug, so an agent may retry safely and printed codes keep working. Content is sanitised server-side; a payload without a name or without any contact is refused with 422.

post/api/v1/pages

Request

  • Base URL: https://app.qrtap.kg
  • URL: https://app.qrtap.kg/api/v1/pages
  • Auth: HTTP bearer

Request body

Example request

{
  "content": {
    "kind": "profile",
    "segment": "otzyvy",
    "theme": "emerald",
    "name": "Кофейня «Тандем»",
    "specialty": "Спешелти-кофе в центре Бишкека",
    "bio": "",
    "phone": "+996555123456",
    "whatsapp": "https://wa.me/996555123456",
    "instagram": "https://instagram.com/tandem.coffee",
    "twogis": "",
    "bookingUrl": "",
    "services": [
      {
        "name": "Фильтр-кофе",
        "price": "180 сом"
      }
    ],
    "hours": "ежедневно 8:00–22:00",
    "address": "Бишкек, ул. Киевская 100",
    "reviewLinks": {
      "twogis": "https://2gis.kg/bishkek/firm/70000001"
    }
  }
}

Response

Page created (or a new version of the existing page) and published.

idstring uuid required
slugstring required

Public slug; stable for the life of the page.

titlestring

Page heading (mirrors content.name).

segmentstring
theme'emerald' | 'ocean' | 'plum' | 'terracotta' | 'graphite'
status'draft' | 'published' | 'archived' required
publishedboolean required

Convenience mirror of status === "published".

versioninteger required

Current content version (increments on every write).

public_urlstring uri required

Where the page is served: https://app.qrtap.kg/a/{slug}.

created_atstring date-time
updated_atstring date-time

When the current version was published.

Example response

{
  "id": "9d1c1f0a-2a3b-4c5d-8e9f-0a1b2c3d4e5f",
  "slug": "cozy-cafe-x1",
  "title": "Кофейня «Тандем»",
  "segment": "otzyvy",
  "theme": "emerald",
  "status": "published",
  "published": true,
  "version": 3,
  "public_url": "https://app.qrtap.kg/a/cozy-cafe-x1",
  "created_at": "2026-07-01T08:00:00.000Z",
  "updated_at": "2026-07-20T10:15:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.