LibreAuth

Error Codes

รหัสข้อผิดพลาดจาก Client API, Seller API และ File delivery — อ่านแล้วรู้ว่าแก้ตรงไหน

ระบบรหัสทำงานยังไง

Client API (/api/1.3/, /api/1.4/) ไม่ส่งข้อความ error ดิบออกไปตรง ๆ — ใช้ veil แปลงเป็นรหัสสั้น ๆ ใน field message ของ JSON response

รูปแบบตัวอย่างความหมาย
StaticE01E18ข้อความมาตรฐานที่ map ไว้ในเซิร์ฟเวอร์ — อ่านตารางด้านล่างได้เลย
DynamicE1AA3B2E + 6 ตัว hex จาก CRC32b ของข้อความจริง — ไม่มีใน static table
EmptyE00ข้อความ error ว่าง
Customข้อความเต็มถ้า dev ตั้ง Custom Messages ใน Panel แล้วข้อความตรงกับที่ตั้ง — ส่งออกแบบไม่ veil
Specialinvalidverเวอร์ชัน client ไม่ตรง — response มี download เพิ่ม
WARN
รหัส dynamic ไม่ได้อยู่ใน static list — ดูตาราง Quick Lookup หรือตรวจ Event Logs ใน Panel (ถ้ามีสิทธิ์)
TIP
ถอดรหัส dynamic: E + 6 ตัวแรกของ hash('crc32b', message) — เช่น Invalid license keyE48E0A5. อย่าสับสนกับ E05 (Hash mismatch).

Quick Lookup — รหัสที่เจอบ่อย

Codeสาเหตุสั้น ๆแก้
E1A7FF8ไฟล์ Authenticated แต่ยังไม่ license/loginFile flow · license ก่อน file · หรือเปลี่ยนเป็น Public
E1AA3B2API v1.4 — seq ผิดใช้ SDK ล่าสุด · ดู Sequence
E77AC17fileid ผิดหรือไฟล์ถูกลบPanel → Files → Copy File ID
E547D79ไม่ส่ง sessionidเรียก init ก่อน · ส่ง session ทุก request
EF622D2session หมดอายุinit ใหม่
E04เปิด hash check แต่ client ไม่ส่ง MD5Hash guide
E05MD5 exe ไม่อยู่ใน whitelistPanel → Access Controls → Add Hash · ดู rh/received_hash
E48E0A5Invalid license key — คีย์ผิด / หมดอายุ / ใช้แล้ว / คนแอปPanel → Licenses · สร้างคีย์ใหม่ · ไม่ใช่ปัญหา Hash
E18Client ไม่มี wire tokenLibreAuth SDK + /api/1.4/ หรือ /api/1.3/

File Download — Public vs Authenticated

Endpoint type=file ต้องมี sessionid จาก init เสมอ — ต่างกันที่ไฟล์ Authenticated ต้อง login/license ก่อน

โหมดไฟล์ (Panel)Flow (API v1.4)หมายเหตุ
Public initfile ไม่ต้อง license · installer/mod loader ใช้แบบนี้ได้
Authenticated initlicensefile license ต้อง success: true ก่อน download
TIP
Response สำเร็จมี contents (hex) — แปลงเป็น bytes ก่อนเขียนไฟล์ · ดู file endpoint

Static Codes — E01 ถึง E18

Codeสาเหตุวิธีแก้
E00ข้อความ error ว่างตรวจ request body / server log
E01ขาดพารามิเตอร์บังคับ เช่น type, ownerid, nameส่งครบตาม endpoint docs · ใช้ SDK ล่าสุด
E02ownerid ไม่ใช่ 10 ตัวอักษรคัดลอก Owner ID จาก Panel → App Settings
E03type ไม่รู้จักสะกดให้ตรง: init, login, license, file ฯลฯ
E04แอปเปิด Hash Check แต่ client ไม่ส่ง MD5ส่ง hash หรือ h ทุก request · Hash troubleshooting
E05MD5 ของ exe ไม่อยู่ใน whitelistดู received_hash (rh บน 1.4), whitelist_count (wc) · Panel → Settings → Recent rejected MD5 · Add Hash
E06Anti-Tamper เปิด แต่ไม่ส่ง integrity tokenอัปเดต SDK · ส่ง token ตาม Anti-Tamper
E07Anti-Tamper ต้องการ hash คู่กับ tokenส่งทั้ง token และ file hash ใน request เดียวกัน
E08hash ใน token ไม่ตรงกับ hash ที่ส่งมาใช้ hash จากไฟล์เดียวกันที่ build จริง
E09Token หมดอายุ / ถูกแก้ / สร้างผิด sessionเรียก init ใหม่ · อย่า reuse token ข้าม session
E10IP เปลี่ยนระหว่าง session (VPN, mobile network)เรียก init จาก network เดิม · ปิด VPN ชั่วคราว
E11ไม่ส่ง nonce หรือ nonce ซ้ำ / ผิดลำดับSDK ต้องส่ง nonce ใหม่ทุก request หลัง init
E12ส่ง request ซ้ำภายใน replay windowรอแล้วส่งใหม่ · อย่า retry พร้อม payload เดิมทันที
E13HWID ใน session ไม่ตรงกับที่ bind ไว้logout + init ใหม่ · หรือขอ reset HWID จาก provider
E14แอปบังคับ signed response แต่เซิร์ฟเวอร์ยังไม่มี Ed25519 keyติดต่อ host ให้ตั้งค่า signing key
E15DB down หรือ maintenanceลองใหม่ · ตรวจสถานะเซิร์ฟเวอร์
E16แอปถูกปิดใน Panelเปิดแอปใน Panel → App Settings
E17แอปอยู่ในสถานะ PausedPanel → Resume app
E18Client ยิง API โดยไม่มี wire token (la_w)ใช้ LibreAuth SDK บน /api/1.4/ (Enterprise) หรือ /api/1.3/ — legacy loaders ไม่รองรับ

Dynamic Codes (เช่น E1AA3B2)

ถ้า error ไม่ตรงกับ static table (E01E18) จะได้รหัส dynamic แบบ E + 6 ตัว hex — รหัสนี้ไม่เปิดเผยข้อความภายในเซิร์ฟเวอร์ ใช้ตารางด้านล่างและ Quick Lookup ด้านบนเพื่อแก้ปัญหา

อาการเมื่อไหร่แก้ยังไง
ไม่พบไฟล์type=file แต่ fileid ผิดหรือถูกลบตรวจ File ID ใน Panel · ส่ง fileid ตัวเลขที่ถูก
ยังไม่ authenticatedไฟล์ตั้ง Authenticated แต่ client ยังไม่ login/licenseinitlicensefile · หรือเปลี่ยนไฟล์เป็น Public ใน Panel
แหล่งไฟล์ HTTP 403URL ต้นทางบล็อก hotlink / ต้อง authใช้ direct link · อัปโหลด hosted file แทน URL ภายนอก
แหล่งไฟล์ HTTP 404ลิงก์หมดอายุหรือ path ผิดPanel → Files → Test URL · แก้ URL หรือ re-upload
ไฟล์ใหญ่เกิน limitเกิน File Max MBPanel → App Settings → เพิ่ม limit หรือลดขนาดไฟล์
คีย์ไม่ถูก / หมดอายุ · รหัส E48E0A5type=license ได้ข้อความ Invalid license key (veil dynamic)Panel → Licenses · สร้าง/รีเซ็ตคีย์ · ตรวจว่าคีย์เป็นของแอปนี้ · ถ้า Discord โชว์ Hash ตรง แปลว่า init ผ่านแล้ว — ไม่ใช่ E05
คีย์ถูกใช้แล้วone-time key · ข้อความอาจ veil เป็น dynamic อื่นสร้างคีย์ใหม่
HWID ไม่ตรงเครื่องไม่ตรงที่ bindreset HWID หรือใช้เครื่องเดิม
session หมดอายุTTL หมดเรียก init ใหม่
ไม่มี sessionไม่ส่ง sessionidเก็บ session จาก init แล้วส่งทุก call
sequence ผิดAPI v1.4 — seq ไม่ตรงใช้ SDK ล่าสุด · ดู Sequence
Captcha ไม่ผ่านCaptcha เปิดในแอปส่ง captcha token ที่ verify แล้ว
TIP
Dev ที่มี access server log: ค้นหา error ใน Event Logs ของ Panel

File Download Errors

Endpoint type=file อาจได้ dynamic code จากข้อความเหล่านี้:

ข้อความสาเหตุแก้
File not Foundไม่มี record หรือ fileid ผิดใช้ File ID จาก Panel (ปุ่ม Copy ID)
ยังไม่ authenticatedไฟล์ตั้งค่า Authenticatedlogin/license ก่อน download · หรือเปลี่ยนเป็น Public
File is disabledไฟล์ถูกปิดใน Panelเปิดไฟล์ / แก้ status
Invalid file URLURL ว่างหรือ format ผิดPanel → Edit file → Test URL
File URL blocked by security policyโดเมนอยู่ใน blocklist ของเซิร์ฟเวอร์ใช้ hosted upload หรือโดเมนที่อนุญาต
File download unavailable on serverเซิร์ฟเวอร์ไม่มี curlติดตั้ง php-curl บน host
Hosted file missing on serverไฟล์อัปโหลดหายจาก storageRe-upload ใน Panel
URL looks like a web page, not a direct file downloadContent-Type เป็น HTMLใช้ direct download link ไม่ใช่หน้าเว็บ

Seller API Errors

INFO
Seller API ส่งข้อความ plain text ใน message — ไม่ใช้ veil (ไม่มี E01/E1AA3B2)
messageHTTPแก้
Missing sellerkey200ส่ง sellerkey=… ทุก request
Invalid sellerkey200สร้าง key ใหม่ใน Panel → Seller API
IP not whitelisted200เพิ่ม IP VPS/bot ใน whitelist ของ key
Permission denied for this API key200เปิด permission ของ type นั้น (เช่น addkey)
Unknown seller API type200สะกด type ให้ตรง · ดู Seller Endpoints
Seller API requires Pro plan or higher200อัปเกรดแพ็กเกจ account
Seller subscription expired200ต่ออายุ seller sub
Service unavailable200DB/connect ล้ม — ติดต่อ host
Application not found200ส่ง app หรือ name ถ้ามีหลายแอป
Invalid expiry200expiry / expiry_val ต้อง ≥ 1
Invalid subscription200สร้าง subscription tier ใน Panel ก่อน
ข้อความจาก Billing (key limit)200อัปเกรดแพ็กหรือลบคีย์เก่า
ข้อความ PHP exception500ดู message ใน JSON — มักเป็น mask ผิด, DB error

Discord Bot & License Mask

อาการที่พบบ่อยจากบอท custom (เช่น genkey_new) หรือ Seller API addkey:

อาการสาเหตุแก้
Panel โชว์ note แทนคีย์เวอร์ชัน Panel เก่าอัปเดต LibreAuth — แสดง key_code แล้ว
คีย์สั้นแค่ 1dmask ไม่มี *ใช้ 1day-****** หรือให้ระบบ auto-expand เฉพาะ 1d/1day
พิมพ์ Test11 ได้คีย์สุ่มต่อท้ายlogic เก่าเติม * ให้ทุก mask สั้นอัปเดต server — Test11 = คีย์ตายตัว · อยากสุ่มใช้ Test11-******
HTTP 500 จาก addkeymask ผิด / DB / permissionดู Seller API Errors
INFO
Mask rules + custom bot snippet: Discord Bot → Key Mask