How to Connect an External API

Overview

Calling an external API safely means doing it from the server, with the key stored as a secret and real error handling around the response.

Beginner explanation: If the key is in the browser, anyone can read it and use it on your account.

Technical explanation: Put the call in a server function, read the secret inside the handler, check the response status before parsing, and surface the provider status and message when it fails.

Steps

1. Store the API key as a server-side secret.
2. Write a server function that makes the request.
3. Validate the input before calling out.
4. Check the response status before parsing the body.
5. Return a useful error to the interface, and log the provider detail server-side.

:::tip Check the response status before parsing JSON. Parsing first throws away the provider error message that tells you what went wrong. :::

What to check afterwards

• The call works with valid input
• Invalid input is rejected before the call
• Provider failures produce a readable message, not a blank screen

Common problems

• Key in frontend code.
• No status check before parsing.
• Swallowing errors into a generic message so you cannot diagnose anything.

Where people get stuck

If you have followed the steps and the result still is not right, the fastest path is usually to describe the exact behaviour you expected, the behaviour you got, and any error text, then ask for a fix in one focused follow-up prompt. If that loop is not converging, hand it over.