ConvertCraft API ドキュメント

認証

ほとんどのエンドポイントは公開されており、認証は不要です。より高いレート制限や高度な機能が必要な場合は、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アドレスあたりに制限されます。RapidAPIのサブスクライバーは、より高い制限を受けます。

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.