API: запити, JSON, fetch, коди відповідей, безпека
API
Приклади: погода, курси валют, карти, розклад, переклад.
JSON
Дані зазвичай передають у форматі JSON:
{
"city": "Київ",
"temp": 7,
"sky": "хмарно",
"forecast": [8, 6, 5]
}JSON.parse(text) перетворює текст на об’єкт, JSON.stringify(obj) — навпаки.
fetch
async function loadStudents() {
const response = await fetch('/api/students');
if (!response.ok) {
console.error('Помилка', response.status);
return;
}
const students = await response.json();
console.log(students);
}
loadStudents();fetchповертає обіцянку (Promise): результат прийде пізніше.awaitчекає на результат усерединіasync-функції.Завжди перевіряйте
response.ok.
Відправлення даних
await fetch('/api/feedback', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ name: 'Оксана', text: 'Дякую!' }),
});Безпека API
HTTPS обов’язково.
Ключі не зберігайте в коді сторінки (їх видно всім).
Сервер перевіряє права доступу й дані.
Обмеження частоти запитів.
Не довіряйте відповідям сліпо: відображайте через
textContent.
Обробка помилок
try {
const r = await fetch(url);
if (!r.ok) throw new Error('HTTP ' + r.status);
const data = await r.json();
} catch (e) {
msg.textContent = 'Не вдалося завантажити дані';
}У пісочниці нижче доступний навчальний API: /api/students і /api/weather. Відкрийте приклад «Запит до API» та змініть його.
Перевірте себе
Що таке JSON?
Для чого потрібні
asyncіawait?Чому API-ключ не можна зберігати в коді сторінки?