เอกสาร API
API ของ YourImageShare ช่วยให้คุณอัพโหลด แสดงรายการ และลบไฟล์ผ่านโปรแกรมได้ เป็น JSON/REST API ขนาดเล็ก ไม่ต้องใช้ SDK เพียงมี HTTP client และ API key ก็พอ นอกจากนี้ยังมี ไลบรารี JavaScript, Python และ MCP อย่างเป็นทางการให้ใช้ด้วย
ไลบรารีไคลเอนต์ทั้งหมดและเครื่องมือด้านล่างเป็นโอเพนซอร์ส คุณดูโค้ด แจ้งปัญหา หรือร่วมพัฒนาได้ที่ GitHub อย่างเป็นทางการของเราที่ github.com/yourimageshare/yourimageshare
Base URL: https://yourimageshare.com/api · รูปแบบข้อมูล: รับส่งเป็น JSON ยกเว้นการอัพโหลดที่ใช้ multipart/form-data · การยืนยันตัวตน: ใช้ API key ในทุกคำขอ · สเปกที่เครื่องอ่านได้: /openapi.json (OpenAPI 3.1) สำหรับเอเจนต์และเครื่องมือสร้างโค้ด ที่ไม่ต้องการแยกวิเคราะห์หน้านี้
การขอ API key
เข้าสู่ระบบ ไปที่ บัญชีของฉัน แล้วเปิดแท็บ API คุณจะเห็นคีย์ของคุณที่นั่น พร้อมปุ่ม Regenerate การสร้างคีย์ใหม่จะทำให้คีย์เดิมใช้ไม่ได้ทันที จึงควรอัปเดตทุกที่ที่ใช้คีย์อยู่ก่อนกดปุ่มนี้
แท็บนี้ยังมี คีย์สำหรับอัพโหลดอย่างเดียว แยกอีกชุดหนึ่ง ดูเคล็ดลับด้านล่างและ ปลั๊กอินเว็บบอร์ด เพื่อดูว่าควรใช้เมื่อไร
การยืนยันตัวตน
ส่งคีย์ของคุณผ่าน header ซึ่งเป็นวิธีที่แนะนำ เพราะ query string มักถูกบันทึกไว้ใน access log, proxy log และ header Referer:
X-API-Key: YOUR_API_KEY พารามิเตอร์ ?key= ใน query ก็ใช้ได้เช่นกัน เก็บไว้เพื่อรองรับระบบเดิม และคำสั่ง curl ที่รันครั้งเดียว หากมีทั้งสองแบบ จะใช้ค่าจาก header
?key=YOUR_API_KEY เคล็ดลับ: ดูแลคีย์เหมือนรหัสผ่าน ใครมีคีย์นี้ก็อัพโหลด แสดงรายการ แก้ไข และลบไฟล์ในบัญชีของคุณได้ ทุกคำขอที่สำเร็จจะถูกบันทึก และแสดงเป็นกราฟในแท็บ API ของหน้าบัญชี แยกตามวันและตามประเภทคำขอ หากต้องวางคีย์ในที่ที่คนอื่นมองเห็นได้ เช่น ปลั๊กอินเว็บบอร์ดหรือไฟล์ config สาธารณะ ให้ใช้ คีย์สำหรับอัพโหลดอย่างเดียว จากแท็บเดียวกันแทน คีย์นี้ทำได้แค่อัพโหลด การแสดงรายการ ค้นหา แก้ไข และลบไฟล์จะถูกปฏิเสธด้วย 401
Endpoints
การอัพโหลด แสดงรายการ และลบ ใช้การยืนยันตัวตนและขีดจำกัดการใช้งานเดียวกัน ส่วนไฟล์ขนาดใหญ่สามารถส่งเป็นส่วน ๆ ก่อนได้
POST /api - อัพโหลดไฟล์
อัพโหลดไฟล์เดียวให้กับบัญชีที่ยืนยันตัวตนแล้ว
| ฟิลด์ | ชนิด | จำเป็น | คำอธิบาย |
|---|---|---|---|
uploads | file | เลือกหนึ่งในสามอย่างนี้ | ไฟล์ที่จะอัพโหลด ขนาดสูงสุด 100MB (ขีดจำกัดของหนึ่งคำขอผ่านเครือข่ายของเรา) หนึ่งไฟล์ต่อหนึ่งคำขอ endpoint นี้ไม่รองรับการอัพโหลดหลายไฟล์พร้อมกัน |
url | string | ลิงก์ http(s) สาธารณะของรูปภาพหรือวิดีโอ เราจะดาวน์โหลดเอง จึงรองรับไฟล์ขนาดสูงสุด 200MB | |
upload_id | string | ไฟล์ที่ส่งเป็นส่วน ๆ ไปที่ POST /api/chunk ก่อนหน้านี้ ขนาดสูงสุด 200MB | |
filename | string | ไม่ | ใช้ร่วมกับ upload_id: ชื่อไฟล์เดิม |
expires_in | integer | ไม่ | ลบการอัพโหลดนี้อัตโนมัติหลังผ่านไปตามจำนวนวินาทีที่กำหนด (60 ถึง 31,536,000 หรือ 1 นาทีถึง 1 ปี) หากไม่ระบุ จะเป็นการอัพโหลดแบบถาวรตามปกติ |
allow_duplicate | boolean | ไม่ | เก็บสำเนาใหม่แม้บัญชีของคุณเคยอัพโหลดไฟล์เดียวกันนี้แล้ว (ดู duplicate ด้านล่าง) |
keep_original | boolean | ไม่ | เก็บรูปภาพไว้ตามที่อัพโหลดทุกประการ หากไม่ใช้ ไฟล์ JPG/PNG ที่ใหญ่กว่า 1 MB จะถูกปรับให้เหมาะสมเป็น WebP ข้อมูลเมตา เช่น GPS จะถูกลบออกไม่ว่ากรณีใด |
visibility | string | ไม่ | unlisted (ค่าเริ่มต้น): ไฟล์และหน้าของไฟล์ใช้งานได้สำหรับทุกคนที่มีลิงก์ แต่ไม่ถูกแสดงในที่ใด ๆ private: เฉพาะไฟล์ ลิงก์ไปยังหน้าจะพาทุกคนยกเว้นคุณไปที่ไฟล์โดยตรง (ไม่มีคอมเมนต์ รีแอคชัน หรือโฆษณา) public: แสดงบนเว็บไซต์และให้ค้นหาได้ |
title | string | ไม่ | ไม่เกิน 90 ตัวอักษร แสดงบนหน้าของการอัพโหลด |
description | string | ไม่ | ไม่เกิน 500 ตัวอักษร |
ประเภทไฟล์ที่รองรับ: รูปภาพ JPG, PNG, GIF, WEBP, AVIF, BMP, TIFF, HEIC หรือ HEIF และวิดีโอ MP4, WEBM, AVI, MOV, MKV, MPEG, WMV, FLV หรือ 3GP (รายการที่แน่นอนอาจเพิ่มขึ้นในอนาคต) ไฟล์ HEIC/HEIF และ TIFF จะถูกเก็บเป็น WebP วิดีโอ ที่ไม่ใช่ MP4/WebM จะถูกแปลงเป็น MP4 และรูปภาพ JPEG/PNG ที่ใหญ่กว่า จะถูกแปลงเป็น WebP ไม่นานหลังอัพโหลด เมื่อทำให้ไฟล์เล็กลงอย่างเห็นได้ชัด ขนาดสูงสุด: 200MB ไฟล์ที่ใหญ่เกินไปหรืออ่านไม่ได้จะถูกปฏิเสธด้วย 422
การตอบกลับ - 200 OK:
{
"type": "success",
"msg": "success",
"data": {
"id": "aB3xY9qRz1",
"type": "image",
"path": "https://i.yourimageshare.com/aB3xY9qRz1.png",
"src": "https://yourimageshare.com/ib/aB3xY9qRz1.png",
"direct": "https://yourimageshare.com/ib/aB3xY9qRz1",
"thumb": "https://i.yourimageshare.com/thumb-aB3xY9qRz1.webp",
"width": 1920,
"height": 1080,
"size": 482113,
"locked": false,
"visibility": "unlisted",
"title": null,
"description": null,
"expires_at": null,
"duplicate": false,
"delete_url": "https://yourimageshare.com/delete#iV3x...k9"
}
} | ฟิลด์ | คำอธิบาย |
|---|---|
id | ตัวระบุเฉพาะของไฟล์ |
type | image หรือ video |
path | URL ที่เก็บไฟล์ตามที่อัพโหลด อาจเปลี่ยนไม่นานหลังจากนั้นเมื่อไฟล์ถูกแปลง (WebP/MP4) ดังนั้นให้เก็บ src ไม่ใช่ path |
src | URL ไฟล์โดยตรงแบบถาวร เปิดไฟล์ปัจจุบันเสมอ เหมาะสำหรับใช้เป็น src ของ <img>/<video> และสำหรับบันทึกเก็บไว้ |
direct | หน้าของไฟล์บน YourImageShare (ชื่อ คำอธิบาย คอมเมนต์ ตัวเลือกการแชร์) |
thumb | ภาพขนาดย่อ WebP กว้าง 280px (สำหรับวิดีโอ คือเฟรมแรก) หรือ null |
width, height | ขนาดที่แสดงเป็นพิกเซล (ตามแนวตั้งตรง สำหรับวิดีโอคือขนาดเฟรม) หรือ null หากไม่ทราบ |
size | ขนาดไฟล์เป็นไบต์ตามที่จัดเก็บ |
locked | true หากการอัพโหลดมีการป้องกันด้วยรหัสผ่าน |
visibility | private, unlisted หรือ public (ดูฟิลด์ของคำขอด้านบน) |
title, description | ตามที่ตั้งไว้ หรือ null ข้อความผ่านการตรวจสอบแบบเดียวกับบนเว็บไซต์ |
delete_url | เฉพาะการอัพโหลดใหม่: ลิงก์ส่วนตัวที่ลบการอัพโหลดนี้ได้โดยไม่ต้องใช้ API key แสดงครั้งเดียว (เราเก็บเฉพาะค่าแฮช) หากต้องใช้ ให้เก็บไว้ |
expires_at | เวลาในรูปแบบ ISO 8601 ที่การอัพโหลดนี้จะถูกลบอัตโนมัติ หรือ null หากไม่มีวันหมดอายุ |
duplicate | true หากบัญชีของคุณเคยอัพโหลดไฟล์เดียวกันนี้แล้ว: ระบบจะส่งการอัพโหลดเดิมกลับมาและไม่เก็บไฟล์ใหม่ ไม่ใช้กับการอัพโหลดที่มีวันหมดอายุ หรือเมื่อใช้ allow_duplicate=1 |
การอัพโหลดที่มีวันหมดอายุ: เมื่อถึงเวลา expires_at ไฟล์จะถูกลบออกจากที่เก็บ และหน้าของการอัพโหลดจะเริ่มตอบกลับ 410 Gone ภายในประมาณ 5 นาที ไม่สามารถยกเลิกหรือขยายเวลาภายหลังได้ หากต้องการลบก่อนกำหนด ให้ใช้ DELETE endpoint หรือหากต้องการให้อยู่นานขึ้น ให้อัพโหลดใหม่พร้อม expires_in ใหม่
POST /api/chunk - ไฟล์ขนาดใหญ่
หนึ่งคำขอส่งข้อมูลได้สูงสุด 100MB สำหรับไฟล์ที่ใหญ่กว่านั้น (สูงสุด 200MB) หรือเพื่อให้แต่ละคำขอมีขนาดเล็กเมื่อใช้ การเชื่อมต่อที่ช้า ให้ส่งไฟล์เป็นส่วน ๆ ส่วนละไม่เกิน 5MB แล้วปิดท้ายด้วย POST /api:
- เลือก upload id: อักขระ hex สุ่ม 32 ตัว
- สำหรับแต่ละส่วน ให้
POST /api/chunk(multipart/form-data) พร้อมupload_id,index(เริ่มจาก 0),total(จำนวน ส่วนทั้งหมด) และข้อมูลไบต์ในchunkคำตอบคือ{"type": "success", "chunk_size": 5242880} POST /apiพร้อมupload_idและfilenameแทนuploadsรวมถึงฟิลด์อัพโหลดอื่น ๆ ที่ต้องการ คำตอบคือ การตอบกลับของการอัพโหลดตามปกติ
ส่วนต่าง ๆ ของการอัพโหลดที่ยังไม่เสร็จจะถูกลบหลังผ่านไป 2 ชั่วโมง เฉพาะ POST /api ตอนปิดท้ายเท่านั้นที่นับรวมในขีดจำกัดการอัพโหลด
GET /api/{id} และ PATCH /api/{id} - การอัพโหลดหนึ่งรายการ
GET ส่งคืนการอัพโหลดหนึ่งรายการของคุณพร้อมฟิลด์เดียวกับรายการด้านล่าง PATCH เปลี่ยน visibility, title หรือ description (ฟิลด์ฟอร์มหรือ JSON; ชื่อหรือคำอธิบายที่เว้นว่างจะเป็นการล้างค่า) และตอบกลับด้วยการอัพโหลดที่อัปเดตแล้ว ทั้งสองอย่างต้องใช้ API key เต็มรูปแบบ และจะได้ 404 หาก ไม่มีการอัพโหลดนั้นในบัญชีของคุณ
curl -X PATCH https://yourimageshare.com/api/aB3xY9qRz1 \
-H "X-API-Key: YOUR_API_KEY" -d visibility=public -d title="Sunset" POST /api/{id}/replace - แทนที่ไฟล์
สลับไฟล์ที่อยู่เบื้องหลังการอัพโหลดของคุณ โดยคง id หน้า และลิงก์ทั้งหมดไว้ ใช้ได้กับทุกประเภทที่อนุญาต แม้เป็น ประเภทอื่น (รูปภาพเปลี่ยนเป็นวิดีโอได้) ส่งไฟล์ใหม่เป็น uploads (หรือ upload_id ของ ไฟล์ที่ส่งเป็นส่วน ๆ ด้วย POST /api/chunk) โดย keep_original ใช้งานเหมือนตอนอัพโหลด ไฟล์ใหม่จะได้รับ การตรวจสอบและการแปลงแบบเดียวกับการอัพโหลดใหม่ และเวอร์ชันก่อนหน้าจะถูกลบ ต้องใช้ API key เต็มรูปแบบ ได้ 404 หากไม่มีการอัพโหลดนั้นในบัญชีของคุณ และ 409 หากมีการป้องกันด้วยรหัสผ่านหรือจำกัดจำนวนการดู
curl -X POST https://yourimageshare.com/api/aB3xY9qRz1/replace \
-H "X-API-Key: YOUR_API_KEY" -F uploads=@new-version.png GET /api - แสดงรายการการอัพโหลดของคุณ
ส่งคืนรายการแบ่งหน้าของการอัพโหลดในบัญชีที่ยืนยันตัวตนแล้ว (จากทุกแหล่ง ไม่ว่าจะเป็น API เว็บไซต์ หรือตัวแก้ไข) เรียงจากใหม่ไปเก่า หน้าละ 50 รายการ
| พารามิเตอร์ | ตำแหน่ง | จำเป็น | คำอธิบาย |
|---|---|---|---|
page | query | ไม่ | หมายเลขหน้า ค่าเริ่มต้นคือ 1 |
การตอบกลับ - 200 OK:
{
"type": "success",
"data": [
{
"id": "aB3xY9qRz1",
"type": "image",
"title": null,
"path": "https://i.yourimageshare.com/aB3xY9qRz1.webp",
"src": "https://yourimageshare.com/ib/aB3xY9qRz1.webp",
"direct": "https://yourimageshare.com/ib/aB3xY9qRz1",
"thumb": "https://i.yourimageshare.com/thumb-aB3xY9qRz1.webp",
"width": 1920,
"height": 1080,
"size": 482113,
"locked": false,
"visibility": "unlisted",
"description": null,
"expires_at": null,
"created_at": "2026-07-23T15:43:28+01:00"
}
],
"meta": { "current_page": 1, "last_page": 1, "total": 1 }
} ฟิลด์เหล่านี้มีความหมายเหมือนกับในการตอบกลับของการอัพโหลดด้านบน (สำหรับการอัพโหลดที่มีรหัสผ่านป้องกัน path และ thumb เป็นลิงก์ที่ลงนามไว้และมีอายุสั้น) หากต้องการค้นหาการอัพโหลดหนึ่งรายการด้วย id ให้ใช้ GET /api/{id}
DELETE /api/{id} - ลบการอัพโหลด
ลบการอัพโหลดหนึ่งรายการของบัญชีที่ยืนยันตัวตนแล้วอย่างถาวร ไม่สามารถ ย้อนกลับได้จาก API {id} คือค่าที่ส่งกลับเป็น id จาก endpoint อัพโหลดหรือแสดงรายการ
การตอบกลับ - 200 OK:
{ "type": "success", "msg": "Deleted." } ได้ 404 หากไม่มีการอัพโหลดที่ใช้ id นั้นในบัญชีของคุณ (อาจไม่เคย เป็นของคุณ หรือถูกลบไปแล้ว)
POST /api/compare - สไลเดอร์เปรียบเทียบก่อน/หลัง
สร้างการเปรียบเทียบก่อน/หลังจากรูปภาพที่คุณอัพโหลดเองสองรูป: เป็นหน้าที่มีสไลเดอร์ที่ /c/{id} และฝังในเว็บไซต์ใดก็ได้ คีย์สำหรับอัพโหลดอย่างเดียวก็ใช้ได้ ส่ง before และ after (upload id จำเป็นต้องมี) และเลือกส่ง title, label_before และ label_after ได้ (ค่าเริ่มต้นคือ "Before" และ "After")
การตอบกลับ - 201 Created:
{
"type": "success",
"id": "P7uAYy04VA",
"url": "https://yourimageshare.com/c/P7uAYy04VA",
"embed_url": "https://yourimageshare.com/embed/c/P7uAYy04VA",
"embed": { "script": "<blockquote class=\"YISEmbed\" ...", "iframe": "<iframe ..." }
} ได้ 422 หาก id ใดไม่ใช่รูปภาพที่คุณอัพโหลด (ไม่สามารถใช้วิดีโอและรูปภาพที่มีรหัสผ่านป้องกันได้)
ขีดจำกัดการใช้งาน
API key แต่ละคีย์มีโควตาต่อนาทีและต่อวันแยกจากกัน รวมถึงเพดานรายวันต่อ IP ที่กว้างกว่า เพื่อป้องกันกรณีที่ IP เดียววนใช้ หลายคีย์ การอัพโหลด แสดงรายการ และลบ ใช้ขีดจำกัดร่วมกัน
| ช่วงเวลา | ขีดจำกัดเริ่มต้น | ขอบเขต |
|---|---|---|
| ต่อนาที | 20 คำขอ | ต่อ API key |
| ต่อวัน | 500 คำขอ | ต่อ API key เต็มรูปแบบ |
| ต่อวัน | 2,000 คำขอ | ต่อคีย์สำหรับอัพโหลดอย่างเดียว (ปลั๊กอินที่ย้ายคลังสื่อทั้งหมด) |
| ต่อวัน | 2,000 คำขอ | ต่อที่อยู่ IP |
| ต่อเดือน (UTC) | อัพโหลด 3,000 รายการ | ต่อบัญชี รวมทุกคีย์ |
| ต่อนาที | 300 ส่วน | ต่อ API key เฉพาะ POST /api/chunk |
โควตาอัพโหลดรายเดือน แต่ละบัญชีอัพโหลดผ่าน API ได้ 3,000 ไฟล์ต่อเดือน นับรวมทุกคีย์และเครื่องมือที่ใช้คีย์เหล่านั้น (SDK ปลั๊กอิน ส่วนขยายเบราว์เซอร์ MCP ที่ใช้คีย์) นับเฉพาะการอัพโหลดที่สำเร็จ ไม่นับการดูรายการ การลบ และคำขอที่ล้มเหลว และไฟล์ที่ส่งเป็นส่วนๆ นับเป็นหนึ่งไฟล์ การนับจะเริ่มใหม่ทุกวันที่ 1 ของเดือน (UTC) ดูยอดของเดือนนี้ได้ที่ บัญชีของฉัน > API เมื่อเกินโควตา POST /api จะตอบกลับ 429 พร้อมวันที่รีเซ็ต โควตานี้มีผลตั้งแต่ 1 มกราคม 2027
ขีดจำกัดเหล่านี้อาจมีการเปลี่ยนแปลง ทุกการตอบกลับมี header ขีดจำกัดอัตราตามมาตรฐาน:
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 14 เมื่อเกินขีดจำกัดจะได้ 429 พร้อม header Retry-After ที่บอกจำนวนวินาทีที่ต้องรอ
ข้อผิดพลาด
ทุกการตอบกลับที่เป็นข้อผิดพลาดใช้รูปแบบเดียวกัน ไม่ว่า จะเป็น endpoint ใดหรือสาเหตุใด:
{ "type": "error", "errors": "A human-readable description of what went wrong." } | สถานะ | ความหมาย |
|---|---|
| 401 | ไม่มี API key หรือ API key ไม่ถูกต้อง |
| 403 | บัญชีหรือ IP ปัจจุบันของคุณถูกห้ามอัพโหลด |
| 404 | ไม่พบการอัพโหลดที่ตรงกับ id นั้นในบัญชีนี้ (ดู แก้ไข ลบ) |
| 413 | คำขอมีขนาดเกิน 100MB ให้ส่งไฟล์เป็นส่วน ๆ (POST /api/chunk) หรือส่งลิงก์ไปยังไฟล์ใน url แทน (สูงสุด 200MB) |
| 422 | การตรวจสอบไม่ผ่าน - ไม่ได้ส่งไฟล์หรือลิงก์ ประเภทไฟล์ไม่รองรับ ข้อมูลรูปภาพอ่านไม่ได้ ขนาดเกินขีดจำกัด 30000x30000px ไฟล์ใหญ่เกิน 200MB upload_id ที่ยังไม่เสร็จหรือหมดอายุ หรือ url ที่ดาวน์โหลดไม่ได้ (ข้อความจะบอกเหตุผล) |
| 429 | เกินขีดจำกัดการใช้งาน - ดู ขีดจำกัดการใช้งาน ด้านบน |
| 500 | เกิดข้อผิดพลาดที่ไม่คาดคิดฝั่งเซิร์ฟเวอร์ ลองใหม่ได้อย่างปลอดภัย |
ไลบรารีไคลเอนต์
SDK อย่างเป็นทางการที่ห่อหุ้ม endpoint ข้างต้น พร้อมผลลัพธ์ที่มีชนิดข้อมูล และแจ้งข้อผิดพลาดของ API ให้อัตโนมัติ แทนที่จะต้องจัดการ HTTP ดิบ ๆ
JavaScript / TypeScript
ไม่มี dependency ใช้ได้ทั้งใน Node.js และเบราว์เซอร์ มีบน JSR ด้วย ในชื่อ @yourimageshare/yourimageshare - npx jsr add @yourimageshare/yourimageshare - ซอร์สเดียวกัน เผยแพร่เป็น TypeScript โดยตรง
npm install yourimageshare Python
มี dependency เดียว (requests) รองรับ Python 3.8+
pip install yourimageshare PHP
ไม่มี dependency ของ Composer (ใช้ส่วนขยาย curl ของ PHP เอง) รองรับ PHP 7.4+ ซอร์สอยู่บน GitHub
composer require yourimageshare/yourimageshare-php Go
ไม่มี dependency (ใช้เฉพาะไลบรารีมาตรฐาน) รองรับ Go 1.18+ ดู pkg.go.dev สำหรับเอกสารอ้างอิงฉบับเต็ม
go get github.com/yourimageshare/yourimageshare/go Rust
มีสอง dependency (ureq สำหรับ HTTP แบบ blocking ไม่ดึง async runtime เข้ามา - และ serde) รองรับ Rust 1.70+ ซอร์สอยู่บน GitHub
cargo add yourimageshare Ruby
ไม่มี gem dependency (ใช้ Net::HTTP + json ของไลบรารีมาตรฐาน) รองรับ Ruby 2.7+ ซอร์สอยู่บน GitHub
gem install yourimageshare .NET
มี dependency เดียว (System.Text.Json ของ Microsoft เอง) เป้าหมาย netstandard2.0 จึงใช้ได้ทั้งกับ .NET Framework และ .NET รุ่นใหม่ ซอร์สอยู่บน GitHub สร้างและทดสอบกับ API จริงนี้แล้ว กำลังจะเผยแพร่บน NuGet เร็ว ๆ นี้
dotnet add package YourImageShare Dart / Flutter
มี dependency เดียว (http แพ็กเกจของทีม Dart เอง) รองรับ Dart 2.17+ ซอร์สอยู่บน GitHub สร้างและทดสอบกับ API จริงนี้แล้ว กำลังจะเผยแพร่บน pub.dev เร็ว ๆ นี้
dart pub add yourimageshare Elixir
มี dependency เดียว (Req) รองรับ Elixir 1.14+ ส่งคืน tuple แบบ {:ok, result}| {:error, reason} ซึ่งเทียบเท่ากับ การจัดการข้อผิดพลาดของ API นี้ใน SDK อื่นทุกตัว และมี ฟังก์ชันแบบ bang ที่ raise ข้อผิดพลาดด้วย ซอร์สอยู่บน GitHub และเอกสารอยู่บน HexDocs
{:yourimageshare, "~> 1.1"} MCP Server
สำหรับ AI coding agent (Claude Code, Cursor และเครื่องมืออื่นที่รองรับ MCP) - วางภาพหน้าจอลงในรายงานบั๊ก คำอธิบาย PR หรือเธรดซัพพอร์ตเป็น URL จริง แทนที่จะเป็น base64 หรือขั้นตอนอัพโหลดด้วยตนเอง ใช้งานได้เหมือนกันกับ Claude Desktop และไคลเอนต์ MCP อื่น ๆ
แบบโฮสต์ ไม่ต้องติดตั้งอะไร: เพิ่มเป็นเซิร์ฟเวอร์ MCP ระยะไกล (ใน Claude: Settings › Connectors › Add custom connector รวมถึง ChatGPT, Cursor, VS Code และไคลเอนต์อื่นที่รับ URL ของเซิร์ฟเวอร์) โดยใส่ API key ใน URL:
https://yourimageshare.com/mcp?key=YOUR_API_KEY ไคลเอนต์ที่ตั้งค่า header ได้ ใช้ https://yourimageshare.com/mcp พร้อม Authorization: Bearer YOUR_API_KEY แทนได้ URL ที่มีคีย์ของคุณทำงานเหมือนรหัสผ่าน: เก็บไว้เป็นความลับ และหากรั่วไหล ให้ขอคีย์ใหม่ที่ บัญชีของฉัน บนเซิร์ฟเวอร์แบบโฮสต์ upload_image รับลิงก์สาธารณะ (สูงสุด 200MB) หรือเนื้อหา base64 แบบอินไลน์ (สูงสุด 15MB) หากไม่มีคีย์ https://yourimageshare.com/mcp ก็ยังอัพโหลดแบบไม่ระบุตัวตนได้เหมือนบนเว็บไซต์: เป็น unlisted หรือ private เท่านั้น ขีดจำกัดต่ำกว่า และการอัพโหลดจะถูกลบด้วย delete_url ที่ส่งกลับมา เครื่องมืออื่นต้องใช้คีย์
แบบในเครื่อง: รันโดยตรงด้วย npx ไม่ต้องติดตั้ง (อ่านไฟล์จากดิสก์ของคุณได้ด้วย):
npx yourimageshare-mcp เครื่องมือ: upload_image (ไฟล์ในเครื่อง เนื้อหาอินไลน์ หรือลิงก์ สูงสุด 200MB พร้อมตัวเลือก visibility, title และการลบอัตโนมัติ), list_uploads, get_upload, update_upload และ delete_upload
มีใน MCP Registry อย่างเป็นทางการ (ในชื่อ io.github.yourimageshare/yourimageshare) และอยู่ในรายการของ Glama หากไคลเอนต์ MCP ของคุณติดตั้งจากแหล่งใดแหล่งหนึ่งเหล่านั้น
เพิ่งเริ่มใช้ MCP? ดูวิธีเชื่อมต่อ Claude และ ChatGPT กับ API นี้ผ่าน MCP เพื่อดูขั้นตอนตั้งค่าแบบละเอียด
ทั้งสิบตัวใช้สัญญาอนุญาต MIT ไม่มีไลบรารีอย่างเป็นทางการสำหรับ ภาษาของคุณ? ตัวอย่างโค้ด ด้านล่างแสดงวิธีเรียก API โดยตรง
ตัวอย่างโค้ด
curl
# Upload a file
curl "https://yourimageshare.com/api" \
-H "X-API-Key: YOUR_API_KEY" \
-F "uploads=@/path/to/photo.jpg"
# Upload from a link (files up to 200MB; one direct upload request stops at 100MB -
# bigger files go in pieces, see Large Files above)
curl "https://yourimageshare.com/api" \
-H "X-API-Key: YOUR_API_KEY" \
-F "url=https://example.com/video.mp4"
# Upload a file that auto-deletes after 1 hour
curl "https://yourimageshare.com/api" \
-H "X-API-Key: YOUR_API_KEY" \
-F "uploads=@/path/to/photo.jpg" \
-F "expires_in=3600"
# List uploads
curl "https://yourimageshare.com/api" -H "X-API-Key: YOUR_API_KEY"
# Upload a file without a page of its own (file only) and give it a title
curl "https://yourimageshare.com/api" \
-H "X-API-Key: YOUR_API_KEY" \
-F "uploads=@/path/to/photo.jpg" \
-F "visibility=private" \
-F "title=Sunset"
# Look up one upload, then make it public
curl "https://yourimageshare.com/api/aB3xY9qRz1" -H "X-API-Key: YOUR_API_KEY"
curl -X PATCH "https://yourimageshare.com/api/aB3xY9qRz1" \
-H "X-API-Key: YOUR_API_KEY" -d "visibility=public"
# Delete an upload
curl -X DELETE "https://yourimageshare.com/api/aB3xY9qRz1" -H "X-API-Key: YOUR_API_KEY" JavaScript (fetch)
const API_KEY = 'YOUR_API_KEY';
const BASE = 'https://yourimageshare.com/api';
async function uploadFile(file) {
const form = new FormData();
form.append('uploads', file);
const res = await fetch(BASE, {
method: 'POST',
headers: { 'X-API-Key': API_KEY },
body: form,
});
const json = await res.json();
if (json.type !== 'success') throw new Error(json.errors);
return json.data;
}
async function listUploads(page = 1) {
const res = await fetch(`${BASE}?page=${page}`, {
headers: { 'X-API-Key': API_KEY },
});
return res.json();
}
async function deleteUpload(id) {
const res = await fetch(`${BASE}/${id}`, {
method: 'DELETE',
headers: { 'X-API-Key': API_KEY },
});
return res.json();
} Python (requests)
import requests
API_KEY = "YOUR_API_KEY"
BASE = "https://yourimageshare.com/api"
HEADERS = {"X-API-Key": API_KEY}
# Upload a file
with open("/path/to/photo.jpg", "rb") as f:
res = requests.post(BASE, headers=HEADERS, files={"uploads": f})
res.raise_for_status()
upload = res.json()["data"]
# List uploads
res = requests.get(BASE, headers=HEADERS, params={"page": 1})
uploads = res.json()
# Delete an upload
res = requests.delete(f"{BASE}/{upload['id']}", headers=HEADERS) PHP (curl)
<?php
$apiKey = 'YOUR_API_KEY';
$base = 'https://yourimageshare.com/api';
// Upload a file
$curl = curl_init($base);
curl_setopt_array($curl, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ["X-API-Key: $apiKey"],
CURLOPT_POSTFIELDS => ['uploads' => new CURLFile('/path/to/photo.jpg')],
CURLOPT_RETURNTRANSFER => true,
]);
$upload = json_decode(curl_exec($curl), true)['data'];
curl_close($curl);
// List uploads
$curl = curl_init("$base?page=1");
curl_setopt($curl, CURLOPT_HTTPHEADER, ["X-API-Key: $apiKey"]);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$uploads = json_decode(curl_exec($curl), true);
curl_close($curl); Go (net/http)
Go SDK อย่างเป็นทางการ ด้านบนห่อหุ้มส่วนนี้ให้คุณแล้ว ตัวอย่างแบบดิบนี้มีไว้สำหรับผู้ที่ไม่อยากเพิ่ม dependency
package main
import (
"bytes"
"encoding/json"
"io"
"mime/multipart"
"net/http"
"os"
)
const apiKey = "YOUR_API_KEY"
const base = "https://yourimageshare.com/api"
func uploadFile(path string) (map[string]any, error) {
file, err := os.Open(path)
if err != nil {
return nil, err
}
defer file.Close()
body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
part, _ := writer.CreateFormFile("uploads", path)
io.Copy(part, file)
writer.Close()
req, _ := http.NewRequest("POST", base, body)
req.Header.Set("Content-Type", writer.FormDataContentType())
req.Header.Set("X-API-Key", apiKey)
res, err := http.DefaultClient.Do(req)
if err != nil {
return nil, err
}
defer res.Body.Close()
var result map[string]any
json.NewDecoder(res.Body).Decode(&result)
return result, nil
} เครื่องมือแคปหน้าจอ
ส่วนขยายเบราว์เซอร์ พร้อมไฟล์ตั้งค่าและ สคริปต์สำเร็จรูปที่ส่งภาพหน้าจอไปยัง YourImageShare โดยตรง ไม่ต้อง อัพโหลดเอง ทุกตัวอัพโหลดผ่าน endpoint /api เดียวกัน ตามที่อธิบายไว้ข้างต้น
ส่วนขยายเบราว์เซอร์ (Chrome & Firefox)
ส่วนขยาย YourImageShare Capture สำหรับ Chrome และ Firefox ไม่ต้องใช้ สคริปต์หรือไฟล์ตั้งค่าเลย แคปได้ทั้งพื้นที่ที่มองเห็น พื้นที่ที่ ลากเลือก หรือทั้งหน้าที่เลื่อนได้ แล้วเปิดตัวแก้ไขในตัวสำหรับ ลูกศร ข้อความ เบลอ/ปิดบังข้อมูล และคำอธิบายประกอบอื่น ๆ จากนั้นดาวน์โหลดผลลัพธ์ คัดลอกไปยังคลิปบอร์ด หรือเผยแพร่ไปยัง YourImageShare ได้ทันที ในคลิกเดียว การเผยแพร่ใช้ endpoint /api เดียวกับที่อธิบายไว้ ข้างต้น ใส่ API key ของคุณครั้งเดียวในการตั้งค่าของส่วนขยาย แล้วทุกครั้ง ที่เผยแพร่จะได้ลิงก์สำหรับแชร์ทันที ใช้ได้บน Chrome เดสก์ท็อป (และเบราว์เซอร์ Chromium อื่น ๆ) Firefox เดสก์ท็อป และ Firefox สำหรับ Android
รับ YourImageShare Capture สำหรับ Firefox รับ YourImageShare Capture สำหรับ Chrome
ShareX
ดาวน์โหลด custom uploader ด้านล่าง จากนั้นใน ShareX ไปที่ Destinations > Custom uploader settings > Import > from file เปิดไฟล์ .sxcu ที่ดาวน์โหลดมา แล้วแทนที่ YOUR_API_KEY ในช่อง Headers ด้วยคีย์จริงของคุณ ตั้งเป็นปลายทางสำหรับรูปภาพ/ไฟล์ แล้วภาพที่แคปจะอัพโหลดอัตโนมัติ
การลบ: ลิงก์ "Delete" ของ ShareX สำหรับแต่ละ การอัพโหลดจะเปิดหน้าลบของเราในเบราว์เซอร์ของคุณ (delete_url แบบใช้ครั้งเดียวของการอัพโหลดนั้น) คุณจึงลบภาพที่แคปได้จากประวัติของ ShareX โดยตรง หรือจะลบการอัพโหลดจาก บัญชีของฉัน ก็ได้ ดาวน์โหลดไฟล์ตั้งค่าไปก่อนเดือนตุลาคม 2026 ใช่หรือไม่? ดาวน์โหลดใหม่อีกครั้งเพื่อรับฟีเจอร์นี้
Flameshot (Linux)
เชลล์สคริปต์ขนาดเล็กที่รัน flameshot gui อัพโหลด ภาพที่แคป และคัดลอกลิงก์ไปยังคลิปบอร์ดของคุณ ผูกกับ ปุ่มลัดในเดสก์ท็อปของคุณแทนปุ่มลัดเริ่มต้นของ Flameshot
ดาวน์โหลด yis-flameshot-upload.sh
# One-time setup
chmod +x yis-flameshot-upload.sh
export YIS_API_KEY="YOUR_API_KEY" # or add to ~/.config/yourimageshare/api_key
# Then bind this to a hotkey instead of calling flameshot directly:
/path/to/yis-flameshot-upload.sh Greenshot (Windows)
สคริปต์ PowerShell สำหรับปลายทาง External command ในตัวของ Greenshot ใช้ได้กับ Windows PowerShell 5.1 ที่มาพร้อม Windows ไม่ต้องติดตั้งเพิ่ม
ดาวน์โหลด yis-greenshot-upload.ps1
# One-time setup
setx YIS_API_KEY "YOUR_API_KEY"
# In Greenshot: Preferences > Destinations > External command > Settings
# Command: powershell.exe
# Arguments: -ExecutionPolicy Bypass -File "C:\path\to\yis-greenshot-upload.ps1" "%1" ปลั๊กอินเว็บบอร์ด
เพิ่มปุ่ม "อัพโหลดรูป" จริง ๆ ไว้ข้างตัวแก้ไขโพสต์ของเว็บบอร์ดของคุณ ทุกตัวอัพโหลดผ่าน endpoint /api เดียวกัน ตามที่อธิบายไว้ข้างต้น และแทรก BBCode ที่ตำแหน่งเคอร์เซอร์ ไม่ต้องเปิดแท็บแยก ไม่ต้องคัดลอกและวางเอง
ด้านล่างนี้ให้ใช้คีย์สำหรับอัพโหลดอย่างเดียว ไม่ใช่ API key เต็มรูปแบบ ปลั๊กอินแต่ละตัวจะแสดงคีย์ในซอร์สของหน้าที่ผู้เข้าชมทุกคนเห็น และคีย์สำหรับอัพโหลดอย่างเดียว (บัญชีของฉัน > แท็บ API) ทำได้แค่อัพโหลด จึงแสดงรายการหรือลบการอัพโหลดของคุณไม่ได้ แม้มีคนคัดลอกคีย์ออกจากหน้าเว็บไป
การอัพโหลดจากเว็บบอร์ดเป็นแบบ private โดยค่าเริ่มต้น: รูปภาพแสดงในโพสต์ได้ แต่ YourImageShare จะไม่สร้างหน้าของตัวเองให้ (ไม่มีคอมเมนต์ รีแอคชัน หรือโฆษณา) ปลั๊กอินแต่ละตัวมีการตั้งค่าให้เปลี่ยนเป็น unlisted หากต้องการให้มีหน้าสำหรับ ทุกคนที่มีลิงก์ด้วย
phpBB
ส่วนขยาย phpBB 3.2/3.3 ตัวจริง แตกไฟล์ลงใน ext/ เปิดใช้งาน ที่ Customise > Manage extensions จากนั้นแทนที่ YOUR_UPLOAD_ONLY_KEY ในไฟล์ template event ของส่วนขยายด้วย คีย์สำหรับอัพโหลดอย่างเดียวจริงของคุณ
SMF (Simple Machines Forum)
แพ็กเกจ SMF ตัวจริง - ติดตั้งผ่าน Admin > Package Manager จากนั้นแทนที่ YOUR_UPLOAD_ONLY_KEY ใน Sources/yis_forumupload.php ด้วยคีย์สำหรับอัพโหลดอย่างเดียวจริงของคุณ
MyBB
ปลั๊กอิน MyBB 1.8 ตัวจริง คัดลอกลงใน inc/plugins/ เปิดใช้งานที่ Configuration > Plugins จากนั้นแทนที่ YOUR_UPLOAD_ONLY_KEY ในไฟล์ปลั๊กอินด้วยคีย์สำหรับอัพโหลดอย่างเดียว จริงของคุณ
FluxBB, PunBB & ZetaBoards
ระบบเหล่านี้ไม่มีระบบปลั๊กอินอย่างเป็นทางการ จึงเป็นสนิปเป็ตสั้น ๆ ที่วาง ลงในเทมเพลตของคุณโดยตรง (FluxBB/PunBB) หรือใน Admin CP (ZetaBoards) - มีคำแนะนำ แบบคัดลอกและวางครบถ้วนสำหรับแต่ละตัว:
คำแนะนำสำหรับ FluxBB คำแนะนำสำหรับ PunBB คำแนะนำสำหรับ ZetaBoards
ปลั๊กอิน WordPress
ย้ายคลังสื่อของคุณไปฝากไว้ที่ YourImageShare แทน ดิสก์ในเครื่อง การอัพโหลดรูปภาพ/วิดีโอใหม่จะผ่าน endpoint /api เดียวกัน ที่อธิบายไว้ข้างต้นโดยอัตโนมัติ ไฟล์ในเครื่อง (และภาพขนาดย่อทุกขนาดที่สร้างขึ้น) จะถูกลบเมื่อยืนยันการอัพโหลดแล้ว และ URL ของไฟล์แนบ WordPress ทุกรายการ - ตัวแก้ไขแบบบล็อก ภาพเด่น แกลเลอรี REST API - จะชี้ไปยัง ไฟล์ที่ฝากไว้ที่ YourImageShare ไม่ต้องใช้ shortcode ไม่ต้องเปลี่ยนขั้นตอนการทำงาน
- ย้ายคลังสื่อที่มีอยู่เดิมไปทั้งหมดในเบื้องหลัง (หรือด้วย
wp yis offload --all) ไม่ใช่แค่การอัพโหลดใหม่ - รูปภาพและวิดีโอที่อยู่ในโพสต์แล้วยังใช้งานได้ต่อไปหลังจากลบไฟล์ในเครื่องออก
- ภาพขนาดย่อและ srcset ใช้ภาพขนาดย่อ 280px ของเรา ช่องรูปเล็ก ๆ จึงไม่ต้องโหลดไฟล์ขนาดเต็ม
- ไฟล์ขนาดสูงสุด 200MB ส่งเป็นส่วน ๆ เพื่อไม่ให้วิดีโอขนาดใหญ่เป็นภาระต่อโฮสต์แบบแชร์
- คืนไฟล์ที่ย้ายไปแล้วกลับมาเก็บในเครื่องได้ทุกเมื่อ
- คอลัมน์ในคลังสื่อแสดงว่าไฟล์ไหนย้ายไปแล้วและไฟล์ไหนยังอยู่ในเครื่อง
- ไฟล์ที่ย้ายไปจะถูกเก็บเป็นแบบ private: โหลดได้ทุกที่ที่เว็บไซต์ของคุณใช้ แต่ไม่มีหน้าของตัวเองบน YourImageShare
ใช้คีย์สำหรับอัพโหลดอย่างเดียว ไม่ใช่ API key เต็มรูปแบบ API key เต็มรูปแบบ (ไม่บังคับ) จำเป็นเฉพาะเมื่อต้องการให้ไฟล์ที่ย้ายไปถูกลบ จาก YourImageShare เมื่อคุณลบใน WordPress
รับได้ที่ WordPress.org ดาวน์โหลดไฟล์ ZIP
ใน WordPress: Plugins > Add New ค้นหา YourImageShare Media Offload แล้วกด Install และ Activate
Shortcut สำหรับ iPhone & iPad
อัพโหลดจากหน้าต่างแชร์ของแอปใดก็ได้ - Photos, Files, Safari, ภาพหน้าจอ - แล้วรับลิงก์ไว้ใน คลิปบอร์ด ไม่ต้องติดตั้งแอปและไม่ต้องมีบัญชี
หากต้องการสร้างเองในแอป Shortcuts (ใช้เวลาประมาณสองนาที):
- สร้าง shortcut ใหม่ ตั้งชื่อว่า "Upload to YourImageShare" ในรายละเอียด ให้เปิด Show in Share Sheet และเลือกรับรูปภาพและสื่อ
- เพิ่ม Get Contents of URL: URL
https://yourimageshare.com/api/widgetเมธอดPOSTเนื้อหาคำขอเป็น Form พร้อมสองฟิลด์:uploads(File) = Shortcut Input และclient(Text) =ios-shortcut - เพิ่ม Get Dictionary Value สำหรับ
dataแล้วเพิ่มอีกอันสำหรับsrc- นั่นคือลิงก์โดยตรง - เพิ่ม Copy to Clipboard และ Show Notification ("Link copied")
หากไม่มีคีย์ การอัพโหลดจะเป็นแบบไม่ระบุตัวตนและ unlisted โดยมีขีดจำกัดรายวัน เพิ่ม header X-API-Key พร้อมคีย์สำหรับอัพโหลดอย่างเดียวของคุณ (บัญชีของฉัน > API) เพื่ออัพโหลดเข้าบัญชีของคุณ การตอบกลับยังมี delete_url หากต้องการเก็บลิงก์ลบไว้
PicGo & PicList
PicGo และ PicList อัพโหลดรูปภาพที่วางหรือลากมาให้ตัวแก้ไข Markdown - Typora, VS Code, Obsidian, Joplin - และใส่ลิงก์ลงในข้อความของคุณ ปลั๊กอินของเราทำให้ YourImageShare เป็นหนึ่งในที่ฝากรูปของเครื่องมือเหล่านี้
- ใน PicGo หรือ PicList: Plugins ค้นหา
yourimageshareติดตั้ง แล้วเลือก YourImageShare เป็นตัวอัพโหลด ผ่านบรรทัดคำสั่ง:picgo install yourimageshare - หรือดาวน์โหลดปลั๊กอินแล้วนำเข้าเป็นปลั๊กอินในเครื่อง (แตกไฟล์ก่อน)
- การตั้งค่า: คีย์สำหรับอัพโหลดอย่างเดียว (ไม่บังคับ - หากเว้นว่าง จะเป็นการอัพโหลดแบบไม่ระบุตัวตนและ unlisted) visibility และจะให้ส่งคืน ลิงก์รูปภาพโดยตรง (สำหรับ Markdown) หรือลิงก์หน้า
- ลิงก์ที่ส่งคืนยังคงใช้งานได้เมื่อรูปภาพขนาดใหญ่ถูกปรับให้เหมาะสมเป็น WebP ภายหลัง
บอท Telegram
รับลิงก์ของรูป วิดีโอ หรือ GIF โดยไม่ต้องออกจาก Telegram ส่งไปที่ @YourImageShare_bot แล้วลิงก์จะส่งกลับมาทันที ไม่ต้องมีบัญชีและไม่ต้องใช้ API key บอทอัพโหลดผ่าน endpoint /api เดียวกันตามที่อธิบายไว้ข้างต้น
- ส่งรูป วิดีโอ GIF หรือไฟล์รูปภาพหรือวิดีโอ อัลบั้มสูงสุด 10 ไฟล์จะตอบกลับในข้อความเดียว
- ในกลุ่ม ให้ตอบกลับรูปหรือวิดีโอด้วย
/linkแล้วบอทจะโพสต์ลิงก์ให้ทุกคน /autodeleteทำให้การอัพโหลดครั้งถัดไปของคุณลบตัวเองหลังผ่านไป 1 ชั่วโมง 1 วัน 1 สัปดาห์ หรือ 30 วัน- ทุกผลลัพธ์มีปุ่ม Delete ที่ใช้ได้เฉพาะผู้ที่อัพโหลดไฟล์เท่านั้น
- ลิงก์เป็นแบบ unlisted: เฉพาะผู้ที่มีลิงก์เท่านั้นที่เห็นไฟล์ได้
- บอทตอบเป็นภาษา Telegram ของคุณ เมื่อเว็บไซต์มีภาษานั้นให้ใช้
เก็บคุณภาพเต็ม: Telegram บีบอัดรูปที่ส่งแบบปกติ ส่งเป็นไฟล์ (📎 → File) แล้วจะอัพโหลดต้นฉบับ Telegram ให้บอทดึงไฟล์ได้สูงสุด 20 MB ดังนั้นไฟล์ที่ใหญ่กว่านั้นให้อัพโหลดบนเว็บไซต์
บอท Discord
เปลี่ยนรูป GIF หรือวิดีโอใน Discord ให้เป็นลิงก์ถาวร ลิงก์ไฟล์แนบของ Discord เองจะใช้ไม่ได้หลังจากผ่านไประยะหนึ่ง แต่ลิงก์ YourImageShare ไม่เป็นแบบนั้น ไม่ต้องมีบัญชีและไม่ต้องใช้ API key บอทอัพโหลดผ่าน endpoint /api เดียวกันตามที่อธิบายไว้ข้างต้น
/uploadพร้อมไฟล์: เลือกลบอัตโนมัติหลัง 1, 7 หรือ 30 วันได้ และใช้ only_me เพื่อแสดงลิงก์ให้คุณเห็นคนเดียว- คลิกขวาที่ข้อความ → Apps → Rehost on YourImageShare เพื่อฝากรูปภาพหรือวิดีโอจากข้อความนั้นได้สูงสุด 6 ไฟล์ในการตอบกลับเดียว
- เพิ่มเข้าเซิร์ฟเวอร์ หรือเพิ่มเข้าบัญชีของคุณเองเพื่อใช้ในแชทหรือ DM ใดก็ได้
- ทุกผลลัพธ์มีปุ่ม Delete ที่ใช้ได้เฉพาะผู้ที่อัพโหลดไฟล์เท่านั้น
- ลิงก์เป็นแบบ unlisted: เฉพาะผู้ที่มีลิงก์เท่านั้นที่เห็นไฟล์ได้
GitHub Action สำหรับ Playwright & Cypress
เมื่อการทดสอบ end-to-end ล้มเหลวใน pull request คุณดูสาเหตุได้โดยไม่ต้องดาวน์โหลดไฟล์ zip ของ artifact action นี้จะอัพโหลดภาพหน้าจอที่ล้มเหลวและภาพเปรียบเทียบความต่าง แล้วแสดงเป็นรูปภาพในคอมเมนต์เดียวของ pull request ซึ่งอัปเดตทุกครั้งที่รัน
- ใช้ได้กับ Playwright และ Cypress และตรวจจับเองว่าโปรเจกต์ใช้ตัวไหน
- การเปรียบเทียบภาพที่ล้มเหลวจะแสดงเป็น Expected, Actual และ Diff พร้อมลิงก์ไปยังสไลเดอร์ก่อน/หลัง (
toHaveScreenshotของ Playwright; สำหรับ Cypress คือปลั๊กอิน cypress-image-diff-js และ cypress-visual-regression) - คอมเมนต์จะเปลี่ยนเป็น "all tests passed" เมื่อแก้การทดสอบแล้ว และรายงานเดียวกันจะส่งไปยังสรุปของ job ด้วย
- ภาพหน้าจอเป็นแบบ private (เฉพาะไฟล์รูปภาพ ไม่มีหน้า) และจะถูกลบหลัง 30 วันโดยค่าเริ่มต้น
- ต้องใช้คีย์สำหรับอัพโหลดอย่างเดียวของคุณเป็น repository secret
YOURIMAGESHARE_API_KEYและจะไม่ทำให้การ build ของคุณล้มเหลว
- uses: yourimageshare/playwright-pr-screenshots@v1
if: always()
with:
api-key: ${{ secrets.YOURIMAGESHARE_API_KEY }} โปรเจกต์จากชุมชน
การเชื่อมต่อ YourImageShare ที่ดีที่สุดบางส่วนสร้างโดยผู้ที่ใช้งานจริง โปรเจกต์เหล่านี้ สร้างโดยสมาชิกในชุมชนด้วย API สาธารณะที่อธิบายไว้ข้างต้น ผู้สร้างเป็นผู้ดูแลเอง หากมีคำถามหรือต้องการแจ้งบั๊ก ให้ติดต่อผู้สร้างผ่านหน้าโปรเจกต์
- YourImageShare Uploads for FlatBB - ปลั๊กอินสำหรับเว็บบอร์ด FlatBB โดย madromas (MadWay Inc.)
- เพิ่มปุ่มอัพโหลดในตัวเขียนโพสต์ของ FlatBB: เลือกรูปภาพหรือวิดีโอหนึ่งไฟล์หรือมากกว่า แล้ว Markdown จะถูกแทรกที่ตำแหน่งเคอร์เซอร์
- แทรกแต่ละการอัพโหลดเป็นภาพขนาดย่อที่คลิกได้ รูปภาพขนาดเต็ม หรือลิงก์ธรรมดา (วิดีโอเป็นลิงก์)
- การอัพโหลดผ่านเซิร์ฟเวอร์เว็บบอร์ดของคุณด้วย API key สำหรับอัพโหลดอย่างเดียว คีย์จึงไม่ไปถึงเบราว์เซอร์ของผู้เข้าชม
- ไฟล์ถูกฝากไว้ที่ YourImageShare ไม่ใช่บนดิสก์ของเว็บบอร์ด โดยคุณเลือก visibility เริ่มต้นได้ (private, unlisted หรือ public)
- ใช้ร่วมกับตัวอัพโหลดของ FlatBB เองได้ โดยมีขีดจำกัดขนาดไฟล์แยกต่างหาก
ขอบคุณ
ขอขอบคุณทุกคนที่สร้างสรรค์สิ่งต่าง ๆ ด้วย YourImageShare และแบ่งปันผลงานให้ผู้อื่น โปรเจกต์จากชุมชนนำ YourImageShare ไปยังที่ที่เราไม่เคยไปถึงด้วยตัวเอง คุณสร้างอะไรไว้ ด้วย API หรือไม่? บอกเรา แล้วเรายินดีเพิ่มไว้ที่นี่
จากบล็อก
คู่มือและบทความแนะนำสำหรับนักพัฒนา
- อัพโหลดภาพหน้าจอทันทีด้วย ShareX, Flameshot หรือ Greenshot
- เพิ่มปุ่มอัพโหลดรูปจริงให้เว็บบอร์ด phpBB, SMF หรือ MyBB ของคุณ
- วิธีใช้ MCP: เชื่อมต่อ Claude, ChatGPT และ AI เอเจนต์กับ YourImageShare
- YourImageShare Capture: ส่วนขยายแคปหน้าจอสำหรับ Chrome และ Firefox
- ย้ายคลังสื่อ WordPress ของคุณไปฝากรูปฟรี
- บอท Telegram ของ YourImageShare: รับลิงก์ของรูปหรือวิดีโอใดก็ได้
พร้อมลองใช้แล้วหรือยัง?
รับ API key ของคุณ →