codes

Create a batch of codes (max 500)

Creates up to 500 codes in one call. Results are per-item: one bad item does not fail the batch. Idempotent by external_ref, so the whole call is safe to retry.

post/api/v1/codes/bulk

Request

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

Request body

target_urlstring uri required

Destination URL the code redirects to. http(s) only. Can be changed later without reprinting.

labelstring

Human-readable title shown in the cabinet. Defaults to "Код".

external_refstring

Your identifier for this code (partner id, SKU, event id). Unique per organization among non-archived codes; creation is idempotent by this field.

group'partner' | 'equipment' | 'event_menu' | 'bag_insert' | 'training'

Code type used to slice analytics.

design_template_idstring uuid

Apply a branded design template (must belong to your organization).

Response

Per-item results.

createdinteger required

Number of items with ok=true.

failedinteger required

Number of items with ok=false.

reusedinteger required

Сколько кодов вернулось по совпавшему external_ref вместо создания. Повторный прогон пачки даёт created=0 и reused=N.

Changes

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