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 & 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
  6. 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
  7. 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
  8. 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
  9. APIs as Products advanced

    A business-banking platform must expose payouts, balances, approvals and reconciliation to customer developers. How should the API surface be structured, and what determines what is exposed?

    2 min answer razorpayxapi-productpermissionsreconciliation
  10. APIs as Products intermediate

    A platform's API is used more heavily than its web interface, and third-party tools built on it drive most adoption. What changes when the API is treated as the primary product rather than as an access mechanism?

    2 min answer api-productdeveloper-experienceversioningecosystem
  11. APIs as Products advanced

    API traffic is dominated by a few automation-heavy customers whose bursts affect everyone. How do you introduce per-tenant quotas and priority without breaking existing integrations?

    3 min answer multi-tenancyquotasfair-queueingmigration
  12. APIs as Products intermediate Multiple choice

    How do you know it is safe to remove a field from a public API, and what would you have needed to build to know that?

    2 min answer deprecationinstrumentationgithubapi-lifecycle