Documentation de l'API ConvertCraft

Intégrer les capacités de conversion de fichiers de ConvertCraft dans vos applications via notre API REST. Traitez des images, des PDFs, de l’audio, du vidéo et du texte avec des requêtes HTTP simples.

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

Authentification

La plupart des endpoints sont publics et ne nécessitent pas d’authentification. Pour des limites de débit plus élevées ou des fonctionnalités avancées, abonnez-vous via RapidAPI pour recevoir une clé API.

Débuter (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

Catégories d’Endpoints

The API provides endpoints grouped by conversion type:

  • Traitement d’Images — Convert, resize, and optimize images (JPG, PNG, WebP, AVIF, HEIC, SVG, GIF, TIFF, BMP, ICO)
  • Outils PDF — Convert, merge, split, compress, and rasterize PDFs
  • Outils Audio — Convert between MP3, WAV, OGG, AAC, FLAC, M4A formats
  • Outils Vidéo — Convert MP4, WebM, MKV, MOV, AVI, extract audio from video
  • Outils de Texte — Slugify, hash, encode/decode, and other text operations
  • Outils Crypto — Hashing, encoding, and cryptographic utilities
  • Système — Health check, status, and API metadata

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

Limites de Rate

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

Les endpoints publics sont limités par IP. Les abonnés via RapidAPI bénéficient de limites plus élevées.

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.