Skip to content
PuzzleGenio - 무료 퍼즐 제작 도구
PuzzleGenio

직소 퍼즐 API 참고 자료

직소 퍼즐: 이 문서는 API와 공통인 등록 정보와 입력 계약에서 모드, 페이지별 설정, 형식, 필드를 읽습니다.

API 키

요청 예시

curl -X POST https://puzzlegenio.com/api/v1/puzzles \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: task-000000000001' \
  -H 'Content-Type: application/json' \
  -d '{ "type": "jigsaw", "title": "Mountain puzzle", "options": { "tilesX": 5, "tilesY": 5, "shape": "rectangle" } }'

모드

normal

페이지별 설정

브라우저 내보내기 형식

svg · pdf · png · dxf · zip · stl

내보내기 형식은 퍼즐 설정과 계정 요금제에 따라 달라집니다. viewUrl과 exportPageUrl은 브라우저에서 내려받는 페이지입니다. 응답에 PDF, PNG, STL 파일 데이터는 들어 있지 않습니다. 내보내기 권한은 공개할 때 확정하고 다시 공개할 때 재검사합니다.

공통 요청 필드

필드허용 값필수
preset문자열아니요
mode문자열아니요
locale다음 중 하나; en | zh | es | de | fr | pt | it | id | ja | ko아니요
contentLanguage다음 중 하나; en | zh | es | de | fr | pt | it | id | ja | ko아니요
title문자열예
retentionDays숫자; 정수아니요
appearance.lineColor문자열아니요
appearance.lineWidth숫자; 최소 0; 최대 20아니요
appearance.strokeOutline참/거짓아니요
appearance.outlineColor문자열아니요
appearance.outlineWidth숫자; 최소 0; 최대 10아니요
export.paperSize다음 중 하나; A3 | A4 | A4-landscape | A5 | B5 | Letter | Letter-landscape | Legal | Half-Letter | Tabloid | custom아니요
export.widthMm숫자; 최소 50; 최대 2000아니요
export.heightMm숫자; 최소 50; 최대 2000아니요
export.unit다음 중 하나; mm | cm | in | px아니요
export.quality다음 중 하나; standard | high | print아니요
export.thicknessMm숫자; 최소 1; 최대 10아니요
export.gapMm숫자; 최소 0.1; 최대 1아니요
input.imageAssetId문자열아니요
options.seed숫자; 정수; 최소 0; 최대 2147483647아니요
options.tilesX숫자; 정수; 최소 1; 최대 100아니요
options.tilesY숫자; 정수; 최소 1; 최대 100아니요
options.sizeX숫자; 최소 1; 최대 10000아니요
options.sizeY숫자; 최소 1; 최대 10000아니요
options.tabSize숫자; 최소 10; 최대 35아니요
options.jitter숫자; 최소 0; 최대 10아니요
options.cornerRadius숫자; 최소 0; 최대 100아니요
options.shape문자열; 최소 1; 최대 50아니요
options.hexRings숫자; 정수; 최소 1; 최대 20아니요

틀과 주제

현재 이용 가능한 틀의 식별자, 주제, 계정 한도는 /api/v1/capabilities에서 확인하세요. 틀로 만든 결과도 저장 공간 한 칸을 사용합니다.

이미지와 파일

이미지 입력에는 같은 계정에서 미리 올리거나 가져온 assetId를 씁니다. 내려받기는 브라우저의 결과 페이지에서 진행합니다. 결과 페이지 주소는 파일 직접 링크가 아닙니다.

실패 사례

알 수 없는 필드나 서로 맞지 않는 type, mode, preset 조합은 422를 반환합니다. 완성할 수 없는 입력도 422입니다. 사용 가능한 형식은 설정과 계정 권한에 따라 달라집니다.

직소 퍼즐 API 참고 자료