முக்கிய உள்ளடக்கத்திற்கு தவிர்க்கவும்
செலவுப் கட்டுப்பாடுகள்

உங்கள் ஏஜென்ட் நீங்கள் அமைத்ததை மீறி செலவிட முடியாது.

ஒவ்வொரு எஜெண்டிற்கும் டாஷ்போர்டில் ஒரு காலத்திற்கு ஒரு அனுமதி மற்றும் ஒரு பரிவர்த்தனை வரம்பை அமைக்கவும். பின்னணி ஒவ்வொரு வெளிப்புற பணத்திலும் அதை அமல்படுத்துகிறது - எஜெண்டின் குறியீடு அதை தவிர்க்க முடியாது.

டாஷ்போர்ட் காட்சி: ஒவ்வொரு முகவருக்கும் செலவீன அனுமதிகள் - அனுமதி, ஒவ்வொரு பரிவர்த்தனையிற்கும் வரம்பு, காலம்

சுயாதீன ஏஜென்ட்கள் தவறுகள் செய்கின்றன. அவர்கள் மீண்டும் முயற்சிக்கிறார்கள். அவர்கள் சுற்றுப்பயணம் செய்கின்றனர். அவர்கள் ஊடுருவலுக்கு உள்ளாகின்றனர். அவர்கள் நீங்கள் அனுமதிக்காத பணத்தை செலவிட முயற்சிக்கிறார்கள்.

ஒரு Blockchain0x செலவிடும் அனுமதி, டாஷ்போர்டில் உரிமையாளர் அமைக்கப்படுகிறது மற்றும் பின்னணி மூலம் அமல்படுத்தப்படுகிறது, முகவரின் குறியீட்டால் அல்ல. ஒவ்வொரு வெளியேறும் செலுத்தலும் API அதை ஏற்கும்முன்பு செயல்பாட்டிற்கான அனுமதியுடன் சரிபார்க்கப்படுகிறது, எனவே முகவர் தனது தரவுகளை முயற்சித்தாலும் வரம்பை மீற முடியாது. உங்கள் குறியீடு அதை காட்சிப்படுத்த அல்லது அதன் சுற்றிலும் திட்டமிட API மூலம் அனுமதியைப் படிக்கலாம், ஆனால் அதை உயர்த்த முடியாது.

செலவுக்கு அனுமதி என்ன உள்ளது

நான்கு பரிமாணங்கள். ஒருமுறை அமைக்கவும். எங்கும் அமல்படுத்தப்படுகிறது.

ஒரு காலத்தில் அளவீடு

allowance_wei என்பது ஒரு period_seconds window-இல் agent அனுப்பக்கூடிய மொத்த USDC (base units) ஆகும். அந்த period ஒரு நாள் (86400), ஒரு வாரம் (604800), அல்லது 30 நாட்கள் (2592000) ஆக இருக்கலாம்.

பரிவர்த்தனை வரம்பு

per_tx_wei என்பது அனுமதிக்கப்பட்ட மிகப்பெரிய single outbound payment. இது period allowance-இற்கு சார்பில்லாமல், ஒரே தவறான call உங்கள் நோக்கத்தைவிட அதிகமாக நகர்த்துவதைத் தடுக்கிறது.

செல்லுபடியாகும் ஜன்னல்

start_at மற்றும் end_at permission active இருக்கும் காலத்தை வரையறுக்கின்றன. அந்த window-க்கு வெளியே அது spending-ஐ authorize செய்யாது, ஆகவே நீங்கள் முன்கூட்டியே budget-ஐ அமைக்கலாம் அல்லது அது தானாக expire ஆக விடலாம்.

ரத்து

dashboard-இல் இருந்து ஒரு permission எப்போது அணைக்கப்பட்டது என்பதை revoked_at பதிவு செய்கிறது. அதன்பின் evaluate செய்யப்படும் எந்த payment-க்கும் revoking allowance-ஐ உடனடியாக zero-ஆக மாற்றும்.

DASH்போர்ட்-மேலாண்மை, API மூலம் வாசிக்கக்கூடியது

முகவரியின் விசை தனது சொந்த வரம்பை உயர்த்த முடியாது.

நீங்கள் spend permissions-ஐ dashboard-இல் உருவாக்கி, மாற்றி, revoke செய்கிறீர்கள். API அவற்றை read-only ஆக மட்டுமே வழங்குகிறது - ஒரு permission-ஐ மாற்றும் endpoint-உம் இல்லை, SDK method-உம் இல்லை. அதுவே முழு நோக்கம்: agent-க்கு prompt injection ஏற்பட்டாலும் அல்லது loop-இல் சிக்கினாலும், அது தன் allowance-ஐ தானாக உயர்த்த முடியாது, ஏனெனில் அதற்குக் கொடுக்கப்பட்ட credential-க்கு அந்த அதிகாரமே இல்லை.

ஒரு பணம் செயல்பாட்டில் உள்ள அனுமதியை மீறும் போது, பின்னணி அதை எந்தவொரு சங்கிலியையும் தொடுவதற்கு முன்பு மறுக்கிறது. எந்த நிதியும் நகராது. உங்கள் முகவர் அந்த மறுப்பை மற்ற எந்த தோல்வியுற்ற அழைப்பைப் போல கையாள்கிறது, மற்றும் நீங்கள் டாஷ்போர்டில் முயற்சியைப் பார்க்கிறீர்கள், எனவே அது சட்டசபை இருந்தால் அனுமதியை விரிவாக்கலாம்.

API மூலம் அதை வாசிக்கவும்

அதை காட்சியிட அல்லது திட்டமிட தற்போதைய அனுமதியைப் பெறுங்கள்.

GET /v1/agents/{id}/spend-permissions நேரடி மதிப்புகளை திருப்புகிறது. உங்கள் UI இல் ஒரு பட்ஜெட்டை காட்ட அல்லது எஜெண்ட் ஒரு செலுத்தலை முயற்சிக்கும் முன்பு எவ்வளவு இடம் மீதமுள்ளது என்பதைச் சரிபார்க்க அனுமதிக்க இதைப் பயன்படுத்தவும்.

READ (CURL)
curl https://api.blockchain0x.com/v1/agents/agt_123/spend-permissions \
  -H "Authorization: Bearer $BLOCKCHAIN0X_API_KEY"
பதில்
{
  "allowance_wei": "5000000",
  "per_tx_wei": "1000000",
  "period_seconds": 86400,
  "start_at": "2026-05-15T00:00:00Z",
  "end_at": null,
  "revoked_at": null
}
allowance_wei

Total spend allowed per period, in USDC base units (6 decimals). "5000000" is 5 USDC.

per_tx_wei

Largest single payment allowed, in base units. "1000000" is 1 USDC. A payment over this is rejected even if the period allowance has room.

period_seconds

அனுமதி பொருந்தும் ஜன்னல்: 86400 (நாள்), 604800 (வாரம்), அல்லது 2592000 (30 நாட்கள்).

start_at / end_at

அனுமதி செயல்பாட்டில் இருக்கும் போது. end_at என்பது திறந்த முடிவான அனுமதிக்கு பூஜ்யமாக உள்ளது.

revoked_at

செயல்பாட்டில் இருக்கும் போது பூஜ்யம்; டாஷ்போர்டில் இருந்து ஒருமுறை நீக்கப்பட்ட பிறகு ஒரு நேரம் முத்திரை. நீக்கப்பட்ட அனுமதி எதற்கும் அதிகாரம் அளிக்காது.

காலம்

நாள், வாரம், அல்லது 30 நாட்கள்.

period_seconds மூன்று மதிப்புகளில் ஒன்றை எடுக்கும். period மாறும்போது allowance மீண்டும் reset ஆகும்; per_tx_wei period-ஐ பொருட்படுத்தாமல் ஒவ்வொரு payment-க்கும் பொருந்தும்.

86400

1 நாள்

604800

1 வாரம்

2592000

30 நாட்கள்

ஒரு செலவிடும் அனுமதி ஒரு கடுமையான வரம்பு, ஒருமுறை அமைக்கப்படுகிறது, எங்கு வேண்டுமானாலும் அமல்படுத்தப்படுகிறது - ஒரு செலுத்தலுக்கான அங்கீகாரம் வேலைப்பாடு அல்ல மற்றும் மனிதர்-இன்-சுழற்சியில் உறுதிப்படுத்தல் அல்ல. நீங்கள் அங்கீகாரங்கள் அல்லது பல கையொப்பங்களை தேவைப்படுத்தினால், அது ஒரு தனித்த, கனமான மாதிரியானது; அனுமதி எப்போதும் கீழே உள்ள அடிக்கடி.

அடிக்கடி கேட்கப்படும்

செயல்பாட்டாளர்கள் கேட்கும் ஐந்து செலவுக்கான அனுமதி கேள்விகள்.

நான் API மூலம் செலவீன அனுமதியை அமைக்க அல்லது மாற்ற முடியுமா?

இல்லை. செலவுப் அனுமதிகள் API இல் வாசிக்க மட்டும் உள்ளன. நீங்கள் Blockchain0x டாஷ்போர்டில் அவற்றைப் உருவாக்க, மாற்ற மற்றும் நீக்குகிறீர்கள், மற்றும் GET /v1/agents/{id}/spend-permissions உங்கள் குறியீட்டை தற்போதைய மதிப்புகளை வாசிக்க அனுமதிக்கிறது. இது நோக்கமாகவே உள்ளது: முகவரின் சொந்த API விசை தனது வரம்புகளை சிதிலமாக்க முடியாது, இது முகவர் எப்போது வேண்டுமானாலும் முன்பதிவு செய்யப்பட்டால் அல்லது மடல்களில் இருந்தால் நீங்கள் விரும்பும் சொத்தாகும். ஒரு அனுமதியை உயர்த்த, நீங்கள் டாஷ்போர்டை தேவை.

ஒரு பணம் செலுத்துதல் அனுமதியை மீறும் போது என்ன நடக்கிறது?

பின்னணி சங்கிலியைத் தொடுவதற்கு முன் அதை நிராகரிக்கிறது - எந்த நிதிகளும் நகரவில்லை. அமலாக்கம் பின்னணியில் வாழ்கிறது, உங்கள் முகவரியின் குறியீட்டில் அல்ல, எனவே முகவர் அதைச் சுற்றி செல்ல முடியாது, அதன் தரவுகள் முயற்சித்தாலும். GET வழியுடன் அனுமதியைப் படிக்கவும், உங்கள் முகவரிக்கு எவ்வளவு இடம் மீதமுள்ளது என்பதை காட்டவும், payments.create இல் இருந்து நிராகரிப்பை நீங்கள் மற்ற எந்த தோல்வியடைந்த அழைப்புகளுக்கு செய்வதுபோல் கையாளவும்.

ஏன் அளவுகள் டாலர்களுக்கு பதிலாக வெயில் உள்ளன?

Consistency with the rest of the API: every amount is a base-unit string. USDC has 6 decimals, so allowance_wei "5000000" is 5 USDC and per_tx_wei "1000000" is 1 USDC. Strings, not floats - large integers lose precision as JSON numbers, and a base-unit string is unambiguous across languages.

செலவீன அனுமதிகள் உள்ளே வரும் கட்டணங்களை வரையறுக்கவா?

இல்லை. ஒரு அனுமதி பணத்தை பணப்பை விட்டுச் செல்ல மட்டுமே ஆள்கிறது. வர Incoming USDC இதனால் மறுக்கப்படுவதில்லை - யாரும் உங்கள் முகவருக்கு எப்போது வேண்டுமானாலும் செலுத்தலாம். அனுமதியை வெளிப்புற செலவுக்கு ஒரு ஒரே வழி வால்வாகக் கருதுங்கள்; உள்ளே வரும் தீர்வு தனியாக payment.received வெப்ஹூக்கால் உறுதிப்படுத்தப்படுகிறது.

எப்படி நான் எதாவது தவறாகத் தோன்றினால் செலவுகளை விரைவாக ரத்து செய்ய வேண்டும்?

டாஷ்போர்டில் அனுமதியை ரத்து செய்யவும் - இது revoked_at ஐ அமைக்கிறது மற்றும் பிறகு மதிப்பீடு செய்யப்பட்ட எந்த பணத்திற்கும் அனுமதியை பூஜ்யமாக்குகிறது. கடுமையான நிறுத்தத்திற்காக, நீங்கள் எஜெண்டின் API விசையை (apiKeys.rotate / apiKeys.revoke) மாற்றவும் அல்லது ரத்து செய்யவும், இது அங்கீகாரத்தை முழுமையாக துண்டிக்கிறது. இரண்டும் உடனடி; அனுமதி ரத்து என்பது அறுவை சிகிச்சை, விசை ரத்து என்பது கொல்லும் switches.
செலவுத் அனுமதிகள் ஆவணங்களில் உள்ள மேற்கோள்

எதிர்பாராத செலவுகள் இல்லாமல் வரம்புகளுடன் செலவிடுங்கள்.

டாஷ்போர்டில் ஒரு அனுமதி மற்றும் ஒரு பரிவர்த்தனை வரம்பை அமைக்கவும். பின்னணி மற்றதை செய்கிறது.