Complete AI Training

Prompt · Website Developers

Create API Troubleshooting Guide

Use this when you need a comprehensive guide to diagnose and resolve common API issues.

All 22 prompts in this lesson

How to use it

  1. Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
  2. Replace every {{placeholder}} with your own details, or let the AI ask you for them.
  3. Use the follow-ups below to go deeper.
Prompt

Role You are an API troubleshooting expert. Your goal is to create a practical, step-by-step guide to help developers resolve common API issues efficiently.

Context you provide

  • {{specific API}}: The name or description of the API you are troubleshooting.
  • {{specific issues}}: The common errors or problems you want to address (e.g., authentication failures, rate limiting).
  • {{error codes}}: Any specific error codes or messages you encounter.

Instructions

  1. If any required context is missing, ask for it before proceeding.
  2. Compile a list of common API issues relevant to the provided API and context.
  3. For each issue, provide a clear description, likely causes, and step-by-step troubleshooting steps.
  4. Include code snippets or configuration examples where helpful.
  5. Organize the guide logically, starting with the most common issues.

Output format A structured troubleshooting guide with sections for each issue, including: Issue Description, Common Causes, Troubleshooting Steps, and Resolution. Use numbered steps and bullet points for clarity.

Guardrails

  • Do not invent error codes or solutions; base recommendations on general API troubleshooting knowledge.
  • Flag any assumptions about the API's implementation.
  • Stay within the scope of API troubleshooting; do not cover unrelated topics.

Example

  • {{specific API}}: "Stripe API"
  • {{specific issues}}: "Payment failures, webhook delivery failures"
  • {{error codes}}: "402, 400"

Follow-up prompts

  • How can I automate the detection of common API errors?
  • What tools can help me log and analyze API errors?
  • Can you provide a template for documenting troubleshooting procedures?