보따리
Docs

Botari Docs

보따리앱 제작 AI를 위한 공개 문서입니다.

API Guide

JSON 스토리지, 휴대폰 소유자 인증, QR/바코드, OCR, 게임/앱 API 스키마.

API Guide 열기

AI API Quick Reference

AI 앱 제작자가 먼저 읽는 전체 기능 인덱스입니다. 게임 순위, 저장소, OCR, 문서 생성, QR/바코드, SMS, 위치 API를 한 번에 확인합니다.

AI API 열기

마이페이지 AI 편집

내 AI로 수정하기에서 발급되는 10분 Bearer 토큰과 마이페이지 JSON/CSS 저장 API를 확인합니다.

마이페이지 AI 문서 보기

게임 순위 API

recordPlay, submitScore, getRankings, my-best-score를 확인합니다.

게임 API 보기

JSON 스토리지

작은 앱 DB. BotariSDK.setStorage/getStorage/listStorage/deleteStorage를 사용합니다.

스키마 보기

휴대폰 소유자 인증

가입 없이 허용된 앱에서 문자 수신 가능 여부를 확인합니다. 본인/실명/성인 인증이 아닙니다.

스키마 보기

OCR 이미지 텍스트 추출

이미지 속 글자를 PaddleOCR로 추출합니다. BotariSDK.extractTextFromImage를 사용합니다.

OCR API 보기

보따리앱 ZIP 제한

보따리앱 ZIP은 원본 30MB, 내부 단일 파일 10MB, 압축 해제 총량 30MB입니다. 5MB는 ZIP 한도가 아닙니다.

제한 보기

AI/앱 제작자 원칙

보따리앱 안에서는 REST 후보를 자동 탐색하지 말고 공식 BotariSDK 메서드를 우선 사용합니다.

초기 화면은 저장소 응답을 기다리지 말고 먼저 렌더링합니다. getStorage()listStorage()는 복원 실패 시 unavailable: true가 붙은 빈 응답을 반환할 수 있으므로, 저장된 데이터 없음처럼 안전하게 처리합니다.

await BotariSDK.setStorage("menu", { categories: [] });
const saved = await BotariSDK.getStorage("menu");

await BotariSDK.sendSmsCode({ phone: "01012345678", purpose: "condolence_message" });
const result = await BotariSDK.verifySmsCode({ phone: "01012345678", code: "123456", purpose: "condolence_message" });

const ocr = await BotariSDK.extractTextFromImage({ image_base64: imageBase64, mime: "image/png" });