API reference

ฉบับร่างและไฟล์แนบ

สร้างโฟลว์ตัวเขียนอีเมลพร้อมที่เก็บไฟล์แนบส่วนตัว

POST/drafts
API key

สร้างฉบับร่างในตัวเขียนอีเมล

สร้างฉบับร่างในตัวเขียนอีเมล

คำขอ
curl https://sendhq.cc/api/v1/drafts \
  -X POST \
  -H "Authorization: Bearer $SENDHQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"hello@example.com","to":["customer@example.net"],"subject":"Hello"}'
การตอบกลับ 201
{
  "id": "dr_…",
  "attachments": []
}
GET/drafts
API key

แสดงรายการฉบับร่างในตัวเขียนอีเมล

แสดงรายการฉบับร่างในตัวเขียนอีเมล

คำขอ
curl https://sendhq.cc/api/v1/drafts \
  -X GET \
  -H "Authorization: Bearer $SENDHQ_API_KEY"
การตอบกลับ 200
{
  "data": [],
  "count": 0
}
GET/drafts/:id
API key

ดึงฉบับร่างและไฟล์แนบ

ดึงฉบับร่างและไฟล์แนบ

คำขอ
curl https://sendhq.cc/api/v1/drafts/id_value \
  -X GET \
  -H "Authorization: Bearer $SENDHQ_API_KEY"
การตอบกลับ 200
{
  "id": "dr_…",
  "attachments": []
}
PUT/drafts/:id
API key

แทนที่เนื้อหาของฉบับร่าง

แทนที่เนื้อหาของฉบับร่าง

คำขอ
curl https://sendhq.cc/api/v1/drafts/id_value \
  -X PUT \
  -H "Authorization: Bearer $SENDHQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"hello@example.com","to":["customer@example.net"],"subject":"Updated subject","text":"Updated body"}'
การตอบกลับ 200
{
  "id": "dr_…"
}
DELETE/drafts/:id
API key

ละทิ้งฉบับร่าง

ละทิ้งฉบับร่าง

คำขอ
curl https://sendhq.cc/api/v1/drafts/id_value \
  -X DELETE \
  -H "Authorization: Bearer $SENDHQ_API_KEY"
การตอบกลับ 200
{
  "ok": true
}
POST/drafts/:id/attachments
API key

อัปโหลดไฟล์แนบไปยังฉบับร่าง

อัปโหลดไบต์ดิบของไฟล์ ตั้งค่า Content-Type และ X-Filename ข้อความหนึ่งฉบับมีไฟล์ได้สูงสุด 10 ไฟล์และรวมกันไม่เกิน 10 MB

เฮดเดอร์ที่ไม่บังคับX-Filename
คำขอ
curl https://sendhq.cc/api/v1/drafts/id_value/attachments \
  -X POST \
  -H "Authorization: Bearer $SENDHQ_API_KEY" \
  -H "Content-Type: application/pdf" \
  -H "X-Filename: invoice.pdf" \
  --data-binary @invoice.pdf
การตอบกลับ 201
{
  "id": "att_…",
  "filename": "invoice.pdf",
  "sizeBytes": 48231,
  "available": true
}
GET/attachments/:id
API key

ดาวน์โหลดไฟล์แนบส่วนตัว

ดาวน์โหลดไฟล์แนบส่วนตัว

คำขอ
curl https://sendhq.cc/api/v1/attachments/id_value \
  -X GET \
  -H "Authorization: Bearer $SENDHQ_API_KEY"
DELETE/attachments/:id
API key

ลบไฟล์แนบส่วนตัว

ลบไฟล์แนบส่วนตัว

คำขอ
curl https://sendhq.cc/api/v1/attachments/id_value \
  -X DELETE \
  -H "Authorization: Bearer $SENDHQ_API_KEY"
การตอบกลับ 200
{
  "ok": true
}
GET/sending-identities
API key

แสดงรายการตัวตนผู้ส่งที่ยืนยันแล้ว

แสดงรายการตัวตนผู้ส่งที่ยืนยันแล้ว

คำขอ
curl https://sendhq.cc/api/v1/sending-identities \
  -X GET \
  -H "Authorization: Bearer $SENDHQ_API_KEY"
การตอบกลับ 200
{
  "domains": [],
  "addresses": [],
  "localParts": []
}