В този учебник ще научиш как да добавиш ендпойнт за услугата за чат в твоето Node.js приложение. Целта ни е да създадем прост GET ендпойнт за URL адреса /api/chat, който после да върне отговор на клиента. Този ендпойнт ще бъде свързан по-късно с OpenAI API, за да генерира чат завършвания. Нека започнем директно и да преминем през нужните стъпки.
Най-важните изводи
- Създаване на GET ендпойнт в Node.js приложение
- Използване на JSON за предаване на данни
- Интеграция с OpenAI API за завършване на чат
По стъпки насочване
Стъпка 1: Създаване на API папка
За да гарантирате чист опашлен код, трябва да създадете специална папка за своите API ендпойнти. В твоя React проект, трябва да създадете нов подпапка наречена API под pages директорията.
Стъпка 2: Създаване на chat.js файл
В новосъздадената API папка създай нов файл наречен chat.js. Този файл ще съдържа Node.js кода, който ще се справя с GET заявките.
Стъпка 3: Имплементация на GET хендлър
Трябва да дефинираш GET хендлър в chat.js файла. Този хендлър ще обработва входящите заявки на адреса /api/chat. Важно е функцията да се казва get, защото това е изискване за да бъде разпознат като GET хендлър в Astro.
Стъпка 4: Изграждане на прост отговор
За момента можеш да върнеш прост отговор в JSON формат. За целта използвай new Response() и инициализирай отговора си чрез JSON.stringify(), за да сериализираш обект, който съдържа свойството answer. За този първи тестов отговор просто можеш да напишеш "Hello".
Стъпка 5: Задаване на статус и заглавие
Освен да върнеш тялото на отговора, можеш да добавиш и статус код и заглавие. Задай статуса на 200, което означава, че заявката е била успешна, и дефинирай Content-Type като application/json, за да увериш клиента, че отговорът е в JSON формат.
Стъпка 6: Тестване на ендпойнта в браузъра
След като всичко е настроено, можеш да тестваш ендпойнта. Отвори браузъра си и отиди до локалната си разработвателска среда, като въведеш URL адреса http://localhost:3000/api/chat. Трябва да видиш отговора, който си дефинирал в предишната фаза.
Стъпка 7: Проверка на правилния отговор
Ако въведеш URL-а и видиш правилния JSON отговор в браузъра, това означава, че твоят GET хендлър работи. Тази проста имплементация ще бъде основата за бъдещо разширение, където ще интегрираш OpenAI API за завършване на чата.
Стъпка 8: Разширяване с OpenAI API
В бъдещо видео ще разширим вече имплементирания ендпойнт, за да извлечем завършвания на чата от OpenAI API. Все пак, текущият ендпойнт вече ще ти даде необходимото основно разбиране за HTTP взаимодействията чрез API.
Обобщение
В този урок научихте как да създадете прост GET ендпойнт за вашия Node.js приложение, който връща JSON отговори. Тази основна имплементация е основата за бъдещи разширения, по-специално за интеграцията на OpenAI API, която ще разгледаме в следващото видео.
Често задавани въпроси
Как да създам подпапка в моя проект?Можеш да създадеш подпапка в твоя проект, като създадеш нова папка с име API в директорията pages.
Защо е важно GET хендлъра ми да се казва get?В Astro името на хендлъра е важно за разпознаването на съответния HTTP заявка.
Как да тествам новия си ендпойнт?Въведи URL адреса http://localhost:3000/api/chat в браузъра си, за да провериш отговора на твоя GET хендлър.
Какво ще бъде разгледано в следващото видео?В следващото видео ще разширим текущия ендпойнт, за да извлечем завършвания на чата от OpenAI API.
