ข้ามไปยังเนื้อหาหลัก
TransConvert

PDF Conversion API

Turn a PDF into an editable DOCX, XLSX, or PPTX, or go the other way — Word/Excel/PowerPoint to PDF — with one POST request.

POST https://transconvert.com/api/v1/convert.php

พารามิเตอร์

Field Description
AuthorizationRequired. "Bearer tc_live_...".
categorySet to "document".
targetRequired. Output format code — "DOCX"/"XLSX"/"PPTX" when converting FROM a PDF, or "PDF" when converting a Word/Excel/PowerPoint file TO one.
fileRequired. The PDF (or the Word/Excel/PowerPoint file, when converting to PDF).

ตัวอย่าง

TransConvert
curl -X POST \
  https://transconvert.com/api/v1/convert.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=document" \
  -F "target=DOCX" \
  -F "file=@report.pdf" \
  -o output.docx

การตอบกลับ

สำเร็จ (200): ไบต์ดิบของไฟล์ที่แปลงแล้ว พร้อมส่วนหัว Content-Type และ Content-Disposition ที่ตั้งค่าให้ ล้มเหลว: เนื้อหา JSON รูปแบบ {"error": {"code": "...", "message": "..."}} พร้อมรหัสสถานะ HTTP ที่ตรงกัน — ดู Errors ด้านล่าง

Header Value
Content-Typeประเภท MIME จริงของไฟล์ที่แปลงแล้ว (เช่น image/png, application/pdf)
Content-Dispositionattachment; filename="..." — ชื่อไฟล์ที่แนะนำ เหมือนกับการดาวน์โหลดไฟล์ทั่วไป
Content-Lengthขนาดเนื้อหาการตอบกลับเป็นไบต์

ข้อผิดพลาดทุกแบบมีโครงสร้าง JSON เดียวกัน ตัวอย่างเช่นเมื่อเกินโควตา:

429 Too Many Requests
{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly API allowance of 5000 conversion-minutes reached.",
    "limit": 5000,
    "used": 5000
  }
}

ข้อผิดพลาด

ทุกความล้มเหลวจะส่งกลับเป็นซองข้อผิดพลาด JSON ที่มี "code" ให้โค้ดของคุณใช้แยกกรณีได้ พร้อม "message" ที่มนุษย์อ่านเข้าใจ บางข้อผิดพลาดมีฟิลด์เพิ่มเติม (เช่น quota_exceeded จะมี "limit" และ "used")

Status & code When it happens
401 missing_keyไม่มีการส่งส่วนหัว Authorization มา
401 invalid_keyคีย์นี้ไม่มีอยู่จริง หรือถูกเพิกถอนแล้ว
403 account_suspendedบัญชีที่เป็นเจ้าของคีย์นี้ถูกระงับ
403 plan_requiredบัญชีนี้อยู่ในแพ็กเกจ Free — การใช้งาน API ต้องมี Basic, Lite, Pro หรือ Team
400 invalid_category"category" ไม่ใช่ "image" หรือ "document"
400 missing_target"target" ว่างเปล่า
400 no_fileไม่มีการส่งไฟล์มา หรือการอัปโหลดล้มเหลว — ฟิลด์ต้องตั้งชื่อว่า "file"
413 file_too_largeไฟล์มีขนาดเกินขีดจำกัดการอัปโหลดสูงสุดของแพ็กเกจของคุณ
429 quota_exceededโควตานาทีการแปลงรายเดือนของแพ็กเกจถูกใช้จนหมดแล้ว จะรีเซ็ตเมื่อเริ่มเดือนปฏิทินถัดไป
429 concurrency_limitมีการแปลงไฟล์ทำงานพร้อมกันมากเกินไปสำหรับบัญชีนี้ (ใช้ร่วมกับเว็บไซต์) — รอให้งานหนึ่งเสร็จก่อนแล้วลองใหม่
422 conversion_failedไฟล์นี้ไม่สามารถแปลงได้ — "message" อธิบายสาเหตุ รหัสสถานะจะต่างกันไปตามสาเหตุ: 400/415/422 หมายความว่าไฟล์หรือ target นี้จะไม่สำเร็จไม่ว่าจะลองกี่ครั้งก็ตาม; 500/503 หมายถึงปัญหาฝั่งเซิร์ฟเวอร์ และ 503 โดยเฉพาะคุ้มค่าที่จะลองใหม่อีกครั้งในเวลาสั้นๆ

Supported conversions

รองรับเป็นต้นทาง:

PDF, DOCX, DOC, PPTX, PPT, XLSX, XLS, RTF, ODT, ODP, ODS, HTML

ใช้เป็นปลายทางได้:

PDF, DOCX, DOC, PPTX, PPT, XLSX, XLS, RTF, ODT, ODP, ODS

ที่เกี่ยวข้อง