Listening: API Integration Support Call
A developer support call about API authentication issues. 3 questions on diagnostic question vocabulary, error description language, and call closing phrases.
API support call vocabulary — essentials
- diagnostic question — a targeted question to isolate a specific variable causing the issue
- skewed — offset, out of sync (clock skew = server/client time mismatch)
- 401 Unauthorized — authentication failure; credentials invalid or missing
- "Does that work for you?" — closing confirmation phrase; seeking agreement on resolution
- NTP-synced — time kept accurate by Network Time Protocol; prevents clock skew
0 / 3 completed
1 / 3
Developer on support call: "We're getting a 401 on every POST to your payment endpoint. We've double-checked the API key — it looks correct in our config."
The support engineer asks: "Are you passing the key in the Authorization header, or as a query parameter?"
Why is this a good diagnostic question?
The support engineer asks: "Are you passing the key in the Authorization header, or as a query parameter?"
Why is this a good diagnostic question?
Diagnostic questions in API support calls isolate variables to narrow down the root cause. A 401 Unauthorized error can occur even with a valid API key if the key is being sent incorrectly.
Why this question targets the right variable:
Why this question targets the right variable:
- API keys can be sent in different ways:
Authorization: Bearer <key>,X-API-Key: <key>, or as?api_key=in the URL - If the developer is sending it in the wrong place (e.g., query param when it should be a header), the key is effectively ignored
- "Are you sending X as Y or Z?" — isolates the implementation method
- "What does the full request look like?" — asks for the raw request to diagnose
- "Can you share the exact error response body?" — gets the specific error message
- "Which SDK version are you using?" — checks for known bugs