{"uid":"cap_mD5tsW1osQG9OQkIQ6VD8","slug":"delx-commerce-api-error-taxonomy-classifier-88ea19cb","name":"Delx Commerce — API Error Taxonomy Classifier","description":"Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.","url":"https://commerce.delx.ai/api/v1/x402/api-error-taxonomy?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"body":{"type":"string","description":"Input field: body."},"status_code":{"type":"number","description":"Input field: status_code."}}},"responseSchema":{"type":"json","example":{"schema":"delx/util-api-error-taxonomy/v1","category":"upstream_transient","retryable":true,"body_sha256":"93a8ba7fde7cf39ab2dea97fc62f4352331bc174e3c4fbed390d9a8153f4787c","status_code":503,"body_returned":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_i76kMP2LgJVbpUEYak1TS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Classifies an HTTP error response body and status code into a structured error taxonomy, returning category, retryability, and a content hash.","exampleAgentPrompt":"I just got a 503 response from an upstream API with body 'Service Unavailable — please try again later'. Can you classify this error using the Delx error taxonomy and tell me whether I should retry?","exampleUseCases":[{"title":"Retry decision for upstream service failure","prompt":"The payment gateway just returned a 503 with body 'Gateway timeout, retry in 30s' — can you run this through the Delx error taxonomy and tell me if it's safe to retry automatically?"},{"title":"Categorizing a client authentication error","prompt":"I got a 401 back from the data provider with body 'Invalid API key provided'. Can you classify this error and tell me what category it falls under and whether retrying makes any sense?"},{"title":"Normalizing errors in an agent pipeline","prompt":"My agent just hit a 429 response with body 'Rate limit exceeded, quota reset in 60 seconds'. Run it through the Delx API error taxonomy so I can decide how to handle it in my retry logic."}],"resultDescription":"Returns a structured JSON object containing: the taxonomy schema version (e.g. 'delx/util-api-error-taxonomy/v1'), an error category string (e.g. 'upstream_transient'), a boolean retryable flag, a SHA-256 hash of the response body for verification, the echoed status code, and a flag indicating whether the body was returned.","failureModes":["Missing or malformed status_code field returns a validation error","Empty body string may result in classification with limited confidence","Unknown or non-standard status codes may produce an 'unknown' category","Payment failure via x402 protocol results in 402 response before processing occurs"],"whenToPreferThis":"Use this endpoint when an AI agent or automated pipeline needs to programmatically decide whether to retry an API call, escalate an error, or log it — especially when normalizing errors from diverse upstream services into a consistent taxonomy. Prefer this over manual error parsing when you need a verifiable, hashed record of the error response for audit purposes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T00:53:48.054Z","isFirstParty":false,"canonicalSlug":"delx-commerce-api-error-taxonomy-classifier-88ea19cb"}