ข้อผิดพลาดของ API — แต่ละรหัสหมายถึงอะไรและแก้ไขอย่างไร
FastOG ส่งคืนรหัสข้อผิดพลาดที่เครื่องอ่านได้เมื่อคำขอล้มเหลว — ไม่ว่าจะเป็นการเรนเดอร์ OG image ที่ลงนามแล้ว หรือการเรียกไปยังหนึ่งในส่วนผู้ดูแลที่มาพร้อมผลิตภัณฑ์ ทุกการตอบกลับข้อผิดพลาดประกอบด้วย:
error— โทเค็นแบบสั้นรุ่นเดิม ยังคงมีอยู่ในการล้มเหลวทุกครั้งเพื่อให้ไคลเอนต์รุ่นเก่ายังทำงานได้code— รหัสข้อผิดพลาดเดียวกันที่มีความเสถียรและมีเอกสารกำกับ (ตารางด้านล่าง) ภายใต้ชื่อที่ API สาธารณะใช้งานmessage— คำอธิบายหนึ่งประโยคเกี่ยวกับสิ่งที่ผิดพลาดhint— คำอธิบายสั้น ๆ ด้วยภาษาธรรมดาเกี่ยวกับสิ่งที่ผิดพลาดและวิธีแก้ไขdocs_url— ลิงก์ไปยังหน้านี้ โดยชี้ไปยังส่วนของรหัสดังกล่าวrequest_id— เชื่อมโยงความล้มเหลวของ HTTP นี้กับแถวในตาราง Render Logs บนแดชบอร์ด (ส่งคืนในเฮดเดอร์การตอบกลับX-Request-IDด้วย) ส่วนที่ไม่มีอะไรให้เชื่อมโยงจะตอบกลับเป็นnullแต่คีย์นี้มีอยู่เสมอ
ส่วนผู้ดูแลที่มาพร้อมผลิตภัณฑ์ — Shopify admin, WooCommerce Studio, Wix bridge และเดโม — ตอบกลับ
ด้วยโครงเดียวกันสำหรับรหัสด้านล่าง ดังนั้นความล้มเหลวจึงหมายถึงสิ่งเดียวกันไม่ว่าจะพบที่ใด ส่วน
ของโมดูลอาจคงสถานะ HTTP ที่เคยส่งคืนสำหรับรหัสหนึ่งไว้ (ตัวอย่างเช่น render_failed
ตอบกลับ 503 สำหรับการส่งออกหน้าปก และ 502 สำหรับ API สาธารณะ) แต่รหัส ข้อความ คำแนะนำ และลิงก์เอกสารไม่เปลี่ยนแปลง
การอ่านการตอบกลับข้อผิดพลาด
{
"error": "invalid_signature",
"code": "invalid_signature",
"message": "The signature does not match.",
"hint": "The signature did not match. Re-sign with your HMAC secret after every param change.",
"request_id": "5f2a9c1e-..."
}
หากได้รับการตอบกลับที่ไม่เข้าใจ เส้นทางที่เร็วที่สุดคือ:
- บันทึก
codeไว้ - ตรวจสอบตัวสร้าง URL ของคุณ — ความล้มเหลวส่วนใหญ่เกิดจากบั๊กในการลงนาม ไม่ใช่ปัญหาเกี่ยวกับบัญชี
- จับคู่รหัสด้านล่างเพื่อหาสาเหตุและวิธีแก้ไขที่ตรงจุด
- ในแดชบอร์ด เปิด Render Logs แล้วกรองด้วย
error_codeเดียวกัน — แต่ละแถวจะแสดงพารามิเตอร์ที่ร้องขอ เพื่อให้สามารถทำซ้ำได้ (และยืนยันว่าrequest_idตรงกัน)
การลงนามและการยืนยันตัวตน
missing_signature
คำขอของคุณขาดพารามิเตอร์ query key และ/หรือ s (signature)
วิธีแก้ไข: ตรวจสอบให้แน่ใจว่า URL ของคุณมีทั้ง key=<api-key> และ s=<hmac-signature> ใช้ SDK หรือคู่มือแนะนำ /docs/hmac-signature-guide เพื่อสร้าง URL ดังกล่าว
invalid_signature
ค่า s ไม่ตรงกับค่าที่ HMAC secret ของคุณสร้างขึ้นสำหรับ URL นี้
วิธีแก้ไข: signature ครอบคลุม query param ทุกตัว ยกเว้น s โดยเรียงคีย์ตามลำดับ การเปลี่ยนแปลง param ใด ๆ — รวมถึงการสลับลำดับ ความแตกต่างของการเข้ารหัส URL หรือการเพิ่มช่องว่าง — จะทำให้ signature ไม่ถูกต้อง ต้องลงนามใหม่ทุกครั้งหลังการเปลี่ยนแปลง ตรวจสอบว่า secret ของคุณเป็นตัวเดียวกับที่แสดงตอนสร้าง API key
invalid_signature_format
ค่า s ไม่ใช่สตริง hex 64 ตัวอักษร
วิธีแก้ไข: signature ต้องเป็น SHA-256 hex แบบดิบ (ตัวพิมพ์เล็ก a-f0-9) หากคุณเข้ารหัสแบบ base64 หรือตัดทอนผลลัพธ์ ให้ใช้ hex แบบธรรมดา
expired_timestamp
timestamp t ที่คุณระบุมาเก่าเกิน 5 นาที
วิธีแก้ไข: สร้าง timestamp ใหม่ทุกครั้งที่สร้าง URL โค้ดนี้ใช้กับโฟลว์ signed-URL แบบเดิม โฟลว์ HMAC v2 ปัจจุบันไม่มี timestamp
invalid_api_key
key ที่คุณส่งมาไม่มีอยู่
วิธีแก้ไข: คัดลอก API key ทั้งหมดจากแดชบอร์ด — เป็นตัวระบุสาธารณะที่ขึ้นต้นด้วย sk_ ตัวระบุนี้เป็นสาธารณะและปลอดภัยเมื่ออยู่ใน URL ส่วน secret (ห้ามอยู่ใน URL เด็ดขาด) คือสิ่งที่พิสูจน์ความเป็นเจ้าของ
missing_hmac_secret
API key นี้ยังไม่ได้กำหนดค่า HMAC secret
วิธีแก้ไข: สร้าง API key ใหม่ในแดชบอร์ด — HMAC secret จะถูกสร้างและแสดงเพียงครั้งเดียวตอนสร้าง
พารามิเตอร์ / อินพุต
invalid_image_url
พร็อพที่บรรจุ URL (image, brand_logo, logo, avatar, background_image, ...) ไม่ใช่ URL แบบ http(s) สาธารณะ
วิธีแก้: ส่ง URL แบบ https://... ที่ดึงข้อมูลได้จากสาธารณะ ระบบจะปฏิเสธ localhost, IP ส่วนตัว และพาธเปล่า เพื่อป้องกันการปลอมแปลงคำขอฝั่งเซิร์ฟเวอร์
การสมัครสมาชิก
subscription_required (402)
คำขอเข้าถึง Dynamic API แล้ว แต่บัญชีของคุณไม่มีแพ็กเกจที่ใช้งานอยู่ การเข้าถึง API เป็นแบบ subscription-only: แพ็กเกจคือตัวกำหนดสิทธิ์ และมีระดับความครอบคลุม + ความสามารถแบบเดียวกับที่แอป FastOG จำหน่าย การเรนเดอร์เองไม่มีการคิดตามปริมาณ — ไม่มีโควตาการเรนเดอร์รายเดือนและไม่มีการเรียกเก็บเงินส่วนเกิน
วิธีแก้ไข: เลือกแพ็กเกจ Dynamic API ในแดชบอร์ดและสร้าง API key คำตอบจะมาพร้อม top_up_url ที่ชี้ไปยังหน้าของแพ็กเกจ
บริการเรนเดอร์
store_blocked (403)
การเรนเดอร์สำหรับร้านค้าที่อยู่เบื้องหลังคีย์นี้ถูกระงับโดย FastOG (เช่น การใช้งานในทางที่ผิดหรือการใช้งานเกินขอบเขต) แคชที่จัดเก็บไว้ที่ edge แล้วอาจยังให้บริการต่อไปได้จนกว่าจะหมดอายุ ติดต่อฝ่ายสนับสนุนเพื่อแก้ไขปัญหา ไม่มีสิ่งใดที่เปลี่ยนแปลงได้ในคำขอที่จะแก้ปัญหานี้ได้
render_unreachable
ไม่สามารถเข้าถึงบริการเรนเดอร์ได้ (ช่วงรีสตาร์ทสั้น ๆ)
วิธีแก้ไข: ลองใหม่อีกครั้งในอีกไม่กี่วินาที การเรนเดอร์ครั้งนี้ไม่ถูกนับ
render_failed
บริการเรนเดอร์ส่งคืนข้อผิดพลาดสำหรับคำขอ
วิธีแก้ไข: ตรวจสอบ props ของเทมเพลต — ค่าที่ยาวหรือมีรูปแบบไม่ถูกต้อง ฟิลด์ที่ไม่รองรับ หรือรูปภาพต้นทางที่เข้าถึงไม่ได้ การตอบกลับมี status ที่เป็นสาเหตุ underlying การเรนเดอร์ครั้งนี้ไม่ถูกนับ
พื้นผิวผู้ดูแลร้านค้า
รหัสเหล่านี้ตอบกลับจาก Shopify admin และ WooCommerce Studio — ตัวแก้ไขแบบฝังที่ผู้ค้าใช้งาน
แทนที่จะเป็น API ที่ลงนามแล้ว หลายรหัสใช้ร่วมกับ API สาธารณะ (invalid_image_url,
render_failed, invalid_signature); รหัสเหล่านั้นยังคงมีรายการที่บันทึกไว้ด้านบน
| รหัส | HTTP | ความหมายและสิ่งที่ต้องทำ |
|---|---|---|
invalid_shop |
422 | ไม่สามารถระบุร้าน Shopify ได้ ให้โหลดแอป FastOG ใหม่จาก Shopify admin เพื่อให้คำขอแบบ embedded แนบข้อมูลร้านมาอีกครั้ง แล้วลองใหม่ |
invalid_shop_or_page |
422 | ไม่รู้จักร้านหรือประเภทหน้า ให้เปิดแอป FastOG จาก Shopify admin และเลือกประเภทหน้าปกจากตัวแก้ไข |
invalid_store |
422 | ไม่สามารถระบุร้าน WooCommerce ได้ ให้เปิด Studio ใหม่จาก WordPress admin เพื่อให้ส่ง store token มาอีกครั้ง แล้วลองใหม่ |
invalid_store_or_page |
422 | ไม่รู้จักร้านหรือประเภทหน้า ให้เปิด Studio ใหม่จาก WordPress admin และเลือกประเภทหน้าปกที่ตัวแก้ไขมีให้ |
missing_api_key |
422 | ร้านยังไม่มี signing key ให้ติดตั้งปลั๊กอินให้เสร็จจาก WordPress admin เพื่อให้ FastOG ออก signing key ให้ร้านได้ |
store_ownership_unverified |
403 | ไม่สามารถยืนยันเว็บไซต์ WordPress ได้ เว็บไซต์ต้องเข้าถึงได้ผ่าน HTTPS สาธารณะและเปิดใช้งาน REST API ไว้ |
community_is_free |
422 | แผน Community ฟรี เป็นแผนเริ่มต้นแบบฟรีและไม่สามารถซื้อได้ ให้เลือกแพ็กเกจแบบเสียเงินเพื่ออัปเกรด |
not_installed |
404 | ยังไม่ได้ติดตั้ง FastOG สำหรับร้านนี้ ให้ติดตั้งแอป FastOG จาก Shopify App Store สำหรับร้านนี้ แล้วเปิดใหม่ |
oauth_required |
409 | ร้านต้องอนุญาต FastOG อีกครั้ง ให้รันการติดตั้ง FastOG OAuth ใหม่จาก Shopify admin เนื่องจากสิทธิ์ที่บันทึกไว้ถูกเพิกถอนหรือ scopes เปลี่ยนไป |
reconnect_required |
409 | ต้องสร้างการเชื่อมต่อ Shopify ใหม่ ให้ใช้ปุ่ม Reconnect ในแอป FastOG เพื่อออก access token ใหม่ |
token_rejected |
409 | Shopify ออก access token แล้วแต่กลับปฏิเสธ token นั้น ให้ลอง reconnect อีกครั้งหนึ่ง หาก Shopify ยังปฏิเสธอยู่ ให้ติดตั้งแอปใหม่ |
unauthorized |
401 | คำขอไม่มี session ที่ถูกต้องสำหรับ surface นี้ ให้โหลดแอป FastOG ใหม่จาก admin ของแพลตฟอร์มเพื่อแนบ session token ใหม่ แล้วลองใหม่ |
shop_not_found |
404 | ไม่มีร้านนี้อยู่ใน FastOG แล้ว ให้ติดตั้ง FastOG ใหม่จาก Shopify admin เพื่อสร้างข้อมูลร้านขึ้นมาใหม่ |
invalid_product |
422 | การอ้างอิงสินค้าไม่ถูกต้อง ให้โหลดหน้าสินค้าใหม่และเปิด FastOG ใหม่ เนื่องจาก product id ที่ส่งมาไม่มีหรือไม่ใช่ตัวเลข |
invalid_product_cover |
422 | payload ของหน้าปกสินค้ามีรูปแบบผิด ให้โหลดตัวแก้ไขใหม่และบันทึกอีกครั้ง โดย props, style และ signals ต้องเป็น object แต่ละรายการ |
product_not_found |
404 | ไม่สามารถอ่านสินค้าจากร้านได้ ให้ตรวจสอบว่าสินค้ายังมีอยู่และเผยแพร่แล้ว แล้วโหลดตัวแก้ไขใหม่ |
product_customization_not_on_plan |
403 | การปรับแต่งหน้าปกแยกตามสินค้าไม่มีในแผนนี้ ให้อัปเกรด หรือแก้ไขหน้าปกสินค้าแบบใช้ร่วมกันแทน |
no_product_handles |
422 | ไม่พบสินค้าที่จะรีเฟรช ให้เผยแพร่สินค้าอย่างน้อยหนึ่งรายการที่มี handle สาธารณะ แล้วลองรีเฟรช share preview อีกครั้ง |
invalid_style |
422 | บล็อก style ใช้งานไม่ได้ ให้โหลดตัวแก้ไขใหม่และเลือกสีและฟอนต์ใหม่ เนื่องจากมีค่าหนึ่งที่ไม่สามารถปรับให้เป็นรูปแบบมาตรฐานได้ |
invalid_template |
422 | template ที่ขอไม่มีอยู่ในแคตตาล็อกของแพลตฟอร์มนี้ ให้เลือกหนึ่งในเลย์เอาต์ที่ตัวแก้ไขมีให้ |
invalid_preset |
422 | ชื่อ preset ไม่ใช่ชื่อที่แพลตฟอร์มนี้มีให้ ให้เลือก preset จากหน้าตั้งค่า |
invalid_set |
422 | payload ของชุดหน้าปกหายไปหรือมีรูปแบบผิด ให้โหลดหน้าตั้งค่าใหม่และเลือกชุดอีกครั้ง |
preset_not_applyable |
422 | ไม่สามารถใช้ preset กับทุกประเภทหน้าได้ ให้เลือก preset อื่น เนื่องจาก preset นี้ขาดหน้าปกสำหรับอย่างน้อยหนึ่งประเภทหน้า |
template_not_available |
422 | template ไม่อยู่ในแคตตาล็อกที่เรนเดอร์ได้ ให้เลือกเลย์เอาต์ที่ตัวเลือกมีให้ |
template_not_available_on_shopify |
422 | template ไม่พร้อมใช้บนร้าน Shopify ให้เลือกเลย์เอาต์ที่ตัวแก้ไข Shopify มีให้ |
template_not_available_on_woocommerce |
422 | template ไม่พร้อมใช้บนร้าน WooCommerce ให้เลือกเลย์เอาต์ที่ Studio มีให้ |
template_unavailable |
422 | template ไม่พร้อมใช้สำหรับร้านนี้ ให้เลือกเลย์เอาต์ที่ตัวแก้ไขมีให้ เนื่องจาก template นี้ถูกยกเลิก ไม่รู้จัก หรือเกินกว่าที่ร้านสามารถวาดได้ |
template_not_on_plan |
403 | template ต้องใช้แผนที่สูงกว่า ให้เปลี่ยนแผน หรือเลือกเลย์เอาต์ที่แผนปัจจุบันครอบคลุม คำตอบระบุชื่อแผนไว้ใน requires |
template_requires_higher_plan |
403 | template ต้องใช้แผนที่สูงกว่า คำตอบระบุชื่อแผนไว้ใน requires |
no_rule |
404 | ยังไม่มีกฎหน้าปกสำหรับประเภทหน้านี้ ให้บันทึกหน้าปกสำหรับประเภทหน้านี้ในตัวแก้ไขก่อน |
cover_not_configured |
404 | ยังไม่ได้บันทึกหน้าปกสินค้า ให้บันทึกหน้าปกสินค้าก่อนดาวน์โหลดหรือแชร์ |
schedule_only_product |
422 | การตั้งเวลแคมเปญมีเฉพาะหน้าปกสินค้า ให้ลบวันที่ revert ออก หรือย้ายแคมเปญไปที่หน้าปกสินค้า |
not_dismissible |
422 | ไม่สามารถปิดประกาศนั้นได้ ให้โหลดหน้าใหม่ เนื่องจากประกาศถูกยกเลิกไปแล้วหรือเป็นของร้านอื่น |
unsupported_locale |
422 | ภาษาของ UI นั้นไม่ได้รวมอยู่ในแอปนี้ ให้เลือกหนึ่งในภาษาที่คำตอบระบุไว้ใน supported |
no_setup_sets |
422 | ไม่สามารถประกอบชุดหน้าปกที่คัดสรรได้ ให้ลองหน้าตั้งค่าอีกครั้ง หากยังว่างอยู่ ให้ติดต่อฝ่ายสนับสนุน |
export_unavailable |
403 | การดาวน์โหลดไม่มีในแผนนี้ ให้อัปเกรดเป็น Pro หรือสูงกว่าเพื่อดาวน์โหลดไฟล์หน้าปก |
cancellation_failed |
502 | การยกเลิกการสมัครสมาชิกถูกปฏิเสธ ให้ลองใหม่ในอีกสักครู่ หากยังล้มเหลวอยู่ ให้ยกเลิกจากหน้า Shopify billing หรือติดต่อฝ่ายสนับสนุน |
logo_override_on_plan |
403 | การแทนที่โลโก้ไม่มีในแผนนี้ ให้อัปเกรด หรือล้างการแทนที่โลโก้ |
invalid_logo |
422 | ไฟล์โลโก้ไม่ใช่รูปภาพที่รองรับ ให้อัปโหลด PNG, JPEG หรือ WebP ที่มีขนาดต่ำกว่าขีดจำกัดที่แสดงในตัวแก้ไข |
invalid_brand_image |
422 | รูปอ้างอิงแบรนด์ใช้งานไม่ได้ ให้อัปโหลดรูปภาพที่รองรับซึ่งมีขนาดต่ำกว่าขีดจำกัด หรือล้างรูปอ้างอิงแล้วบันทึกใหม่ |
brand_image_too_large |
422 | รูปอ้างอิงแบรนด์มีขนาดใหญ่เกินไป ให้ลดขนาดไฟล์แล้วอัปโหลดใหม่ |
brand_colors_too_many |
422 | มีการส่งสีแบรนด์มามากกว่าสามสี ให้ส่งสีแบบ hex ไม่เกินสามสี |
upload_failed |
500 | ไม่สามารถจัดเก็บไฟล์ที่อัปโหลดได้ ให้ลองใหม่ หากยังล้มเหลวอยู่ ให้ติดต่อฝ่ายสนับสนุน เนื่องจาก asset store ไม่ได้คืน public URL |
attachment_upload_failed |
500 | ไม่สามารถจัดเก็บไฟล์แนบของข้อความสนับสนุนได้ ให้ส่งข้อความโดยไม่มีไฟล์แนบ แล้วส่งไฟล์ทางอีเมลไปยังฝ่ายสนับสนุน |
invalid_webhook |
401 | ลายเซ็น webhook ของร้านไม่ผ่านการตรวจสอบ ให้ตรวจสอบว่า webhook secret ในการตั้งค่า FastOG บน WordPress ตรงกับที่ FastOG ออกให้ |
not_found |
404 | endpoint นั้นไม่มีอยู่แล้ว ให้เปิด Studio ใหม่จาก WordPress admin |
meta_refresh_unavailable |
503 | ยังไม่ได้ตั้งค่าการรีเฟรช share preview ให้แชร์ลิงก์ใหม่จาก Facebook แทน |
theme_write_disabled |
409 | การแก้ไขธีมไม่ได้เปิดใช้งานสำหรับแอปนี้ ให้ใช้ theme app embed แทนการแก้ไขไฟล์ธีม |
scope_required |
403 | FastOG ขาดสิทธิ์ของ Shopify ให้อนุมัติ scopes ที่ขอโดยใช้ consent_url ในคำตอบ แล้วลองแก้ไขอีกครั้ง |
บริดจ์ Wix
บริดจ์ Wix ถูกเซ็นโดยแอป Wix ไม่ใช่เซสชันของผู้ค้า ดังนั้นความล้มเหลวจึงถูกส่งถึงนักพัฒนาแอป
ทุกการตอบกลับยังคงมี code และ request_id; request id ของบริดจ์คือค่าจาก
envelope ที่ถูกเซ็น
| รหัส | HTTP | ความหมายและสิ่งที่ต้องทำ |
|---|---|---|
invalid_bridge_signature |
401 | ลายเซ็นบริดจ์ Wix ไม่ผ่านการตรวจสอบ สร้างคำขอใหม่ด้วย shared secret, path ที่ตรงกันทุกตัวอักษร และ timestamp ที่มีอายุไม่เกินห้านาที |
invalid_bridge_body |
400 | เนื้อหา envelope ของบริดจ์มีรูปแบบไม่ถูกต้อง ส่ง body เป็น JSON object และเข้ารหัสทุกตัวเลขภายในเป็นสตริง เพื่อให้ลายเซ็น canonical ตรงกัน |
replayed_bridge_request |
401 | คำขอบริดจ์นั้นถูกใช้ไปแล้ว สร้าง request_id ใหม่สำหรับทุกการเรียกที่เปลี่ยนแปลงข้อมูล |
wix_site_not_installed |
403 | FastOG ไม่ได้ติดตั้งบนไซต์ Wix นี้ ติดตั้งแอป FastOG บนไซต์แล้วเปิดใหม่ |
wix_site_not_provisioned |
422 | ไซต์ Wix ยังไม่มีข้อมูลรับรองสำหรับการเซ็น ส่งติดตั้งแอป FastOG ใหม่เพื่อให้ไซต์ได้รับการจัดเตรียม API key |
invalid_page_type |
422 | ประเภทหน้าไม่ใช่ประเภทที่ FastOG รองรับบน Wix ส่งประเภทหน้าหนึ่งในประเภทที่ Studio มีให้ |
rule_not_found |
404 | ไม่มีกฎที่มี id นั้น รีเฟรชรายการ; กฎถูกลบไปแล้วหรือเป็นของไซต์อื่น |
invalid_target_id |
422 | Wix target id ไม่ถูกต้องสำหรับประเภทหน้านี้ ส่ง id ที่แอป Wix จัดหาให้สำหรับประเภทหน้านั้น |
invalid_preview |
422 | payload ของตัวอย่างมีรูปแบบไม่ถูกต้อง อ่านออบเจกต์ details เพื่อดูฟิลด์ที่ผิดพลาด |
invalid_rule |
422 | payload ของกฎหน้าปกมีรูปแบบไม่ถูกต้อง อ่านออบเจกต์ details; template เป็นฟิลด์ที่จำเป็นและบล็อกที่เป็นทางเลือกต้องเป็นออบเจกต์ |
invalid_sync |
422 | payload ของการซิงก์มีรูปแบบไม่ถูกต้อง อ่านออบเจกต์ details; target_type และ target_id ต้องสอดคล้องกัน |
invalid_regenerate_url |
422 | ไม่มี URL ที่ต้องสร้างใหม่ ส่ง URL ของหน้าใน url |
invalid_regenerate_host |
422 | URL ไม่ได้อยู่ในโฮสต์ของ FastOG ส่ง URL หน้าปกของ fastog.com |
ai_presets_unsupported |
422 | ชุดหน้าปกที่ออกแบบด้วย AI ไม่ถูกสร้างแล้ว เลือกลุคที่คัดสรรแล้วแทน |
original_tags_required |
422 | จำเป็นต้องมีแท็ก metadata ดั้งเดิม ส่ง original_tags (หรือ current_tags) เพื่อให้การถอนการติดตั้งสามารถคืนค่า metadata ของไซต์ได้ |
invalid_restored |
422 | payload ของคีย์ที่คืนค่ามีรูปแบบไม่ถูกต้อง ส่ง restored เป็นอาร์เรย์ของคีย์ metadata |
invalid_seo_target |
422 | ประเภทเป้าหมาย SEO ไม่รู้จัก ใช้ site, pattern หรือ item ใน path |
invalid_seo_payload |
422 | payload ของ metadata SEO มีรูปแบบไม่ถูกต้อง ส่ง target_id, current_tags และ fastog_url เป็น URL แบบ absolute http(s) |
sync_failed |
500 | การซิงก์ metadata ไปยัง Wix ล้มเหลว ลองใหม่; หากยังล้มเหลวต่อเนื่อง ให้ตรวจสอบว่าไซต์เข้าถึงได้และแอปยังติดตั้งอยู่ |
invalid_tier |
422 | แพ็กเกจนั้นไม่ใช่แพ็กเกจที่ FastOG ขายบน Wix ส่ง starter, pro หรือ scale เป็น tier |
พื้นที่สาธิต
เดโมนี้เป็นคอนโซลการขายที่เฉพาะเจ้าของเท่านั้น ไม่ใช่ endpoint สำหรับร้านค้า
| รหัส | HTTP | ความหมายและสิ่งที่ต้องทำ |
|---|---|---|
url_required |
422 | ไม่ได้ส่ง URL มา ให้วางลิงก์ร้านค้าหรือสินค้าก่อนอ่านการ์ด |
unreadable_url |
422 | ไม่สามารถอ่านหน้านั้นได้ ตรวจสอบว่าลิงก์เป็นแบบสาธารณะและสมบูรณ์ หน้าเว็บที่อยู่หลังการเข้าสู่ระบบจะไม่สามารถอ่านได้ |
no_api_key |
422 | ไม่มี API key ที่ใช้ลงนามหน้าปกได้ ให้สร้าง API key (หรือป้อนอันที่ถูกต้อง) โดยการตอบกลับจะมีลิงก์ไปยังหน้า API keys |
no_presets |
500 | ยังไม่ได้กำหนดค่าพรีเซ็ตหน้าปก ให้กำหนดค่าพรีเซ็ตอย่างน้อยหนึ่งรายการบนเซิร์ฟเวอร์ |
รหัสตัวแก้ไขกฎแบบจำกัดขอบเขต
ตัวแก้ไขกฎแบบจำกัดขอบเขต (Shopify admin และ WooCommerce Studio) แปลโทเค็นเหล่านี้ด้วยตนเองเป็นภาษาของผู้ค้าเอง ดังนั้นการตอบกลับจึงมี error และ code แต่ไม่มี hint — คำอธิบายภาษาอังกฤษชุดที่สองจะคลาดเคลื่อนไปจากคำอธิบายที่แปลเป็นภาษาท้องถิ่นซึ่งผู้ค้าเห็นจริงเท่านั้น:
scope_already_defined, scoped_rule_limit_reached, scoped_rules_not_on_plan,
scope_value_required, scope_value_too_long, unknown_scope_type, base_rule_required,
scoped_rules_product_only, cannot_delete_base_rule.
ยังแก้ไม่ได้ใช่ไหม
- เปิดหน้า Render Logs ในแดชบอร์ด — ผลลัพธ์ทุกครั้ง (สำเร็จ + ถูกปฏิเสธ) จะแสดงพร้อม
error_code, สถานะ HTTP และพารามิเตอร์ที่ร้องขอ - รัน
php artisan og:diagnoseบน URL ที่ลงนามแล้วเพื่อไล่ทั้งไปป์ไลน์และดูว่าขั้นตอนใดล้มเหลว - ตรวจสอบเอกสารในแถบด้านข้างสำหรับเฟรมเวิร์กที่ใช้งาน (Next.js, Express, SvelteKit, ...)