docs(scenarios): the Scenarios section — 17 real-world API integration problems - #638

Open

rejifald wants to merge 30 commits into

mainfrom

claude/api-integration-scenarios-436a38

Commits on Aug 5, 2026

docs(scenarios): add the Scenarios section, starting with rotating OAuth2 refresh tokens

rejifald
and
claude
committed
5512f9b
docs(scenarios): cost-based rate limits — the quota is in the body, not the status

rejifald
and
claude
committed
1e42923
docs(scenarios): batch writes where the retry unit is smaller than the request

rejifald
and
claude
committed
141ab49
docs(scenarios): the async job triangle — submit, poll, download

rejifald
and
claude
committed
5a18ab1
docs(scenarios): a stream that fails after 800 tokens

rejifald
and
claude
committed
0f9cc3e
docs(scenarios): the free poll — ETag revalidation and the bodyless 304

rejifald
and
claude
committed
f3015fd
docs(scenarios): the upload you must clean up after

rejifald
and
claude
committed
202edd6
docs(scenarios): receiving a signed webhook — where the boundary actually is

rejifald
and
claude
committed
0341f7b
docs(scenarios): one customer's revoked token, everyone's outage

rejifald
and
claude
committed
d466b03
docs(scenarios): failing over to the backup provider

rejifald
and
claude
committed
b7e0ef4
docs(scenarios): the page that moved while you were reading it

rejifald
and
claude
committed
4e480fc
docs(scenarios): the vendor changed the shape for 5% of responses

rejifald
and
claude
committed
77e11f2
docs(scenarios): the export that eats the heap

rejifald
and
claude
committed
aa90c11
docs(scenarios): the signature that expired in your own queue

rejifald
and
claude
committed
39e9b68
docs(scenarios): the charge you can't confirm

rejifald
and
claude
committed
bc23cf6
docs(scenarios): one list, a hundred follow-up calls

rejifald
and
claude
committed
a2fc68c
docs(scenarios): the vendor told you for six months, in a header

rejifald
and
claude
committed
cbb6a63
docs(scenarios): register the Scenarios section in the content manifest

rejifald
and
claude
committed
f5b6d54
docs(scenarios): file the top three drafts as GitHub issues

rejifald
and
claude
committed
60ef3ed
docs(scenarios): file three more drafts — the credential broadcast and the paginate pair

rejifald
and
claude
committed
fc491b6
docs(scenarios): the agent picks the arguments — MCP boundary, measured

rejifald
and
claude
committed
75aeebe
docs(scenarios): file input-schema filtering issue as #648

rejifald
and
claude
committed
822eadf
docs(scenarios): the mock that passed for six months — the clock table

rejifald
and
claude
committed
5290764
docs(scenarios): file testing-kit clock gaps as #650

rejifald
and
claude
committed
89b2288
docs(scenarios): file ten non-security issue drafts as #651-#660

rejifald
and
claude
committed
b13adfa
docs(scenarios): the ID that changed on the way in

rejifald
and
claude
committed
f5e0b68
docs(scenarios): finding 2 of #651 is fixed — `.safe()` no longer downgrades

rejifald
and
claude
committed
7963985
docs(scenarios): the customer data you didn't mean to log

rejifald
and
claude
committed
d490c5b
docs(scenarios): the migration you have to run twice

rejifald
and
claude
committed
e595f9c
docs(scenarios): register the five unlisted scenario pages in the manifest

rejifald
and
claude
committed
fd81a04

Navigation Menu

docs(scenarios): the Scenarios section — 17 real-world API integration problems - #638

docs(scenarios): the Scenarios section — 17 real-world API integration problems#638
rejifald wants to merge 30 commits into
mainfrom
claude/api-integration-scenarios-436a38

Commits on Aug 5, 2026

docs(scenarios): add the Scenarios section, starting with rotating OAuth2 refresh tokens

docs(scenarios): cost-based rate limits — the quota is in the body, not the status

docs(scenarios): batch writes where the retry unit is smaller than the request

docs(scenarios): the async job triangle — submit, poll, download

docs(scenarios): a stream that fails after 800 tokens

docs(scenarios): the free poll — ETag revalidation and the bodyless 304

docs(scenarios): the upload you must clean up after

docs(scenarios): receiving a signed webhook — where the boundary actually is

docs(scenarios): one customer's revoked token, everyone's outage

docs(scenarios): failing over to the backup provider

docs(scenarios): the page that moved while you were reading it

docs(scenarios): the vendor changed the shape for 5% of responses

docs(scenarios): the export that eats the heap

docs(scenarios): the signature that expired in your own queue

docs(scenarios): the charge you can't confirm

docs(scenarios): one list, a hundred follow-up calls

docs(scenarios): the vendor told you for six months, in a header

docs(scenarios): register the Scenarios section in the content manifest

docs(scenarios): file the top three drafts as GitHub issues

docs(scenarios): file three more drafts — the credential broadcast and the paginate pair

docs(scenarios): the agent picks the arguments — MCP boundary, measured

docs(scenarios): file input-schema filtering issue as #648

docs(scenarios): the mock that passed for six months — the clock table

docs(scenarios): file testing-kit clock gaps as #650

docs(scenarios): file ten non-security issue drafts as #651-#660

docs(scenarios): the ID that changed on the way in

docs(scenarios): finding 2 of #651 is fixed — `.safe()` no longer downgrades

docs(scenarios): the customer data you didn't mean to log

docs(scenarios): the migration you have to run twice

docs(scenarios): register the five unlisted scenario pages in the manifest