与 API 对话
借助人工智能从网络获取数据。
与 API 对话 是 CoddyKit 上的免费 Vibe Coding 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Vibe Coding 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Vibe Coding 课程共包含 4 节课。
本课时的部分内容尚未翻译，以英文显示。
Apps Talk to Other Apps
Real apps rarely live alone. A weather app asks a weather service for data. A crypto tracker asks a price service. The way apps ask each other for data is called an API — an Application Programming Interface.
Think of an API like a waiter: you don't go into the kitchen, you just ask for what you want and the waiter brings it back. As a vibe coder, you mostly describe what data you need, and AI writes the code that talks to the API for you.
What 'Fetching Data' Means
When your app gets data from the internet, we say it fetches it. The app sends a request to a URL, and the service sends back data — usually as JSON, a simple text format that looks like labeled boxes of values.
You don't need to memorize how this works. You just need to know the words so you can tell AI: 'fetch the data and show it on the page.'
{
"city": "Tokyo",
"temperature": 21,
"condition": "Sunny"
}Your First API Prompt
Let's ask AI to fetch real data. The trick is to name the data you want and where to show it. Here is a prompt you could paste into Cursor, Claude Code, Bolt or v0.
Notice how the prompt names a specific free API and exactly what to display. Specific prompts get working code on the first try.
Create a single HTML page that fetches a random
activity from the Bored API
(https://www.boredapi.com/api/activity) when the
page loads, and displays the activity text in a
big centered card. Add a "Give me another" button
that fetches a new one. Use plain JavaScript, no
frameworks.What fetch() Looks Like
When AI writes the code, you'll often see a fetch() call. You don't have to write it by hand, but recognizing it helps you read what AI gives you.
This tiny example fetches a fake user and logs their name. Run it to see data come back from the internet.
fetch('https://jsonplaceholder.typicode.com/users/1')
.then(response => response.json())
.then(user => {
console.log('Name:', user.name);
console.log('Email:', user.email);
});Reading JSON Responses
API data comes back as JSON. To use a value, you reach into it by name with a dot, like user.name. Nested data uses more dots: user.address.city.
When you're unsure what's inside a response, ask AI: 'log the full response so I can see its shape, then show me how to read the fields I need.'
const user = {
name: 'Ada',
address: { city: 'London' }
};
console.log(user.name);
console.log(user.address.city);Handling Slow or Failed Requests
The internet isn't always reliable. A request can be slow, or the service can be down. Good apps show a loading message while waiting and a friendly error message if something breaks.
Always remind AI to handle these. A prompt like the one below produces a much more robust app than just 'fetch the data.'
Add a loading spinner while the data is being
fetched, and if the request fails, show a friendly
message like "Couldn't load data, try again" with
a retry button. Don't let the app crash on errors.Free APIs to Practice With
You can build a lot with free, no-signup APIs. Great ones for learning:
- JSONPlaceholder — fake users, posts and todos
- Open-Meteo — real weather, no key needed
- REST Countries — country info and flags
- The Cat / Dog API — random pet pictures
Tell AI which one to use and what to display, and you have a working app in minutes.
Build a country explorer page using the REST
Countries API (https://restcountries.com/v3.1/all).
Show each country's flag, name, and population in a
grid of cards. Add a search box that filters
countries by name as I type.API Keys: Why Some APIs Need One
Some services need to know who is asking, so they give you an API key — a secret password for your app. You include it with each request.
Keys keep services from being abused, but they must be kept secret. For now, just know that 'this API needs a key' means an extra setup step. We cover keeping keys safe in a later lesson.
Asking AI to Wire Up an API
When you have an API's documentation, you can hand it to AI directly. Paste the example URL and a sample response, and let AI map it to your screen.
This is one of the biggest vibe-coding superpowers: you don't read the docs deeply, you let AI translate them into working code.
Here is an example API response from the weather
service:
{"current":{"temperature_2m":18.4,"wind_speed_10m":7}}
Fetch from
https://api.open-meteo.com/v1/forecast?latitude=52.5&longitude=13.4¤t=temperature_2m,wind_speed_10m
and display the temperature and wind speed in two
labeled boxes on the page.Combining Multiple APIs
Powerful apps mix data from several sources. A travel app might combine a country API for facts, a weather API for the forecast, and an image API for photos.
You can ask AI to combine them step by step. Build one API first, confirm it works, then say 'now also add the weather for that country.' Small steps keep the AI accurate.
Now extend the country page: when I click a
country card, fetch that country's current weather
from Open-Meteo using its capital coordinates and
show it in a popup. Keep the existing search
feature working.You Don't Need to Memorize APIs
There are thousands of APIs, and you'll never memorize them. The vibe-coding skill is knowing the vocabulary — fetch, request, response, JSON, key — so you can describe what you want clearly.
Whenever you hit a new API, paste its docs to AI and say what data you need and where to show it. That single habit unlocks almost any data source on the web.
Quick Check
An API sends data back to your app, usually in a simple text format with labeled values. What is that format most commonly called?
Recap: Talking to APIs
You learned that apps fetch data from other services through APIs, usually getting back JSON. You saw fetch() in action, how to read response fields with dots, and why apps need loading and error states.
Most importantly: you don't memorize APIs — you describe the data you want and let AI wire it up, pasting docs and example responses when needed. Next, you'll have AI read and save files for your apps.
常见问题解答
「与 API 对话」课时是免费的吗？
是的 — 「与 API 对话」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Vibe Coding 课程的其余内容，请升级到 CoddyKit PRO。 Vibe Coding 课程共包含 4 节课。
「与 API 对话」这节课中我会学到什么？
借助人工智能从网络获取数据。 你通过在浏览器中直接运行的动手代码来练习 Vibe Coding，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Vibe Coding 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Vibe Coding 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「与 API 对话」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Vibe Coding 课中编写并运行代码吗？
能。每节 Vibe Coding 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。