મુખ્ય સામગ્રી પર જાઓ
ખર્ચ નિયંત્રણો

તમારો એજન્ટ તમે જે સેટ કરો છો તે વધુ ખર્ચ કરી શકતો નથી.

ડેશબોર્ડમાં દરેક એજન્ટ પર સમયગાળા માટેની મંજૂરી અને એક ટ્રાન્ઝેક્શન કૅપ સેટ કરો. બેકએન્ડ દરેક બહારની પેમેન્ટ પર તેને અમલ કરે છે - એજન્ટનો કોડ તેને બાયપાસ કરી શકતો નથી.

ડેશબોર્ડ દૃષ્ટિ: પ્રતિ એજન્ટ ખર્ચની મંજૂરીઓ - અલાઉન્સ, પ્રતિ-લેનદેન કૅપ, સમયગાળો

સ્વાયત્ત એજન્ટો ભૂલ કરે છે. તેઓ પુનરાવૃત્તિ કરે છે. તેઓ લૂપમાં જાય છે. તેઓ પ્રોમ્પ્ટ-ઇન્જેક્ટ થાય છે. તેઓ ક્યારેક તે પૈસા ખર્ચ કરવાનો પ્રયાસ કરે છે જે તમે મંજૂર કર્યા નથી.

એક Blockchain0x ખર્ચ પરવાનગી ડેશબોર્ડમાં માલિક દ્વારા સેટ કરવામાં આવે છે અને બેકએન્ડ દ્વારા અમલમાં આવે છે, એજન્ટના કોડ દ્વારા નહીં. દરેક આઉટબાઉન્ડ ચુકવણીને API તેને સ્વીકારતા પહેલા સક્રિય પરવાનગી સામે ચકાસવામાં આવે છે, તેથી એજન્ટ તેની મર્યાદા વધારી શકતો નથી, ભલે તેની તર્કશક્તિ પ્રયત્ન કરે. તમારું કોડ API દ્વારા પરવાનગી વાંચી શકે છે તેને પ્રદર્શિત કરવા અથવા તેના આસપાસની યોજના બનાવવા માટે, પરંતુ તે તેને ઉંચું કરી શકતું નથી.

ખર્ચ પરવાનગીમાં શું છે

ચાર પરિમાણો. એકવાર સેટ કરો. સર્વત્ર અમલમાં.

કાળ દરમિયાન ભંડોળ

allowance_wei એ કુલ USDC (બેઝ યુનિટ) છે જે એજન્ટ એક period_seconds વિન્ડો દરમિયાન મોકલી શકે છે. સમયગાળો એક દિવસ (86400), એક અઠવાડિયું (604800), અથવા 30 દિવસ (2592000) છે.

પ્રતિ-લેનદેન મર્યાદા

per_tx_wei એ મંજૂર કરવામાં આવેલી સૌથી મોટી એકલ આઉટબાઉન્ડ ચુકવણી છે. તે એક ભૂલભર્યું કોલને વધુ ખસેડવા રોકે છે જે તમે ઇચ્છતા હતા, સમયગાળા ભથ્થા પરથી સ્વતંત્ર.

માન્યતા વિન્ડો

start_at અને end_at બાઉન્ડ છે જ્યારે પરવાનગી જીવંત હોય છે. વિન્ડો બહાર તે ખર્ચને અધિકૃત નથી કરે, તેથી તમે એક બજેટને પૂર્વ-સ્ટેજ કરી શકો છો અથવા એકને પોતે સમાપ્ત થવા દો.

રદ કરવું

revoked_at એ રેકોર્ડ કરે છે જ્યારે ડેશબોર્ડમાંથી પરવાનગી બંધ કરવામાં આવી હતી. રદ કરવાથી તે પછીના કોઈપણ ચુકવણી માટે ભથ્થાને તરત જ શૂન્યમાં લઈ જાય છે.

ડેશબોર્ડ-વ્યવસ્થિત, API દ્વારા વાંચવા માટે જ

એજન્ટની કી તેની પોતાની મર્યાદા વધારી શકતી નથી.

તમે ડેશબોર્ડમાં ખર્ચ પરવાનગીઓ બનાવો, બદલાવો અને રદ કરો. API તેમને વાંચન-માત્ર તરીકે પ્રદર્શિત કરે છે - કોઈ અંતિમ બિંદુ નથી અને કોઈ SDK પદ્ધતિ નથી જે પરવાનગીને બદલતી નથી. આ સમગ્ર મુદ્દો છે: જો એજન્ટ પ્રોમ્પ્ટ-ઇન્જેક્ટેડ છે અથવા લૂપમાં ફસાઈ ગયો છે, તો તે પોતાની પરવાનગીને વિસ્તૃત કરી શકતું નથી, કારણ કે તે ધરાવે છે તે પ્રમાણપત્ર ક્યારેય તે શક્તિ આપવામાં આવી નથી.

જ્યારે ચુકવણી સક્રિય પરવાનગીની મર્યાદા વધારશે, ત્યારે બેકએન્ડ તેને કોઈપણ ચેઇનને સ્પર્શ કરતા પહેલા નકારી નાખે છે. કોઈ ફંડ ખસે છે. તમારો એજન્ટ તે નકારીને અન્ય કોઈપણ નિષ્ફળ કોલની જેમ સંભાળે છે, અને તમે ડેશબોર્ડમાં પ્રયાસ જુઓ છો જેથી તમે જો તે યોગ્ય હતું તો પરવાનગીને વિસ્તૃત કરી શકો.

તેને API દ્વારા વાંચો

તેને દર્શાવવા અથવા તેની આસપાસની યોજના બનાવવા માટે વર્તમાન પરવાનગી મેળવો.

GET /v1/agents/{id}/spend-permissions જીવંત મૂલ્યો પાછા આપે છે. તેને તમારા UI માં બજેટ બતાવવા માટે ઉપયોગ કરો, અથવા એજન્ટને તપાસવા માટે કે તે ચુકવણી કરવાનો પ્રયાસ કરતા પહેલા કેટલો જગ્યા બાકી છે.

પઢો (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 ત્રણ મૂલ્યોમાંથી એક લે છે. સમયગાળો ફેરવતી વખતે ભથ્થો ફરીથી સેટ થાય છે; per_tx_wei દરેક એકલ ચુકવણી પર લાગુ પડે છે ભથ્થા પર આધાર રાખ્યા વિના.

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.

શું ખર્ચની પરવાનગીઓ આવતી ચુકવણીઓને મર્યાદિત કરે છે?

ના. એક પરવાનગી ફક્ત વોલેટમાંથી પૈસા નીકળવા પર નિયંત્રણ રાખે છે. આવતી USDC ક્યારેય બ્લોક કરવામાં આવતી નથી - કોઈ પણ સમયે કોઈપણ તમારા એજન્ટને ચૂકવી શકે છે. પરવાનગીને બહારની ખર્ચ પર એક-માર્ગી વાલ્વ તરીકે વિચાર કરો; આવતી નિકાસની પુષ્ટિ અલગથી payment.received વેબહૂક દ્વારા થાય છે.

જો કંઈક ખોટું લાગે તો હું ખર્ચને ઝડપથી કેવી રીતે રદ કરું?

ડેશબોર્ડમાં મંજૂરીને રદ કરો - તે revoked_at સેટ કરે છે અને પછીથી મૂલ્યાંકિત કરવામાં આવેલી કોઈપણ ચુકવણી માટે મંજૂરીને શૂન્ય પર લઈ જાય છે. વધુ કઠોર રોકવા માટે તમે એજન્ટની API કી (apiKeys.rotate / apiKeys.revoke) પણ ફેરવી શકો છો અથવા રદ કરી શકો છો, જે સંપૂર્ણપણે પ્રમાણપત્રને કાપે છે. બંને તાત્કાલિક છે; મંજૂરી રદ કરવું શસ્ત્રક્રિયા છે, કી રદ કરવું કિલ સ્વિચ છે.
દસ્તાવેજોમાં ખર્ચ-મંજૂરીઓનો સંદર્ભ

મર્યાદાઓ સાથે ખર્ચ કરો, આશ્ચર્ય સાથે નહીં.

ડેશબોર્ડમાં એક મંજૂરી અને એક ટ્રાન્ઝેક્શન કૅપ સેટ કરો. બેકએન્ડ બાકીના કામ કરે છે.