QR 코드 생성기 API

QR 코드 생성기 API를 사용하여 다양한 형식(PNG, SVG, EPS)과 스타일로 렌더링된 딥링크용 QR 코드를 생성할 수 있습니다. 딥링크 파라미터를 통해 링크 작동 방식을 정의하고, QR 코드 형태를 맞춤 설정할 수 있습니다.

시작에 앞서

QR 코드 생성기 API를 사용하기 전에 알아야 할 사항은 다음과 같습니다.

요구 사항

• 모든 딥링크 생성기 API 전제 조건은 QR 코드 생성기 API에도 적용됩니다.
• 링크 생성 페이로드 프로토콜을 사용하여 유효한 페이로드를 제공해야 합니다.

응답 헤더

각 성공적인 응답은 생성된 QR 코드 내에 암호화된 딥링크를 나타내는 헤더를 포함합니다.

X-QR-Code-URL: https://example.go.link/fryYl

QR 코드를 URI로 생성하기

이 엔드포인트를 사용하여 QR 코드를 생성하고, HTML <img> 태그에 직접 임베딩하기에 적합한 URI로 인코딩된 파일로 수신합니다. 처리량이 적어 즉각적인 다운로드 속도가 중요하지 않은 환경에 권장됩니다.

API 프로토콜

엔드포인트: https://automate.adjust.com/engage/qr-code/uri

호출하여 트래킹할 수 있습니다: POST

지원 형식: SVG, PNG, EPS

요청 본문:

응답: 파일 내용을 포함하는 text/plain 유형의 미가공(raw) 스팅(sting) 응답

QR 코드를 SVG로 생성하기

이 엔드포인트를 사용하여 SVG 형식의 QR 코드를 생성하여 인쇄나 웹 사용에 적합한 확장 가능하고 편집 가능한 결과물을 제공합니다.

API 프로토콜

엔드포인트: https://automate.adjust.com/engage/qr-code/svg

호출하여 트래킹할 수 있습니다: POST

지원 형식: SVG

요청 본문:

응답: 파일 내용을 포함하는 image/svg+xml 유형의 미가공(raw) 스팅(sting) 응답

QR 코드를 바이트 스트림으로 생성하기

이 엔드포인트를 사용하여 QR 코드를 바이너리 파일 스트림으로 생성할 수 있습니다. 빠른 액세스가 필요한 고부하 시스템에 이상적입니다. 예를 들어, 최적화된 전송을 위해 자체 CDN이나 스토리지에 파일을 저장할 때 좋습니다.

API 프로토콜

엔드포인트: https://automate.adjust.com/engage/qr-code/stream

호출하여 트래킹할 수 있습니다: POST

지원 형식: SVG, PNG, EPS

요청 본문:

응답: 바이트 스트림(예: 바이너리 PNG 또는 EPS 데이터)

예시

curl -o $HOME/Downloads/png_custom_test.png --location https://automate.adjust.com/engage/qr-code/stream \
--header 'Authorization: Bearer adjustApiToken' \
--header 'Content-Type: application/json' \
--data '{
  "data": {
    "link_token": "1k4hnyz7",
    "redirect": "https://youtu.be/AyOqGRjVtls",
    "fallback": "https://youtu.be/AyOqGRjVtls",
    "deeplink_path": "/custom-path"
  },
  "qr_code_params": {
    "file_type": "png",
    "error_correction": "quartile",
    "box_size": 12,
    "border": 2,
    "fill_color": "rgba(132, 51, 92, 0.74)",
    "back_color": "rgba(247, 108, 180, 0.8)",
    "style": {"name": "gapped", "size_ratio": "0.85"}
  }
}'

결과:

데이터 모델

QR 코드 파라미터

요청 본문 내에서 다음 구조 중 하나를 qr_code_params로 사용합니다.

스타일 파라미터