From 1dd7726d3aa3bff0cbf907054f8792767a617685 Mon Sep 17 00:00:00 2001 From: adnqcr7-code Date: Thu, 20 Aug 2026 01:55:19 +0000 Subject: [PATCH] docs: add data workflow guidance --- docs/error-handling.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 docs/error-handling.md diff --git a/docs/error-handling.md b/docs/error-handling.md new file mode 100644 index 0000000..f6095c3 --- /dev/null +++ b/docs/error-handling.md @@ -0,0 +1,5 @@ +# Extraction error handling + +Applications using the SDK should distinguish request failures from extraction failures. A request failure means the source could not be reached or rejected the request; an extraction failure means a response was received but did not satisfy the requested shape. + +Callers should preserve the request identifier and provider response metadata while avoiding the storage of credentials or full private page contents in logs. Retry only transient transport failures, not validation errors caused by an invalid extraction instruction.