ข้อมูลอ้างอิงข้อผิดพลาด
BlockVectra error codes, billing and retry guidance for JSON-RPC, Data API, Push Webhooks, console and faucet, including eth_getLogs block ranges and Webhook replay errors.
เอกสารอ้างอิงนี้รวบรวมรหัสข้อผิดพลาดทั้งหมดและค่า reason ที่เครื่องอ่านได้ในบริการต่างๆ ของ BlockVectra รวมถึงการระบุว่าคำขอที่ถูกปฏิเสธจะถูกคิดค่าบริการหรือไม่, นโยบายการลองใหม่, ระยะเวลา backoff และแนวทางปฏิบัติที่แนะนำสำหรับ AI agent และ automated client
สำหรับการประมวลผลด้วยโปรแกรม สามารถดึงแค็ตตาล็อกทั้งหมดในรูปแบบ JSON ได้ที่ /errors.json ทุกการตอบกลับข้อผิดพลาดที่มี docs_url จะลิงก์โดยตรงไปยังจุดยึด (anchor) ที่เสถียรบนหน้านี้: https://docs.blockvectra.com/en/errors/#<reason> (หรือ #-<code-number> สำหรับข้อผิดพลาดที่ไม่มีรหัส reason)
ข้อผิดพลาด JSON-RPC
| HTTP | รหัส | Reason | ความหมาย | คิดค่าบริการ | ลองใหม่ได้ | เวลาที่ต้องรอ (Retry-After) | การดำเนินการของ Agent |
|---|---|---|---|---|---|---|---|
| 401 | -32024 | missing_api_key | ไม่มี API key: ส่งในพาธคำขอ (/v1/{chain}/<api_key>) หรือในส่วนหัว x-api-key | ไม่ใช่ | ไม่ใช่ | — | สำหรับเอนด์พอยต์ JSON-RPC (/v1/{chain}) ให้ระบุ API key ในพาธคำขอ (/v1/{chain}/<api_key>) หรือในส่วนหัว x-api-key สำหรับ Top-up API (/v1/topup/*) ให้ระบุ API key ในส่วนหัว x-api-key เท่านั้น |
| 401 | -32024 | invalid_api_key | API key ไม่รู้จัก ถูกปิดใช้งาน หรือถูกเพิกถอน: ทั้ง JSON-RPC และ Data API จะส่งคืน HTTP 401 พร้อมโครงสร้างการตอบกลับข้อผิดพลาด invalid_api_key (JSON-RPC: error.code -32024 และ error.data.reason invalid_api_key; Data API: error.code และ error.data.reason invalid_api_key) | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบ API key; หากจำเป็น ให้เข้าสู่ระบบคอนโซลอีกครั้งหรือผ่านการสมัครแบบเป็นโปรแกรมเพื่อสร้างคีย์ใหม่ (ดู ทำเซสชันหรือ API key หาย?) |
| 403 | -32025 | key_expired | API key หมดอายุแล้ว สร้างคีย์ใหม่ในคอนโซล | ไม่ใช่ | ไม่ใช่ | — | API key หมดอายุแล้ว สร้างคีย์ใหม่ในคอนโซลหรือผ่านการสมัครแบบเป็นโปรแกรม |
| 403 | -32025 | key_cap_exhausted | ขีดจำกัด CU ตลอดอายุการใช้งานของ API key หมดลงแล้ว สร้างคีย์ใหม่ในคอนโซล | ไม่ใช่ | ไม่ใช่ | — | ขีดจำกัด CU ตลอดอายุการใช้งานของ API key ถูกใช้จนหมดแล้ว สร้างคีย์ใหม่ในคอนโซลหรือผ่านการสมัครแบบเป็นโปรแกรม |
| 503 | -32021 | auth_unavailable | ข้อมูลการยืนยันตัวตนไม่พร้อมใช้งานชั่วคราว | ไม่ใช่ | ใช่ | ปฏิบัติตามส่วนหัว Retry-After (วินาที) | เซิร์ฟเวอร์ไม่สามารถยืนยันคีย์ได้ชั่วคราว นี่ไม่ใช่ปัญหาที่คีย์ของคุณ ลองใหม่อีกครั้งหลังจากรอตาม Retry-After; อย่าสร้างคีย์ใหม่ |
| 404 | -32600 | unknown_chain | ไม่รู้จักเชนที่ระบุ | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบเชนที่พร้อมใช้งานผ่าน GET /v1/chains หรือเครื่องมือ list_chains; ตรวจสอบพาธ URL |
| 404 | 404 | unknown_endpoint | เมธอดและพาธของ Data API ไม่ตรงกับการดำเนินการที่รู้จัก | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบเมธอดและพาธ URL ตามเอกสาร Data API |
| 200 | -32700 | parse_error | ข้อผิดพลาดในการแยกวิเคราะห์ JSON | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบไวยากรณ์ JSON ที่ถูกต้องในเนื้อหาคำขอก่อนส่ง |
| 200 | -32600 | invalid_request | คำขอไม่ถูกต้อง | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบโครงสร้างคำขอ ตรวจสอบฟิลด์ jsonrpc: '2.0', id และ method ก่อนส่งใหม่ |
| 200 | -32602 | invalid_params | ไม่อนุญาตให้ใช้ Tracer ดังกล่าว | ไม่ใช่ | ไม่ใช่ | — | ปรับพารามิเตอร์ของเมธอด ตรวจสอบ tracer ที่รองรับและขีดจำกัดการหมดเวลาสำหรับเชน |
| 200 | -32602 | logs_range_too_large | ช่วงบล็อกของ eth_getLogs กว้างเกินไป: สูงสุด <N> บล็อก | ไม่ใช่ | ไม่ใช่ | — | จำกัดช่วงบล็อกของการสืบค้นให้อยู่ภายใน max_logs_block_range ที่ระบุใน GET /v1/chains |
| 429 | -32005 | public_rate_limit | เกินขีดจำกัดอัตราคำขอสาธารณะ | ไม่ใช่ | ใช่ | ปฏิบัติตามส่วนหัว Retry-After (วินาที) | รอตามส่วนหัว Retry-After แล้วลองใหม่อีกครั้ง หรือส่งคำขอพร้อม API key รับ API key. |
| 429 | -32005 | public_pool_busy | พูลเชนสาธารณะกำลังไม่ว่าง | ไม่ใช่ | ใช่ | ปฏิบัติตามส่วนหัว Retry-After หรือรอสักครู่แล้วลองใหม่ด้วย backoff | ลองใหม่อีกครั้งโดยใช้ backoff หรือส่งคำขอพร้อม API key รับ API key. |
| 200 | -32601 | method_not_public | เมธอดไม่พร้อมใช้งานบนเอนด์พอยต์สาธารณะ | ไม่ใช่ | ไม่ใช่ | — | ใช้เมธอดที่เอนด์พอยต์สาธารณะรองรับ หรือส่งคำขอพร้อม API key รับ API key. |
| 200 | -32601 | method_not_allowed | เมธอดไม่พร้อมใช้งานบนเชนนี้ หรือถูกปิดใช้งานตามนโยบาย | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบ methods.allow และ methods.deny ใน GET /v1/chains เพื่อดูเมธอดที่รองรับ การรองรับการส่งธุรกรรมถูกกำหนดโดย methods.allow ใน GET /v1/chains. ขณะนี้ยังไม่รองรับการส่งธุรกรรมบน: HyperEVM. |
| 200 | -32601 | subscription_not_available | การสมัครรับข้อมูล WebSocket ไม่พร้อมให้บริการบนเชนนี้ | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบการสมัครรับข้อมูลที่พร้อมใช้งานสำหรับเชนนี้ผ่าน GET /v1/chains |
| 200 | -32602 | logs_filter_required | การสมัครรับข้อมูล logs จำเป็นต้องระบุที่อยู่หรือ topic0 (ค่าที่ไม่เป็น null ในตำแหน่ง topic แรก) | ไม่ใช่ | ไม่ใช่ | — | ระบุที่อยู่หรือ topic0 ที่ไม่เป็น null ในตัวกรอง logs |
| 200 | -32600 | batch_too_large | แบทช์มีขนาดใหญ่เกินไป: สูงสุด <N> คำขอ | ไม่ใช่ | ไม่ใช่ | — | แบ่งแบทช์ออกเป็นชุดที่เล็กลงตามขีดจำกัดการเรียกสูงสุดที่ระบุไว้ในข้อมูลข้อผิดพลาด |
| 413 | 413 | request_too_large | เนื้อหาคำขอ Data API เกินขีดจำกัดขนาด | ไม่ใช่ | ไม่ใช่ | — | ลดขนาดเนื้อหาคำขอลง |
| 200 | -32000 | not_found | ไม่พบธุรกรรม | ไม่ใช่ | ไม่ใช่ | — | หากเพิ่งบรอดแคสต์หรือเพิ่งขุดบล็อก ให้รอการแพร่กระจายของเครือข่ายแล้วลองใหม่ มิฉะนั้นให้ตรวจสอบหมายเลขบล็อกหรือแฮช |
| 200 | -32011 | state_window | สถานะย้อนหลังไม่พร้อมใช้งานนอกช่วง <N> บล็อกล่าสุด | ไม่ใช่ | ไม่ใช่ | — | สืบค้นบล็อกภายใน state_window_blocks ที่เผยแพร่ใน GET /v1/chains หรือใช้ Data API สำหรับข้อมูลย้อนหลัง |
| 200 | -32011 | range_not_indexed | ประวัติที่ร้องขอยังไม่ได้รับการทำดัชนีอย่างสมบูรณ์ | ไม่ใช่ | ไม่ใช่ | — | จำกัดประวัติที่ร้องขอให้อยู่ในขอบเขตที่ทำดัชนีแล้ว อย่าลองส่งคำขอสำหรับช่วงที่ยังไม่ครอบคลุมซ้ำโดยไม่มีการเปลี่ยนแปลง |
| 200 | -32011 | history_not_ready | ประวัติที่ร้องขอยังไม่พร้อมใช้งาน | ไม่ใช่ | ใช่ | รอให้การทำดัชนีตามทันข้อมูล; ปฏิบัติตาม error.data.retry_after_seconds หากมี | ลองใหม่เมื่อการทำดัชนีตามทันข้อมูล รอตามจำนวนวินาทีใน error.data.retry_after_seconds หากระบุไว้ |
| 429 | -32005 | key_rate_limit | เกินขีดจำกัดอัตราความเร็ว CU ของ API key | ไม่ใช่ | ใช่ | ปฏิบัติตามส่วนหัว Retry-After (วินาที) | รอตามจำนวนวินาทีที่ระบุในส่วนหัว Retry-After ก่อนลองใหม่ หรือกระจายเวิร์กโหลด |
| 429 | rate_limited | rate_limited | เกินขีดจำกัดอัตราคำขอบน API หรือ GET /v1/account (มากกว่า 5 คำขอต่อวินาทีสำหรับคีย์นี้) | ไม่ใช่ | ใช่ | ปฏิบัติตามส่วนหัว Retry-After (วินาที) | รอตามระยะเวลาที่ระบุใน Retry-After ก่อนลองใหม่อีกครั้ง |
| 429 | -32005 | concurrency_limit | เกินขีดจำกัดคำขอที่ประมวลผลพร้อมกัน | ไม่ใช่ | ใช่ | ปฏิบัติตามส่วนหัว Retry-After หรือรอให้คำขอที่กำลังทำงานอยู่เสร็จสิ้น | จำกัดขนาดพูลคำขอพร้อมกันของไคลเอนต์และลองใหม่อีกครั้งเมื่อมีที่ว่าง |
| 429 | -32005 | free_plan_call_limit | เกินขีดจำกัดจำนวนคำขอต่อวินาทีของแพ็กเกจฟรี | ไม่ใช่ | ใช่ | รอ 1 วินาทีก่อนลองใหม่ | ลดอัตราความถี่ของคำขอ หรือเติมเงินเพื่อปลดล็อกทรูพุตแบบชำระเงิน |
| 429 | -32022 | request_exceeds_burst | ค่าใช้จ่ายของคำขอ <N> CU เกินความจุ burst <M> CU | ไม่ใช่ | ไม่ใช่ | — | การรอจะไม่ช่วยแก้ปัญหานี้; ให้แบ่งแบทช์หรือลดพารามิเตอร์ของเมธอดเพื่อให้อยู่ในความจุ burst |
| 429 | -32022 | free_plan_batch_too_large | คำขอมี <N> การเรียก ซึ่งเกินขีดจำกัดแพ็กเกจฟรี <M> คำขอต่อวินาที | ไม่ใช่ | ไม่ใช่ | — | การรอจะไม่ช่วยแก้ปัญหานี้; ให้แบ่งแบทช์เพื่อให้จำนวนคำขออยู่ภายในขีดจำกัดแพ็กเกจฟรี หรือทำการเติมเงิน |
| 429 | -32005 | ws_connection_limit | ถึงขีดจำกัดการเชื่อมต่อ WebSocket สำหรับคีย์หรือบัญชีนี้แล้ว | ไม่ใช่ | ไม่ใช่ | — | ปิดการเชื่อมต่อ WebSocket ที่ไม่ได้ใช้ หรือนำการเชื่อมต่อที่มีอยู่เดิมกลับมาใช้ใหม่ |
| 200 | -32022 | subscription_limit | ถึงขีดจำกัดการสมัครรับข้อมูล WebSocket สำหรับการเชื่อมต่อนี้แล้ว | ไม่ใช่ | ไม่ใช่ | — | ยกเลิกการสมัครรับข้อมูลเหตุการณ์ที่ไม่จำเป็นอีกต่อไป หรือเปิดการเชื่อมต่อ WebSocket ใหม่ |
| 200 | -32005 | ws_filter_capacity | ตัวกรอง WebSocket logs ถึงความจุสูงสุดแล้ว | ไม่ใช่ | ไม่ใช่ | — | ยกเลิกการสมัครรับข้อมูล logs ที่มีอยู่เดิมหนึ่งรายการ หรือใช้ตัวกรองที่เจาะจงมากขึ้น |
| 200 | -32026 | ws_push_overloaded | คิวแจ้งเตือน WebSocket มีภาระงานหนักเกินไป | ไม่ใช่ | ใช่ | ลองใหม่อีกครั้งในภายหลังด้วย backoff หรือเชื่อมต่อใหม่ | ลองเรียกใช้ eth_subscribe อีกครั้งด้วย exponential backoff หรือเชื่อมต่อใหม่ การสมัครรับข้อมูลเดิมจะยังคงได้รับข้อความแจ้งเตือนต่อไป |
| 200 | -32005 | overloaded | บริการมีภาระงานหนักเกินไป โปรดลองใหม่ในภายหลัง | ไม่ใช่ | ใช่ | รอสักครู่แล้วลองใหม่ด้วย exponential backoff | ใช้ backoff ร่วมกับ jitter แล้วลองส่งคำขอใหม่อีกครั้ง |
| 402 | -32020 | balance_exhausted | ยอดคงเหลือไม่เพียงพอ (เมื่อทราบยอดคงเหลือ error.data จะรวม balance_units และ balance_cu) | ไม่ใช่ | ไม่ใช่ | — | เติมเงินออนเชน: รับที่อยู่เติมเงินจากคอนโซลหรือ `GET /v1/topup/deposit-address` (MCP `get_deposit_address`); ดู คู่มือการเติมเงินสำหรับ Agent หรือรีเซ็ตโควตาในคอนโซลหากมีสิทธิ์ เมื่อทราบยอดคงเหลือ error.data จะมี balance_units (ติดลบเมื่อใช้วงเงินเกิน) และ balance_cu |
| 402 | -32020 | free_grant_exhausted | โควตาฟรีหมดลงแล้ว (เมื่อทราบยอดคงเหลือ error.data จะรวม balance_units และ balance_cu) | ไม่ใช่ | ไม่ใช่ | — | เติมเงินออนเชน: รับที่อยู่เติมเงินจากคอนโซลหรือ `GET /v1/topup/deposit-address` (MCP `get_deposit_address`); ดู คู่มือการเติมเงินสำหรับ Agent รีเซ็ตโควตาหากพร้อมใช้งาน หรือรอโควตาของรอบถัดไป เมื่อทราบยอดคงเหลือ error.data จะมี balance_units (ติดลบเมื่อใช้วงเงินเกิน) และ balance_cu |
| 503 | -32021 | billing_unavailable | ข้อมูลการเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว | ไม่ใช่ | ใช่ | ปฏิบัติตามส่วนหัว Retry-After (วินาที) | นี่ไม่ใช่ปัญหาเกี่ยวกับยอดคงเหลือ; คีย์ที่สร้างขึ้นใหม่จะได้รับการซิงค์ภายในไม่กี่วินาที รอตาม Retry-After แล้วลองใหม่ |
| 200 | -32010 | node_syncing | โหนดกำลังซิงค์ข้อมูล; คำขอไม่พร้อมให้บริการชั่วคราว | ไม่ใช่ | ใช่ | รอสักครู่แล้วลองใหม่อีกครั้ง | รอให้โหนดซิงค์เสร็จสิ้น หรือตรวจสอบ GET /v1/status |
| 200 | -32603 | upstream_unavailable | บริการต้นทางไม่พร้อมใช้งาน | ไม่ใช่ | ใช่ | รอสักครู่แล้วลองใหม่อีกครั้ง | ลองใหม่อีกครั้งด้วย exponential backoff; ตรวจสอบ GET /v1/status เพื่อดูความสมบูรณ์ของโหนด |
| 504 | 504 | upstream_timeout | บริการต้นทางไม่ตอบสนองภายในขีดจำกัดเวลา | ไม่ใช่ | ใช่ | ลองใหม่อีกครั้งหลังจากหน่วงเวลาสั้นๆ | ลองส่งคำขอใหม่อีกครั้งด้วย exponential backoff |
| 200 | -32000 | response_too_large | การตอบกลับจากต้นทางมีขนาดใหญ่เกินไป | ไม่ใช่ | ไม่ใช่ | — | จำกัดพารามิเตอร์การสืบค้นให้แคบลง (เช่น ลดช่วงบล็อกใน eth_getLogs หรือร้องขอ trace ที่มีขนาดเล็กลง) |
| 200 | -32603 | internal_error | เกิดข้อผิดพลาดของบริการภายใน | ไม่ใช่ | ไม่ใช่ | — | ลองส่งคำขอใหม่อีกครั้ง; รายงานข้อผิดพลาดที่เกิดขึ้นต่อเนื่องไปยังฝ่ายสนับสนุนพร้อมระบุเวลาที่เกิดเหตุการณ์ |
| 200 | 4444 | — | ประวัติที่ถูกตัดทอน (pruned) ไม่พร้อมใช้งาน | ไม่ใช่ | ไม่ใช่ | — | บล็อกอยู่นอกช่วงประวัติที่เก็บรักษาไว้ของโหนดที่ตัดทอนข้อมูล; สืบค้นบล็อกประวัติผ่าน Data API |
| 200 | -32000 | — | สถานะย้อนหลังไม่พร้อมใช้งาน; ข้อมูลเก่าไม่พร้อมใช้งานเนื่องจากการตัดทอนข้อมูล | ไม่ใช่ | ไม่ใช่ | — | สืบค้นบล็อกภายในช่วงสถานะ หรือใช้ Data API สำหรับการสืบค้นข้อมูลย้อนหลัง |
| 200 | -32002 | — | <node message> | ไม่ใช่ | ใช่ | รอสองสามวินาทีแล้วลองใหม่ด้วยแบทช์ที่มีขนาดเล็กลง | ลดจำนวนคำขอในแบทช์ลงแล้วลองใหม่อีกครั้ง |
| 200 | -32003 | — | <node message> | ไม่ใช่ | ไม่ใช่ | — | แบ่งแบทช์ออกเป็นคำขอย่อยๆ เพื่อลดขนาดของการตอบกลับ |
| 200 | -32601 | — | <node message> | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบ methods.allow และ methods.deny ใน GET /v1/chains เพื่อดูเมธอดที่รองรับ การรองรับการส่งธุรกรรมถูกกำหนดโดย methods.allow ใน GET /v1/chains. ขณะนี้ยังไม่รองรับการส่งธุรกรรมบน: HyperEVM. |
| 200 | -32603 | — | <node message> | ไม่ใช่ | ใช่ | ลองใหม่อีกครั้งหลังจากหน่วงเวลาสั้นๆ | ลองส่งคำขอใหม่อีกครั้ง; รายงานข้อผิดพลาดที่เกิดขึ้นต่อเนื่องไปยังฝ่ายสนับสนุนพร้อมระบุเวลาที่เกิดเหตุการณ์ |
| 200 | -32600 | — | <node message> | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบแต่ละคำขอในแบทช์เพื่อหาพารามิเตอร์ที่ไม่ถูกต้อง; แบ่งชุดคำขอแล้วลองใหม่ |
| 200 | * | — | <node message> | ใช่ | ไม่ใช่ | — | โหนดได้ดำเนินการประมวลผลแล้วและคำขอได้รับการคิดค่าบริการแล้ว ตรวจสอบเหตุผล/ข้อมูล revert หรือพารามิเตอร์ของคำขอ; อย่าลองส่งคำขอเดิมซ้ำโดยไม่ได้ตรวจสอบ |
| 408 | 408 | — | คำขอหมดเวลาหลังจาก 35 วินาทีระหว่างการเสร็จสิ้นส่วนหัวของคำขอและการตอบกลับ | เป็นไปได้ | ใช่ | รอสองสามวินาทีก่อนลองใหม่สำหรับคำขออ่าน | คำขออาจส่งถึงโหนดและถูกคิดค่าบริการแล้ว สำหรับคำขออ่าน ให้ลองใหม่ด้วย backoff สำหรับคำขอเขียน (เช่น eth_sendRawTransaction) ให้ตรวจสอบสถานะธุรกรรมด้วยแฮชก่อน |
รหัสปิดการเชื่อมต่อ WebSocket
รหัสปิดการเชื่อมต่อ WebSocket และการดำเนินการที่แนะนำสำหรับไคลเอนต์
| รหัส | Reason | ความหมาย | ลองใหม่ได้ | เวลาที่ต้องรอ (Retry-After) | การดำเนินการของ Agent |
|---|---|---|---|---|---|
| 1001 | — | การเชื่อมต่อไม่ได้ใช้งาน (idle) | ใช่ | เชื่อมต่อใหม่เมื่อจำเป็น | เชื่อมต่อใหม่เมื่อจำเป็น |
| 1003 | — | ไม่ยอมรับเฟรมไบนารี | ไม่ใช่ | — | อย่าเชื่อมต่อใหม่โดยอัตโนมัติ; ส่งเฉพาะเฟรมข้อความ UTF-8 เท่านั้น |
| 1009 | — | ข้อความมีขนาดใหญ่เกินไป | ไม่ใช่ | — | อย่าเชื่อมต่อใหม่โดยอัตโนมัติ; แบ่งคำขอขนาดใหญ่ออกเพื่อไม่ให้เกิน 1 MiB |
| 1012 | — | บริการเริ่มต้นใหม่ | ใช่ | เชื่อมต่อใหม่ด้วย backoff ร่วมกับ jitter | เชื่อมต่อใหม่ด้วย backoff ร่วมกับ jitter สมัครรับข้อมูลใหม่อีกครั้ง และสืบค้นข้อมูลที่ขาดหายไปเพื่อเติมเต็ม |
| 1013 | — | เชนไม่พร้อมใช้งาน; มีภาระงานหนักเกินไป | ใช่ | เชื่อมต่อใหม่ด้วย exponential backoff และ full jitter | เชื่อมต่อใหม่ด้วย exponential backoff และ full jitter สมัครรับข้อมูลใหม่อีกครั้ง และสืบค้นข้อมูลที่ขาดหายไปเพื่อเติมเต็ม |
| 4402 | — | ยอดคงเหลือไม่เพียงพอ | ไม่ใช่ | — | อย่าเชื่อมต่อใหม่โดยอัตโนมัติ; เติมเงินออนเชน: รับที่อยู่เติมเงินจากคอนโซลหรือ `GET /v1/topup/deposit-address` (MCP `get_deposit_address`); ดู คู่มือการเติมเงินสำหรับ Agent หรือรีเซ็ตโควตาในคอนโซลหากมีสิทธิ์ |
| 4404 | — | API key ไม่ถูกต้อง | ไม่ใช่ | — | อย่าเชื่อมต่อใหม่โดยอัตโนมัติ; ตรวจสอบหรือสลับหมุนเวียน API key ในคอนโซล |
| 4408 | — | บริการปิดเซสชันเมื่อคิว push เกิน 512 KiB (524,288 ไบต์) และยกเลิกข้อความที่รอดำเนินการ; ไคลเอนต์อาจไม่ได้รับเฟรมปิด (เบราว์เซอร์รายงาน 1006); ให้จัดการกับการตัดการเชื่อมต่อที่ไม่คาดคิดเช่นเดียวกับ 4408 | ใช่ | เชื่อมต่อใหม่ด้วย backoff; ลดการสมัครรับข้อมูลหรืออ่านข้อมูลให้เร็วขึ้น | จัดการกับการตัดการเชื่อมต่อที่ไม่คาดคิดโดยไม่มีเฟรมปิด (เบราว์เซอร์รายงาน 1006) เช่นเดียวกับ 4408: เชื่อมต่อใหม่ด้วย backoff สร้างการสมัครรับข้อมูลใหม่ และสืบค้นข้อมูลที่ขาดหายไปด้วย eth_getLogs; ลดการสมัครรับข้อมูลหรืออ่านข้อมูลให้เร็วขึ้น |
| 4429 | — | เกินอัตราความเร็ว push | ใช่ | เชื่อมต่อใหม่ด้วย backoff หรือลดการสมัครรับข้อมูล | ลดการสมัครรับข้อมูลหรือเชื่อมต่อใหม่ด้วย backoff |
| 4503 | — | บริการเรียกเก็บเงินไม่พร้อมใช้งาน | ใช่ | เชื่อมต่อใหม่ด้วย exponential backoff และ full jitter | เชื่อมต่อใหม่ด้วย exponential backoff และ full jitter แล้วสมัครรับข้อมูลใหม่อีกครั้ง |
ข้อผิดพลาด Data API
ข้อผิดพลาดที่ส่งคืนโดยเอนด์พอยต์ Blockchain Data API ภายใต้ /v1/data/{chain}/
| HTTP | รหัส | Reason | ความหมาย | คิดค่าบริการ | ลองใหม่ได้ | เวลาที่ต้องรอ (Retry-After) | การดำเนินการของ Agent |
|---|---|---|---|---|---|---|---|
| 400 | bad_request | — | พารามิเตอร์การสืบค้นซ้ำซ้อน สตริงการสืบค้นไม่ถูกต้อง หรือคำขอมีรูปแบบที่ไม่ถูกต้อง | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบพารามิเตอร์การสืบค้น ให้แน่ใจว่าพารามิเตอร์เช่น limit ปรากฏไม่เกินหนึ่งครั้ง และพารามิเตอร์ทั้งหมดถูกต้อง |
| 409 | not_indexed_yet | — | หมายเลขบล็อกหรือช่วงเวลาที่ร้องขอเกิน as_of_block หรือแฮชที่ถูกแปลงเกิน as_of_block (พร้อม indexed_through เว้นแต่เชนจะยังไม่มีการทำดัชนีบล็อกใดๆ) | ไม่ใช่ | ใช่ | รอสองสามวินาทีจนกว่า indexed_through จะถึงบล็อกที่ร้องขอ | โพลล์จนกว่าบล็อกที่ร้องขอหรือ to_block จะไม่มากกว่า indexed_through หรือรอให้เชนเริ่มบันทึกบล็อก |
| 409 | window_too_large | — | ช่วงบล็อกกว้างเกิน 100,000 บล็อก และไม่ได้ตั้งค่า clamp เป็น true | ไม่ใช่ | ไม่ใช่ | — | จำกัดช่วงบล็อก (from_block ถึง to_block) ให้แคบลงเหลือ <= 100,000 บล็อก หรือส่ง clamp=true |
| 409 | too_many_pools | — | โทเค็นตรงกับสภาพคล่องมากกว่า 200 พูล โปรดสืบค้นตามมุมมองพูลแทน | ไม่ใช่ | ไม่ใช่ | — | ระบุพูลที่ต้องการสืบค้นโดยเฉพาะแทนการสืบค้นโทเค็นทั่วไป |
| 409 | span_exceeded | — | ช่วงเวลาวันที่ร้องขอเกินขีดจำกัดสูงสุด 90 วัน | ไม่ใช่ | ไม่ใช่ | — | ลดช่วงวันจาก from_time ถึง to_time ให้เหลือไม่เกิน 90 วัน |
| 422 | no_coverage | — | คุณลักษณะนี้ไม่รองรับบนเชนนี้ หรือบล็อกที่ร้องขออยู่ก่อนช่วงข้อมูลที่ครอบคลุม | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบ `features` และ `coverage.from_block` ใน GET /v1/data/chains (หรือ `data_features` ใน GET /v1/status ของแผนฟรี) ก่อนที่จะสืบค้น |
| 503 | unavailable | — | บริการ Data API ไม่พร้อมใช้งานชั่วคราว | ไม่ใช่ | ใช่ | รอสักครู่แล้วลองใหม่ด้วย exponential backoff | ลองใหม่อีกครั้งหลังจากหน่วงเวลาสั้นๆ โดยใช้ exponential backoff |
| 402 | insufficient_balance | — | ยอดคงเหลือแบบชำระเงินหรือโควตาฟรีหมดลงแล้ว (เมื่อทราบยอดคงเหลือ error.data จะรวม balance_units และ balance_cu) | ไม่ใช่ | ไม่ใช่ | — | เติมเงินออนเชน: รับที่อยู่เติมเงินจากคอนโซลหรือ `GET /v1/topup/deposit-address` (MCP `get_deposit_address`); ดู คู่มือการเติมเงินสำหรับ Agent หรือรอการเติมโควตาฟรีรอบถัดไป |
| 429 | cost_exceeds_burst | — | คำขอเดียวมีค่าใช้จ่ายมากกว่าความจุ burst ของคีย์ | ไม่ใช่ | ไม่ใช่ | — | แบ่งคำขอออกเป็นคำขอย่อยๆ ที่เล็กลง การลองส่งคำขอเดิมซ้ำจะไม่สำเร็จ |
| 503 | gateway_overloaded | — | ความจุของ Data API ไม่พร้อมใช้งานชั่วคราว | ไม่ใช่ | ใช่ | ลองใหม่โดยใช้ backoff (Retry-After: 1) | ลดคำขอที่ส่งพร้อมกันข้ามคีย์และเชนต่างๆ ของบัญชีนี้ รอตาม Retry-After ก่อนลองใหม่ error.data.reason จะเป็น null |
ข้อผิดพลาด Console, บัญชี และ Faucet API
ข้อผิดพลาดที่ส่งคืนโดยเอนด์พอยต์การจัดการ, การจัดสรรคีย์, การยืนยันตัวตน และ faucet ภายใต้ /v1/
| HTTP | รหัส | Reason | ความหมาย | คิดค่าบริการ | ลองใหม่ได้ | เวลาที่ต้องรอ (Retry-After) | การดำเนินการของ Agent |
|---|---|---|---|---|---|---|---|
| 409 | topup_disabled | — | ระบบเติมเงินถูกระงับชั่วคราว หรือขณะนี้ไม่มีเครือข่ายที่พร้อมใช้งานสำหรับการเติมเงิน ไม่สามารถจัดสรรที่อยู่ใหม่ได้ แต่ที่อยู่ที่ได้รับการจัดสรรไว้แล้วยังคงกำหนดให้กับบัญชีเดิม | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบความพร้อมใช้งานของการเติมเงินผ่าน GET /v1/topup/status แล้วลองใหม่ภายหลังเมื่อเปิดใช้งานการเติมเงิน |
| 503 | deposit_unavailable | — | ไม่สามารถจัดสรรที่อยู่สำหรับเติมเงินได้ชั่วคราว โปรดลองใหม่ตามส่วนหัว Retry-After | ไม่ใช่ | ใช่ | ปฏิบัติตามส่วนหัว Retry-After (วินาที) และใช้ exponential backoff | ลองใหม่ตามส่วนหัว Retry-After โดยใช้ exponential backoff |
| 400 | invalid_request | invalid_username | รูปแบบชื่อผู้ใช้ไม่ถูกต้อง (ต้องเป็นตัวอักษร ตัวเลข หรือขีดล่าง) | ไม่ใช่ | ไม่ใช่ | — | ระบุชื่อผู้ใช้ที่ถูกต้องตามข้อกำหนดของอักขระและความยาว |
| 400 | invalid_request | expires_at | เวลาหมดอายุของคีย์ไม่ได้อยู่ในอนาคต หรือเกินระยะเวลาใช้งานสูงสุดที่อนุญาต | ไม่ใช่ | ไม่ใช่ | — | กำหนด expires_at เป็นเวลา RFC 3339 ในอนาคตภายในระยะเวลาที่อนุญาต (ค่าเริ่มต้น 365 วัน) หรือใช้ expires_in_secs |
| 400 | invalid_request | cu_cap | พารามิเตอร์ cu_cap อยู่นอกช่วงที่กำหนด (ต้องเป็นจำนวนเต็มระหว่าง 1 ถึง 9007199254740991) | ไม่ใช่ | ไม่ใช่ | — | กำหนด cu_cap เป็นจำนวนเต็มระหว่าง 1 ถึง 9007199254740991 หรือละเว้นเพื่อไม่จำกัด CU |
| 400 | siwe_invalid | expired | ข้อความ Sign-In with Ethereum (SIWE) หมดอายุแล้ว หรือ nonce ถูกใช้งานไปแล้ว | ไม่ใช่ | ใช่ | รับคำท้า (challenge) ใหม่ทันทีแล้วลงนาม | ขอคำท้าใหม่จาก /v1/auth/siwe/challenge แล้วลงนามในข้อความที่ออกให้ใหม่ |
| 400 | siwe_invalid | chain_mismatch | chainId ในข้อความ SIWE ไม่ตรงกับการตั้งค่าของเซิร์ฟเวอร์ | ไม่ใช่ | ไม่ใช่ | — | ใช้ chainId ที่ส่งคืนจาก /v1/auth/siwe/challenge เมื่อสร้างข้อความ SIWE |
| 400 | siwe_invalid | domain_mismatch | domain ในข้อความ SIWE ไม่ตรงกับโฮสต์ของเซิร์ฟเวอร์ | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบให้แน่ใจว่า domain และ uri ตรงกับโฮสต์ของเซิร์ฟเวอร์ที่ส่งคืนในคำท้า |
| 400 | siwe_invalid | signature | การตรวจสอบลายเซ็นการเข้ารหัสลับ SIWE ล้มเหลว | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบให้แน่ใจว่าข้อความได้รับการลงนามด้วยคีย์ส่วนตัวที่ตรงกับที่อยู่ที่ระบุ |
| 409 | key_limit_reached | active_keys | จำนวน API key ที่ใช้งานอยู่ (ยังไม่ถูกเพิกถอน) ถึงขีดจำกัดสูงสุดของบัญชีแล้ว | ไม่ใช่ | ไม่ใช่ | — | เพิกถอนคีย์เดิมที่ไม่ได้ใช้งานก่อนสร้างคีย์ใหม่ |
| 409 | no_reset_available | nothing_to_reset | ยอดคงเหลือเท่ากับหรือสูงกว่าเป้าหมายการรีเซ็ตอยู่แล้ว สิทธิ์การรีเซ็ตจะยังคงถูกเก็บรักษาไว้ | ไม่ใช่ | ไม่ใช่ | — | ไม่จำเป็นต้องรีเซ็ตหากยอดคงเหลือยังไม่หมดลง |
| 429 | rate_limited | daily_creations | ถึงขีดจำกัดการสร้างคีย์ภายใน 24 ชั่วโมงของบัญชีแล้ว | ไม่ใช่ | ใช่ | ปฏิบัติตามส่วนหัว Retry-After (วินาที) | สลับหมุนเวียนคีย์ที่มีอยู่แทนการสร้างคีย์ใหม่ หรือรอให้รอบ 24 ชั่วโมงรีเซ็ต |
| 429 | signup_rate_limited | per_ip | ถึงขีดจำกัดอัตราการลงทะเบียนสำหรับซับเน็ต IP ของไคลเอนต์แล้ว | ไม่ใช่ | ใช่ | ปฏิบัติตามส่วนหัว Retry-After (วินาที) | รอตามระยะเวลา Retry-After ก่อนสร้างบัญชีใหม่จากเครือข่ายนี้ |
| 429 | signup_rate_limited | global | ถึงขีดจำกัดอัตราการลงทะเบียนผู้ใช้ใหม่ทั่วโลกจากทุกแหล่งแล้ว | ไม่ใช่ | ใช่ | ปฏิบัติตามส่วนหัว Retry-After (วินาที) | รอตามระยะเวลา Retry-After ก่อนลองสร้างบัญชีใหม่อีกครั้ง |
| 400 | oauth_invalid | — | พารามิเตอร์ OAuth ไม่ถูกต้อง หรือสถานะ callback ไม่รู้จัก หมดอายุ หรือถูกใช้งานไปแล้ว | ไม่ใช่ | ใช่ | — | เริ่มต้นขั้นตอนการเข้าสู่ระบบ OAuth ใหม่จาก /v1/auth/{provider}/start |
| 400 | login_code_invalid | — | รหัสเข้าสู่ระบบไม่รู้จัก หมดอายุ ถูกใช้งานไปแล้ว หรือไม่ตรงกับตัวตรวจสอบ PKCE | ไม่ใช่ | ไม่ใช่ | — | เริ่มต้นการเข้าสู่ระบบใหม่เพื่อรับรหัสเข้าสู่ระบบใหม่ |
| 401 | unauthenticated | — | ไม่มีเซสชันเข้าสู่ระบบ หรือโทเค็นเซสชันไม่ถูกต้อง หมดอายุ หรือถูกเพิกถอน บน Top-up API (/v1/topup/*) ข้อผิดพลาดนี้จะเกิดขึ้นเมื่อส่วนหัว Authorization มีโทเค็นที่ไม่ใช่ Bearer หรือไม่ถูกต้อง แทนที่จะเป็น x-api-key | ไม่ใช่ | ไม่ใช่ | — | เข้าสู่ระบบใหม่เพื่อรับโทเค็นเซสชัน Bearer ใหม่ สำหรับ Top-up API ให้ส่ง API key ในส่วนหัว x-api-key แทน Authorization |
| 403 | user_disabled | — | บัญชีถูกระงับการใช้งานโดยผู้ดูแลระบบ | ไม่ใช่ | ไม่ใช่ | — | ติดต่อ contact@blockvectra.com เพื่อขอรับความช่วยเหลือเกี่ยวกับบัญชี |
| 404 | provider_disabled | — | รู้จักผู้ให้บริการ OAuth นี้ แต่ปัจจุบันถูกปิดการใช้งาน | ไม่ใช่ | ไม่ใช่ | — | ใช้ SIWE หรือผู้ให้บริการยืนยันตัวตนรายอื่นที่รองรับ |
| 409 | identity_in_use | — | ข้อมูลระบุตัวตน (วอลเล็ตหรือบัญชี OAuth) ได้รับการเชื่อมโยงกับผู้ใช้อื่นอยู่แล้ว | ไม่ใช่ | ไม่ใช่ | — | ยกเลิกการเชื่อมโยงข้อมูลระบุตัวตนจากบัญชีก่อนหน้า หรือใช้ข้อมูลระบุตัวตนอื่น |
| 409 | identity_limit_reached | — | ถึงขีดจำกัดจำนวนข้อมูลระบุตัวตนที่เชื่อมโยงได้สูงสุด (5) สำหรับบัญชีนี้แล้ว | ไม่ใช่ | ไม่ใช่ | — | ยกเลิกการเชื่อมโยงข้อมูลระบุตัวตนเดิมก่อนที่จะเพิ่มรายการใหม่ |
| 409 | last_identity | — | ไม่สามารถยกเลิกการเชื่อมโยงข้อมูลระบุตัวตนเพียงรายการเดียวที่เหลืออยู่ของบัญชีได้ | ไม่ใช่ | ไม่ใช่ | — | เพิ่มข้อมูลระบุตัวตนใหม่ก่อนที่จะยกเลิกการเชื่อมโยงข้อมูลระบุตัวตนปัจจุบัน |
| 409 | key_not_active | — | พยายามสลับหมุนเวียน API key ที่ถูกปิดใช้งาน เพิกถอน หรือหมดอายุแล้ว | ไม่ใช่ | ไม่ใช่ | — | สร้างคีย์ใหม่หรือสลับหมุนเวียนคีย์ที่กำลังใช้งานอยู่ |
| 409 | no_reset_available | — | ไม่มีสิทธิ์การรีเซ็ตเหลืออยู่ในบัญชีนี้แล้ว | ไม่ใช่ | ไม่ใช่ | — | เติมเงินออนเชน: รับที่อยู่เติมเงินจากคอนโซลหรือ `GET /v1/topup/deposit-address` (MCP `get_deposit_address`); ดู คู่มือการเติมเงินสำหรับ Agent หรือรอรอบโปรโมชันถัดไป |
| 413 | payload_too_large | — | ขนาดเนื้อหาของคำขอเกินขีดจำกัด 64 KiB | ไม่ใช่ | ไม่ใช่ | — | ลดขนาดเพย์โหลดของคำขอลงให้น้อยกว่า 64 KiB |
| 503 | signup_paused | — | การลงทะเบียนผู้ใช้ใหม่ทั่วโลกถูกระงับชั่วคราว บัญชีที่มีอยู่สามารถเข้าสู่ระบบได้ตามปกติ | ไม่ใช่ | ใช่ | ลองใหม่อีกครั้งในภายหลัง | การลงทะเบียนผู้ใช้ใหม่ถูกระงับชั่วคราว ตรวจสอบสถานะและลองใหม่ภายหลัง |
| 503 | usage_unavailable | — | บริการรายงานการใช้งานไม่พร้อมให้บริการชั่วคราว | ไม่ใช่ | ใช่ | รอสักครู่แล้วลองใหม่ | ส่งผลกระทบเฉพาะเอนด์พอยต์ /usage เท่านั้น เอนด์พอยต์อื่นทำงานตามปกติ ลองใหม่หลังจากหน่วงเวลาสั้นๆ |
| 500 | internal | — | เกิดข้อผิดพลาดของเซิร์ฟเวอร์ที่ไม่คาดคิด | ไม่ใช่ | ใช่ | ลองใหม่หลังจากหน่วงเวลาสั้นๆ | ลองส่งคำขอใหม่อีกครั้งโดยใช้ exponential backoff |
| 400 | invalid_address | invalid_address | รูปแบบหรือ checksum ของที่อยู่ผู้รับไม่ถูกต้อง | ไม่ใช่ | ไม่ใช่ | — | ใช้ 0x ตามด้วยอักขระเลขฐานสิบหก 40 ตัว อักษรตัวพิมพ์เล็กหรือมี checksum ตาม EIP-55; ตรวจสอบ data.field (/address) |
| 503 | faucet_empty | faucet_empty | Faucet มีเงินไม่เพียงพอสำหรับคำขอและค่าธรรมเนียมการทำธุรกรรม | ไม่ใช่ | ใช่ | ปฏิบัติตามส่วนหัว Retry-After (วินาที) | รอตาม Retry-After ก่อนลองใหม่; อย่าสรุปว่าได้รับ test ETH จนกว่าจะได้รับการตอบกลับที่ยอมรับคำขอ |
| 503 | service_unavailable | service_unavailable | การประมวลผลคำขอ faucet ไม่พร้อมใช้งานชั่วคราว หรือคำขอก่อนหน้านี้ยังไม่มีใบเสร็จการทำธุรกรรม | ไม่ใช่ | ใช่ | ปฏิบัติตามส่วนหัว Retry-After | รอตาม Retry-After ก่อนลองใหม่; อย่าสรุปว่าได้รับ test ETH จนกว่าจะได้รับการตอบกลับที่ยอมรับคำขอ |
ข้อผิดพลาด Push API
ข้อผิดพลาดจากการจัดการการสมัครรับข้อมูล webhook และประวัติเหตุการณ์ภายใต้ /v1/push/
| HTTP | รหัส | Reason | ความหมาย | คิดค่าบริการ | ลองใหม่ได้ | เวลาที่ต้องรอ (Retry-After) | การดำเนินการของ Agent |
|---|---|---|---|---|---|---|---|
| 400 | invalid_request | — | ฟิลด์คำขอ ที่อยู่ การแบ่งหน้า หรือช่วงบล็อกไม่ถูกต้อง | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบ data.field และ data.invalid; แก้ไขคำขอ |
| 401 | missing_api_key | — | ไม่มี x-api-key | ไม่ใช่ | ไม่ใช่ | — | ส่ง API key ในส่วนหัว x-api-key |
| 401 | invalid_api_key | — | API key ไม่รู้จัก ถูกปิดใช้งาน หรือถูกเพิกถอน | ไม่ใช่ | ไม่ใช่ | — | ใช้คีย์ที่กำลังใช้งานอยู่ของบัญชีคุณ |
| 402 | insufficient_balance | — | ยอดคงเหลือหรือโควตาฟรีหมดลงสำหรับประวัติเหตุการณ์ | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบ data.reason (balance_exhausted หรือ free_grant_exhausted) และ data.balance_units / data.balance_cu หากมี; เติมเงินผ่าน data.topup_url หรือ data.deposit_address_url |
| 403 | key_cap_exhausted | — | ขีดจำกัด CU ของ API key หมดลงสำหรับประวัติเหตุการณ์ | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบ data.cu_cap และสร้างคีย์ใหม่ในคอนโซล |
| 403 | key_expired | — | API key หมดอายุแล้ว | ไม่ใช่ | ไม่ใช่ | — | ใช้คีย์ที่ยังไม่หมดอายุของบัญชีคุณ |
| 404 | not_found | — | ไม่พบเส้นทาง เมธอด หรือการสมัครรับข้อมูล webhook | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบพาธ เมธอด และบัญชีที่เป็นเจ้าของการสมัครรับข้อมูล |
| 409 | limit_reached | — | ถึงขีดจำกัดการสมัครรับข้อมูลหรือคู่ที่อยู่ของบัญชีแล้ว | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบ data.limit และ data.max; ลดจำนวนการสมัครรับข้อมูลหรือที่อยู่ลง |
| 413 | request_too_large | — | เนื้อหาคำขอเกินขีดจำกัดของเส้นทาง | ไม่ใช่ | ไม่ใช่ | — | ลดขนาดของรายการที่อยู่หรือแบ่งออกเป็นหลายกลุ่ม |
| 422 | chain_not_available | — | เชนไม่พร้อมใช้งานสำหรับ push หรือไม่มีอยู่ในการสมัครรับข้อมูล | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบ GET /v1/push/chains และ chains ของการสมัครรับข้อมูล |
| 422 | chains_required | — | ต้องระบุอย่างน้อยหนึ่งเชน | ไม่ใช่ | ไม่ใช่ | — | ระบุออบเจกต์ chains ที่ไม่ว่างเปล่า; ใช้สถานะ offline เพื่อหยุดรับการแจ้งเตือน |
| 422 | confirmations_out_of_range | — | ความลึกของการยืนยัน (confirmations) อยู่นอกช่วงของเชน | ไม่ใช่ | ไม่ใช่ | — | เลือก confirmations ระหว่าง data.min ถึง data.max |
| 422 | destination_not_allowed | — | URL ปลายทางของ webhook ไม่ได้รับอนุญาต | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบ data.rule; ใช้ชื่อโฮสต์ HTTPS บนพอร์ต 443 โดยไม่มีข้อมูลผู้ใช้หรือ fragment |
| 422 | block_out_of_range | — | ช่วงบล็อกอยู่นอกช่วงการเล่นซ้ำ (replay) หรือประวัติที่พร้อมใช้งาน | ไม่ใช่ | ไม่ใช่ | — | ใช้ data.min_block และ data.max_block เพื่อปรับช่วงบล็อก |
| 429 | cost_exceeds_burst | — | ค่าใช้จ่ายของคำขอประวัติเกินความจุ burst ของคีย์ | ไม่ใช่ | ไม่ใช่ | — | ตรวจสอบ data.reason (request_exceeds_burst) และ data.max; เพิ่มความจุ burst ก่อนลองใหม่ การลองส่งคำขอเดิมซ้ำจะไม่ได้ผล |
| 429 | rate_limited | — | ถึงขีดจำกัดอัตราการจัดการหรือการสืบค้นประวัติแล้ว | ไม่ใช่ | ใช่ | รอตาม Retry-After | สำหรับประวัติ โปรดตรวจสอบ data.reason (key_rate_limit หรือ free_plan_call_limit); รอตามจำนวนวินาทีใน Retry-After และลดความถี่หรือจำนวนคำขอที่ส่งพร้อมกัน |
| 500 | internal_error | — | เกิดข้อผิดพลาดในการบริการที่ไม่คาดคิด | ไม่ใช่ | ไม่ใช่ | — | บันทึก x-request-id และติดต่อฝ่ายสนับสนุน |
| 503 | auth_unavailable | — | บริการยืนยันตัวตน API key ไม่พร้อมใช้งานชั่วคราว | ไม่ใช่ | ใช่ | รอตามจำนวนวินาทีใน Retry-After | รอตามจำนวนวินาทีใน Retry-After ก่อนลองใหม่อีกครั้ง |
| 503 | billing_unavailable | — | สถานะการเรียกเก็บเงินของประวัติไม่พร้อมใช้งานชั่วคราว | ไม่ใช่ | ใช่ | รอตามจำนวนวินาทีใน Retry-After | รอตามจำนวนวินาทีใน Retry-After ก่อนลองใหม่อีกครั้ง |
| 503 | upstream_unavailable | — | ไม่สามารถเข้าถึงบริการ Push ต้นทางได้ชั่วคราว | ไม่ใช่ | ใช่ | รอตามจำนวนวินาทีใน Retry-After | รอตามจำนวนวินาทีใน Retry-After ก่อนลองใหม่อีกครั้ง |
| 503 | service_unavailable | — | บริการ Push หรือความจุที่อยู่ไม่พร้อมใช้งานชั่วคราว | ไม่ใช่ | ใช่ | รอตามจำนวนวินาทีใน Retry-After | รอตามจำนวนวินาทีใน Retry-After ก่อนลองใหม่อีกครั้ง |
สำหรับข้อผิดพลาดในการสมัครรับข้อมูลหรือการส่งซ้ำของ Webhook โปรดทำตาม คู่มือการกู้คืนการส่ง Push การผสานการทำงานฝั่งผู้รับเริ่มต้นด้วย การตรวจสอบลายเซ็นจาก raw-body; โดย ตัวอย่างการชำระเงินด้วยสเตเบิลคอยน์ จะเพิ่มการกำจัดเหตุการณ์ซ้ำซ้อน, การตรวจสอบใบเสร็จ, การเติมเต็มช่องว่างข้อมูล และการกระทบยอดเมื่อเกิด reorg ดู กฎการคิดค่าบริการ สำหรับการวัดปริมาณ และ การเชื่อมต่อ WebSocket ใหม่ สำหรับการสมัครรับข้อมูลผ่านการเชื่อมต่อ
สำหรับ logs_range_too_large โปรดตรวจสอบ พารามิเตอร์ของเมธอด eth_getLogs และทำตาม คู่มือขีดจำกัดช่วงบล็อกและการสืบค้นแบบแบ่งส่วน
สำหรับการขอรับเหรียญจาก faucet บน Robinhood Chain โปรดดู คู่มือ testnet faucet สำหรับคุณสมบัติของผู้รับและการจัดการรหัสข้อผิดพลาดที่ใช้ร่วมกัน
อัปเดตล่าสุด:
การกำหนดเวอร์ชันและความเข้ากันได้
การกำหนดเวอร์ชันพาธของ BlockVectra API, คำจำกัดความของการเปลี่ยนแปลงที่เข้ากันได้ย้อนหลัง ตลอดจนความพร้อมใช้งานของเชนและเมธอด
ชุดข้อมูล
เลือกชุดข้อมูล Blockchain Data API สำหรับยอดคงเหลือของโทเค็น, ประวัติการโอน, หุ้นโทเค็นไนซ์ และข้อมูลที่ได้รับการทำดัชนีอื่นๆ ตรวจสอบความครอบคลุมของเชน แล้วเปิดดูข้อมูลอ้างอิงคำขอ