ConvertCraft API 문서

ConvertCraft 파일 변환 기능을 앱에 직접 연결하기 위해 REST API를 통해 간단한 HTTP 요청을 통해 처리합니다. 이미지, PDF, 오디오, 비디오, 텍스트를 처리하기 위해 간단하게 HTTP 요청을 수행합니다.

Base URL: https://api.convert-craft.com
OpenAPI spec: /openapi.yaml
RapidAPI: Subscribe on RapidAPI — the fastest way to get started.
Need help? Join our Discord

인증

대부분의 엔드포인트는 공개이며 인증이 필요하지 않습니다. 더 높은 트래픽 제한 또는 고급 기능을 위해 RapidAPI를 통해 API 키를 받으세요.

시작하기 (RapidAPI)

Subscribe on RapidAPI and use RapidAPI's built-in code snippets. The examples below are copy/paste templates — replace YOUR_API_KEY and YOUR_PROXY_SECRET with the values shown in RapidAPI.

1) Health check (GET /status)

curl -s \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-rapidapi-proxy-secret: YOUR_PROXY_SECRET" \
  https://api.convert-craft.com/status

2) Simple JSON tool (POST /slugify)

curl -s -X POST \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-rapidapi-proxy-secret: YOUR_PROXY_SECRET" \
  -d '{"text":"Hello World!"}' \
  https://api.convert-craft.com/slugify

3) File tool example (POST /image-convert)

File endpoints download from the sourceUrl field. Use a direct URL that returns HTTP 200 (this API intentionally does not follow redirects).

curl -s -X POST \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-rapidapi-proxy-secret: YOUR_PROXY_SECRET" \
  -d '{"sourceUrl":"https://example.com/photo.png","outputFormat":"webp"}' \
  https://api.convert-craft.com/image-convert \
  --output photo.webp

엔드포인트 카테고리

The API provides endpoints grouped by conversion type:

이미지 처리 — Convert, resize, and optimize images (JPG, PNG, WebP, AVIF, HEIC, SVG, GIF, TIFF, BMP, ICO)
PDF 도구 — Convert, merge, split, compress, and rasterize PDFs
오디오 도구 — Convert between MP3, WAV, OGG, AAC, FLAC, M4A formats
비디오 도구 — Convert MP4, WebM, MKV, MOV, AVI, extract audio from video
텍스트 도구 — Slugify, hash, encode/decode, and other text operations
암호화폐 도구 — Hashing, encoding, and cryptographic utilities
시스템 — Health check, status, and API metadata

For the full list of endpoints with request/response schemas, see the OpenAPI spec.

레벨 제한

Free tier: 10 requests per minute
Pro tier: 100 requests per minute
Enterprise: Custom limits available on request

공개 엔드포인트는 IP당 제한됩니다. 급속API 구독자는 더 높은 제한을 받습니다.

Error Handling

All errors return JSON with a consistent structure:

{
  "error": "short_code",
  "message": "Human-readable description"
}

Common HTTP status codes:

400 — Bad request (missing or invalid parameters)
401 — Unauthorized (missing or invalid API key)
403 — Forbidden (invalid proxy secret or insufficient permissions)
429 — Rate limit exceeded
500 — Internal server error

Support

For API questions, bug reports, or feature requests, email [email protected] or join our Discord community.