Volcano API
🚀 API Endpoints

đŸ—„ī¸ Cache Management

Cache operations and performance optimization endpoints. 12 endpoints available.

đŸŽ¯ Quick Stats

📊 Methods

  • 📝 POST: 9 endpoints
  • đŸ—‘ī¸ DELETE: 2 endpoints
  • 🔍 GET: 1 endpoints

🔐 Authentication

All endpoints in this section use the same authentication methods. Choose one:

🔑 Bearer Token (Recommended)

For user session authentication

Add to request headers:

Authorization: Bearer YOUR_TOKEN

🔧 API Key

For server-side authentication

Add to request headers:

X-API-KEY: YOUR_API_KEY

âš ī¸ Important: Do not use both authentication methods simultaneously in the same request.

🔗 Endpoints Overview

MethodEndpointDescription
📝 POST/cache/invalidate/user/{userId}Invalidate user cache
📝 POST/cache/invalidate/merchant/{merchantId}Invalidate merchant cache
📝 POST/cache/invalidate/card/{cardId}Invalidate card cache
📝 POST/cache/invalidate/card-productInvalidate card product cache
📝 POST/cache/invalidate/orderInvalidate order cache
📝 POST/cache/invalidate/transactionInvalidate transaction cache
📝 POST/cache/invalidate/walletInvalidate wallet cache
📝 POST/cache/invalidate/roles-permissionsInvalidate roles and permissions cache
📝 POST/cache/invalidate/allInvalidate all cache
đŸ—‘ī¸ DELETE/cache/key/{key}Delete specific cache key
đŸ—‘ī¸ DELETE/cache/pattern/{pattern}Delete cache by pattern
🔍 GET/cache/statsGet cache statistics

📖 Detailed Documentation

Invalidate user cache

POST/cache/invalidate/user/{userId}
Full URL
https://api.market.decenctype.com/cache/invalidate/user/{userId}

đŸŽ¯ Path Parameters

  • userId (string) - ✅ Required: User ID

Description: Invalidate user cache

Operation ID: invalidateUserCache

Response Status:

  • ✅ 200: User cache invalidated successfully
  • ✅ 201: Success

📝 Example Request

curl -X POST "https://api.market.decenctype.com/cache/invalidate/user/example-id" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Invalidate merchant cache

POST/cache/invalidate/merchant/{merchantId}
Full URL
https://api.market.decenctype.com/cache/invalidate/merchant/{merchantId}

đŸŽ¯ Path Parameters

  • merchantId (string) - ✅ Required: Merchant ID

Description: Invalidate merchant cache

Operation ID: invalidateMerchantCache

Response Status:

  • ✅ 200: Merchant cache invalidated successfully
  • ✅ 201: Success

📝 Example Request

curl -X POST "https://api.market.decenctype.com/cache/invalidate/merchant/example-id" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Invalidate card cache

POST/cache/invalidate/card/{cardId}
Full URL
https://api.market.decenctype.com/cache/invalidate/card/{cardId}

đŸŽ¯ Path Parameters

  • cardId (string) - ✅ Required: Card ID

Description: Invalidate card cache

Operation ID: invalidateCardCache

Response Status:

  • ✅ 200: Card cache invalidated successfully
  • ✅ 201: Success

📝 Example Request

curl -X POST "https://api.market.decenctype.com/cache/invalidate/card/example-id" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Invalidate card product cache

POST/cache/invalidate/card-product
Full URL
https://api.market.decenctype.com/cache/invalidate/card-product

📋 Query Parameters

ParameterTypeRequiredDescription
cardProductIdstring❌Card Product ID

Description: Invalidate card product cache

Operation ID: invalidateCardProductCache

Response Status:

  • ✅ 200: Card product cache invalidated successfully
  • ✅ 201: Success

📝 Example Request

curl -X POST "https://api.market.decenctype.com/cache/invalidate/card-product" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Invalidate order cache

POST/cache/invalidate/order
Full URL
https://api.market.decenctype.com/cache/invalidate/order

📋 Query Parameters

ParameterTypeRequiredDescription
orderIdstring❌Order ID
orderTypestring❌Order Type

Description: Invalidate order cache

Operation ID: invalidateOrderCache

Response Status:

  • ✅ 200: Order cache invalidated successfully
  • ✅ 201: Success

📝 Example Request

curl -X POST "https://api.market.decenctype.com/cache/invalidate/order" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Invalidate transaction cache

POST/cache/invalidate/transaction
Full URL
https://api.market.decenctype.com/cache/invalidate/transaction

📋 Query Parameters

ParameterTypeRequiredDescription
transactionIdstring❌Transaction ID
accountIdstring❌Account ID

Description: Invalidate transaction cache

Operation ID: invalidateTransactionCache

Response Status:

  • ✅ 200: Transaction cache invalidated successfully
  • ✅ 201: Success

📝 Example Request

curl -X POST "https://api.market.decenctype.com/cache/invalidate/transaction" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Invalidate wallet cache

POST/cache/invalidate/wallet
Full URL
https://api.market.decenctype.com/cache/invalidate/wallet

📋 Query Parameters

ParameterTypeRequiredDescription
userIdstring❌User ID
merchantIdstring❌Merchant ID

Description: Invalidate wallet cache

Operation ID: invalidateWalletCache

Response Status:

  • ✅ 200: Wallet cache invalidated successfully
  • ✅ 201: Success

📝 Example Request

curl -X POST "https://api.market.decenctype.com/cache/invalidate/wallet" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Invalidate roles and permissions cache

POST/cache/invalidate/roles-permissions
Full URL
https://api.market.decenctype.com/cache/invalidate/roles-permissions

🔐 Authentication: Required (see authentication section above)

Description: Invalidate roles and permissions cache

Operation ID: invalidateRolePermissionCache

Response Status:

  • ✅ 200: Roles and permissions cache invalidated successfully
  • ✅ 201: Success

📝 Example Request

curl -X POST "https://api.market.decenctype.com/cache/invalidate/roles-permissions" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Invalidate all cache

POST/cache/invalidate/all
Full URL
https://api.market.decenctype.com/cache/invalidate/all

🔐 Authentication: Required (see authentication section above)

Description: Invalidate all cache

Operation ID: invalidateAllCache

Response Status:

  • ✅ 200: All cache invalidated successfully
  • ✅ 201: Success

📝 Example Request

curl -X POST "https://api.market.decenctype.com/cache/invalidate/all" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Delete specific cache key

DELETE/cache/key/{key}
Full URL
https://api.market.decenctype.com/cache/key/{key}

đŸŽ¯ Path Parameters

  • key (string) - ✅ Required: Cache key

Description: Delete specific cache key

Operation ID: deleteCacheKey

Response Status:

  • ✅ 200: Cache key deleted successfully

📝 Example Request

curl -X DELETE "https://api.market.decenctype.com/cache/key/example-key" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Delete cache by pattern

DELETE/cache/pattern/{pattern}
Full URL
https://api.market.decenctype.com/cache/pattern/{pattern}

đŸŽ¯ Path Parameters

  • pattern (string) - ✅ Required: Cache key pattern

Description: Delete cache by pattern

Operation ID: deleteCacheByPattern

Response Status:

  • ✅ 200: Cache pattern deleted successfully

📝 Example Request

curl -X DELETE "https://api.market.decenctype.com/cache/pattern/example-pattern" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Get cache statistics

GET/cache/stats
Full URL
https://api.market.decenctype.com/cache/stats

🔐 Authentication: Required (see authentication section above)

Description: Get cache statistics

Operation ID: getCacheStats

Response Status:

  • ✅ 200: Cache statistics retrieved successfully

📝 Example Request

curl -X GET "https://api.market.decenctype.com/cache/stats" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"