1. API Documentation intermediate

    A team generates its entire API reference from code annotations and deletes the hand-written guide. Six months later integrators are opening more support tickets, not fewer, and every one of them is technically answerable from the reference. What did generation buy, and what did it destroy?

    2 min answer hugging faceapi documentationdeveloper experiencedrift
  2. API Documentation intermediate

    A workspace platform's API is well designed but developers repeatedly build integrations that break under real conditions. What is missing from the documentation, and what should be added?

    2 min answer api-documentationdeveloper-experiencesemanticsnotion
  3. API Documentation intermediate

    Why is documenting an API's failure and retry semantics more important than documenting its success behaviour?

    2 min answer documentationstripeidempotencydeveloper-experience
  4. API Documentation intermediate

    Your platform has 60 internal APIs. Teams repeatedly rebuild capabilities that already exist because they cannot find or understand them. What do you build?

    2 min answer documentationdeveloper-portaldiscoveryspec-first
  5. API Gateway advanced

    A developer platform's API gateway has accumulated business logic and become a bottleneck for every team. What should be moved out, and what belongs there?

    2 min answer api-gatewayscopebottleneckdistributed-monolith
  6. API Gateway advanced

    A public API is being overwhelmed by a handful of clients. Where should rate limiting live, which algorithm, and how should limits differ across users, tenants, endpoints and infrastructure?

    3 min answer rate-limitinggatewaycloudflaremulti-tenancy
  7. API Gateway advanced

    A ticketing platform at Ticketmaster's on-sale peaks routes everything through one gateway. Gateway to BFF to inventory is three hops and each hop retries up to three times on a timeout or a 5xx. Inventory's p99 crosses its 400 ms timeout at 09:00:02. Walk the next ninety seconds and say where the limit actually has to live.

    3 min answer api gatewayretriesretry budgetadmission control
  8. API Gateway intermediate

    An API gateway has accumulated authentication, rate limiting, routing, response transformation, request validation and some business logic. Which of these belong there?

    2 min answer razorpaygatewaycross-cuttingcoupling
  9. API & Integration advanced

    A multi-product SaaS company exposes REST APIs, webhooks, an app marketplace, OAuth-scoped integrations and embedded plugins. Which integration surface creates the most long-term architectural constraint, and why?

    2 min answer integrationextensibilitypluginsmarketplace
  10. API & Integration advanced

    An authentication provider's API is on the critical path of thousands of applications. What does that dependency position demand architecturally?

    2 min answer clerkauth0identityavailability
  11. API & Integration intermediate Multiple choice

    You are designing APIs for a platform with a web app, a mobile app, internal service-to-service traffic and third-party partners. What do you expose, and where?

    2 min answer restgraphqlgrpcapi-design
  12. API & Integration advanced

    You run a communications API of Twilio's shape, whose customers' businesses stop when you are degraded. An enterprise customer wants a contractual per-endpoint p99 latency SLA written into their renewal. Walk me through your answer.

    3 min answer twilioslalatencycontracts