Stable reason code
Stable error code client logic, reporting மற்றும் automatic enquiry routing-ல் பயன்படுத்தப்படுகிறது.
Documentation / API Errors
API error handling
iGaming integrations-க்கான responses, error codes, temporary failures, unknown outcomes, diagnostics மற்றும் safe recovery-க்கு unified model.
HTTP
Request outcome
Codes
தெளிவான காரணம்
Retry
பாதுகாப்பான நடவடிக்கை
Trace
Request diagnostics
Error-handling cycle
API response-லிருந்து recovery வரை
01
Outcome type-ஐ தீர்மானிக்கவும்
HTTP status, reason code, error category மற்றும் operation state-ஐ சரிபார்க்கவும்.
02
Investigation-க்கு data சேமிக்கவும்
Request மற்றும் operation identifiers, endpoint, time, provider reference மற்றும் safe parameters-ஐ பதிவு செய்யவும்.
03
பாதுகாப்பான action-ஐ தேர்வு செய்யவும்
Data-ஐ திருத்தவும், operation-ஐ நிறுத்தவும், ஒரு delay பிறகு retry செய்யவும் அல்லது தற்போதைய state-ஐ சரிபார்க்கவும்.
04
Recover செய்து verify செய்யவும்
Duplicates-ஐத் தடுக்கவும், results-ஐ reconcile செய்யவும், பொறுப்பான teams-க்கு தெரிவிக்கவும் மற்றும் root cause-ஐ close செய்யவும்.
Overview
ஒரு error காரணத்தையும் அடுத்த action-ஐயும் விளக்க வேண்டும்
HTTP 400 அல்லது 500 response மட்டும் போதாது. நம்பகமான API ஒரு stable reason code வழங்கி, response-ஐ request identifier-ுடன் இணைத்து, data திருத்த வேண்டுமா, operation நிறுத்த வேண்டுமா, request retry செய்ய வேண்டுமா அல்லது அதன் state தனியாக சரிபார்க்க வேண்டுமா என்பதை தெளிவுபடுத்த வேண்டும்.
Predictable action
Error category மூலம் request-ஐ retry செய்ய முடியுமா மற்றும் எந்த data மாற்றப்பட வேண்டும் என்பது தெரியும்.
Diagnostic correlation
Request, operation மற்றும் provider identifiers client logs-ஐ internal systems மற்றும் support உடன் இணைக்கின்றன.
Error structure
பரிந்துரைக்கப்படும் error response structure
Response compact, stable மற்றும் automated processing-க்கு ஏற்றதாக இருக்க வேண்டும்; internal implementation அல்லது sensitive data வெளிப்படக்கூடாது.
Error code
Explanatory message திருத்தப்பட்டாலும் மாறாத, காரணத்திற்கான stable identifier.
விளக்கம்
Internal code, database queries, secrets அல்லது தேவையற்ற விவரங்கள் இல்லாத சுருக்கமான பாதுகாப்பான விளக்கம்.
Request ID
Logs-ல் operation-ஐ கண்டுபிடிக்கவும் support-ஐ தொடர்புகொள்ளவும் unique identifier.
Additional data
Allowed status, limit, current state அல்லது safe rejection reason.
Retryable
Temporary error என்பதை வெளிப்படையாகக் காட்டும் குறியீடு; ஆனால் operation-ன் duplicate protection நீங்காது.
Retry முன் delay
Rate limiting மற்றும் temporary unavailability-க்கான seconds-ல் பரிந்துரைக்கப்பட்ட delay அல்லது HTTP header.
Field errors
Reason code, value path மற்றும் safe explanation உடன் பிரச்சினையுள்ள fields பட்டியல்.
Documentation reference
Cause மற்றும் அதைச் சரி செய்வது குறித்து விவரிக்கும் permanent link அல்லது section identifier.
Error categories
முக்கிய error categories
HTTP status பொதுவான outcome class-ஐ காட்டும்; internal code குறிப்பிட்ட cause மற்றும் permitted action-ஐ சுட்டிக்காட்டும்.
Input validation error
Invalid format, missing required field, unsupported value, தவறான amount precision அல்லது invalid request structure.
Authentication error
Missing, expired அல்லது invalid token, API key, signature, request timestamp அல்லது nonce.
Insufficient permissions
Client அடையாளம் காணப்பட்டாலும் தேவையான role, brand, market அல்லது action permission இல்லாமல் இருக்கலாம்.
Object கிடைக்கவில்லை
Player, payment, round, KYC check, provider அல்லது மற்ற object இல்லை அல்லது client-க்கு கிடைக்கவில்லை.
State conflict
Object version அல்லது state மாறியிருக்கலாம், அல்லது operation identifier வேறு parameters உடன் ஏற்கனவே பயன்படுத்தப்பட்டிருக்கலாம்.
Business rule violation
Insufficient balance, limit exceeded, blocked player, prohibited market அல்லது invalid status transition.
அதிகமான requests
Client, method, role அல்லது critical operation-க்கு அனுமதிக்கப்பட்ட request count மீறப்பட்டுள்ளது.
Provider கிடைக்கவில்லை
External service கிடைக்கவில்லை, மெதுவாக response அளிக்கிறது அல்லது operations-ஐ தற்காலிகமாக ஏற்கவில்லை.
Internal error
Internal details வெளியிடாமல், diagnostics-க்கு identifier உடன் வரும் எதிர்பாராத platform error.
Retries மற்றும் recovery
Request retry மற்றும் unknown outcome
Error type-ஐ கண்டறிந்து original operation ஏற்கனவே complete ஆனதா என்பதை சரிபார்த்த பிறகே retry பாதுகாப்பானது.
01
Retry அனுமதிக்கப்படுகிறதா சரிபார்க்கவும்
Data, permission மற்றும் business-rule errors பொதுவாக request-ஐ திருத்த வேண்டும்; மீண்டும் அனுப்பக் கூடாது.
02
அதே operation key-ஐ வைத்திருக்கவும்
Financial, gaming அல்லது பிற critical operation-ஐ retry செய்வது புதிய result உருவாக்கக் கூடாது.
03
Attempts இடையிலான delay-ஐ அதிகரிக்கவும்
Intervals படிப்படியாக அதிகரிக்க வேண்டும், server வழங்கும் delay-ஐ மதிக்க வேண்டும் மற்றும் மொத்த attempts எண்ணிக்கையை வரையறுக்க வேண்டும்.
04
நிறுத்தி review-க்கு escalate செய்யவும்
அனைத்து attempts முடிந்த பிறகு operation incomplete என பதிவு செய்யப்பட்டு manual review அல்லது reconciliation-க்கு அனுப்பப்படும்.
Response இல்லாதது operation தோல்வி என அர்த்தமல்ல
Request அனுப்பிய பிறகு connection துண்டிக்கப்பட்டால் outcome unknown ஆக இருக்கலாம். Retry செய்வதற்கு முன் operation identifier மூலம் state-ஐ சரிபார்க்கவும் அல்லது trusted notification-ஐ காத்திருக்கவும்.
Diagnostics மற்றும் control
Logs, identifiers, metrics மற்றும் alerts
தேவையற்ற sensitive data சேமிக்காமல் platform, adapter மற்றும் external provider இடையிலான request path-ஐ diagnostics மீட்டமைக்க வேண்டும்.
Investigation context
Request, correlation, operation மற்றும் external provider identifiers.
Endpoint, HTTP method, environment, client, time மற்றும் response duration.
HTTP status, error code, attempts எண்ணிக்கை மற்றும் final state.
Masked sensitive fields, safe headers மற்றும் signature validation result.
Monitoring மற்றும் alerts
Method, provider, client மற்றும் reason category அடிப்படையிலான error rate.
Slow responses, HTTP 5xx errors, invalid signatures மற்றும் rate-limit events அதிகரிப்பு.
Retries, unknown outcomes கொண்ட operations மற்றும் recovery tasks எண்ணிக்கை.
Thresholds, owners மற்றும் escalation rules உடன் alerts.
Testing
Test environment-ல் என்ன test செய்ய வேண்டும்
Test environment ஒவ்வொரு முக்கிய error category-யையும் reproduce செய்து client, retry மற்றும் control behavior சரியாக உள்ளதா உறுதிப்படுத்த வேண்டும்.
Input validation errors
Missing fields, invalid types, unsupported values, amount precision மற்றும் ஒரே நேரத்தில் பல errors.
Access மற்றும் permissions
Invalid key, expired token, incorrect signature, unauthorized role, blocked IP மற்றும் reused nonce.
Response இல்லை மற்றும் outcome தெரியவில்லை
Sending முன், operation accepted ஆன பிறகு மற்றும் final response பெறும் போது connection failure.
Rate limiting
HTTP 429, recommended delay, concurrent requests மற்றும் limit முடிந்தபின் recovery.
Provider errors
Unavailability, maintenance, invalid response, delayed notification மற்றும் conflicting status.
Retry மற்றும் protective stop
Attempt count-ஐ வரையறுத்தல், delays அதிகரித்தல், requests-ஐ தற்காலிகமாக நிறுத்துதல், controlled recovery மற்றும் manual escalation.
Pre-launch checklist
Error structure, client behavior, duplicate protection மற்றும் diagnostics validate செய்யப்பட்ட பிறகே production integration launch செய்யப்படும்.
அனைத்து errors-மும் stable reason code மற்றும் request identifier திருப்பித் தர வேண்டும்.
Error details secrets அல்லது internal implementation-ஐ வெளிப்படுத்தாது.
Temporary மற்றும் permanent error categories documentation-ல் விளக்கப்பட்டுள்ளன.
Critical operation retry செய்யப்படும் போது அதே idempotency key பயன்படுத்தப்படும்.
Unknown outcome state check அல்லது trusted notification மூலம் கையாளப்படும்.
Logs, metrics, alerts, recovery queue மற்றும் escalation rules configure செய்யப்பட்டுள்ளன.
API errors-ஐ ஒரே format-க்கு standardize செய்ய வேண்டுமா?
உங்கள் தற்போதைய HTTP responses, error codes, retry rules மற்றும் problematic scenarios-ஐ அனுப்புங்கள். Unified error model, safe recovery மற்றும் control approach வரையறுக்க APIACE உதவும்.