Idempotency Docs Audit

Audit public API documentation for idempotency-key and safe-retry coverage, then export one structured checklist row per docs URL.

Use this Actor to review whether API docs explain idempotency keys, duplicate request handling, request scope, retry safety, expiration windows, supported operations, conflict behavior, and implementation examples.

This is an unofficial documentation-audit utility. It reviews public docs only; it does not test live API behavior or certify that a provider's implementation is idempotent.

Common use cases

Use case	Why it helps
API launch readiness	Check whether developers can safely retry create/update operations.
Payments / order-flow docs review	Triage retry-risk documentation before integrating critical workflows.
Vendor diligence	Compare how clearly providers document duplicate handling and key scope.
SDK/client design	Identify docs gaps that should shape retry, timeout, and conflict handling.
DevRel QA	Produce repeatable evidence rows before a deeper human documentation review.

Input

Provide public HTTP(S) API documentation URLs. Direct idempotency or retry-safety pages work best.

{
  "startUrls": [
    { "url": "https://docs.stripe.com/api/idempotent_requests" }
  ],
  "maxPagesPerSite": 3,
  "timeoutSecs": 20,
  "sameHostOnly": true
}

Input fields

Field	Type	Default	Notes
startUrls	array	required	Public API docs or developer-portal URLs to audit.
maxPagesPerSite	integer	8	Maximum successful pages analyzed per input URL.
timeoutSecs	integer	20	HTTP timeout per page request.
sameHostOnly	boolean	true	Keeps candidate links on the same host as the input URL.

Do not submit confidential, authenticated, internal, or non-public documentation URLs.

Output

The Actor writes one dataset item per input URL. Rows include:

• domain, inputUrl, and normalized URL details
• auditScore, grade, and riskLevel
• checklist booleans for idempotencyDocsFound, idempotencyKeyDocumented, safeRetryGuidance, duplicateHandlingDocumented, requestScopeDocumented, expirationWindowDocumented, supportedOperationsDocumented, and conflictErrorDocumented
• bestPageUrl, evidence URLs/snippets, pages analyzed, URLs fetched, warnings, and recommendations

Pricing

from $4.00 / 1,000 audited idempotency documentation URLs

This Actor uses Apify Pay per Event pricing with platform usage included. The row event is charged only for useful rows written to the default dataset.

Event	Price	Unit
Actor start (apify-actor-start)	$0.00005	Once when the run starts.
Idempotency docs audit row (apify-default-dataset-item)	$0.004	Per audited idempotency documentation URL row.

A row is one public idempotency documentation URL audit result. Apify plan discounts, user-configured max-charge limits, and any future Apify pricing UI changes may affect final charges.

Limitations and responsible use

• This is a heuristic documentation audit, not legal advice, security certification, penetration testing, or live API validation.
• Results describe what the public docs appear to say; they do not prove duplicate handling works correctly in production.
• JavaScript-heavy, blocked, sparse, or login-gated documentation may under-score.
• Human review is recommended before relying on results for high-stakes vendor, security, procurement, or compliance decisions.
• Use only with documentation you are allowed to access and review.

Data handling

The Actor fetches the public URLs supplied in the input and, when enabled, a small set of same-host candidate links. It writes structured audit rows to the run's default dataset and intentionally avoids storing full page contents in output.

Related Actors in this portfolio

This Actor is part of the API documentation reliability audits group. These are narrow, source-specific Apify Actors intended for scheduled checks and repeatable dataset exports — not broad scraped-content feeds.

• Webhook Signature Docs Audit — Webhook signature-verification documentation audit for integration readiness.
• Rate Limit Docs Audit — API rate-limit documentation audit for quota, header, reset, and retry clarity.
• Idempotency Docs Audit — API idempotency documentation audit for retry-safety and duplicate handling.
• API Error Contract Docs Audit — API error-contract documentation audit for status codes, error bodies, and examples.

Each listing includes its own source notes, limits, pricing, and responsible-use caveats. Use the official source links in each Actor when decisions require verification.