Prompt · Website Developers
Create API Troubleshooting Guide
Use this when you need a comprehensive guide to diagnose and resolve common API issues.
How to use it
- Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
- Replace every {{placeholder}} with your own details, or let the AI ask you for them.
- 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
- If any required context is missing, ask for it before proceeding.
- Compile a list of common API issues relevant to the provided API and context.
- For each issue, provide a clear description, likely causes, and step-by-step troubleshooting steps.
- Include code snippets or configuration examples where helpful.
- 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?