· News API - это простой HTTP REST API для поиска и извлечения активных статей со всего Интернета.
· Мы можем искать статьи по любой комбинации следующих критериев:
1. Ключевое слово или фраза.
2. Дата публикации.
3. Название источника.
4. Имя исходного домена.
5. Язык.
· Мы можем отсортировать результаты в следующем порядке:
-Дата публикации
-Релевантность ключевого слова для поиска
- Популярность источника
АУТЕНТИФИКАЦИЯ
· Аутентификация выполняется с помощью простого ключа API.
· Ключ API прикреплен к первому запросу.
· Это можно сделать одним из трех способов:
-Через параметр строки запроса apiKey.
-Через HTTP-заголовок X-Api-Key.
-Через HTTP-заголовок авторизации. Носитель необязательный, не кодировать по основанию 64.
· В обоих последних двух случаях наш ключ API не виден другим пользователям, ни в журналах, ни при отслеживании запросов.
· Если мы неправильно добавим наш ключ API или наш ключ API недействителен, мы получим ошибку 401 - Unauthorized HTTP.
КОНЕЧНЫЕ ТОЧКИ:
· News API имеет 2 основных конечных точки:
А. Главные заголовки (/ v2 / top-headlines)
Б. Все (/ v2 / everything)
· Также есть второстепенная конечная точка, которую можно использовать для получения небольшого подмножества издателей, от которых мы индексируем
С. Источники (/ v2 / sources)
· Конечная точка возвращает информацию (включая название, описание и категорию) о конкретных источниках, которые мы индексируем.
· Этот список может быть напрямую связан с пользователями, показывая им некоторые из доступных опций.
ОШИБКИ:
Если мы сделаем неверный запрос, мы получим соответствующий код статуса HTTP вместе с дополнительной информацией в теле.
GET https://newsapi.org/v2/everything?q=bitcoin { “status”: “error”, “code”: “apiKeyMissing”, “message”: “Your API key is missing. Append this to the URL with the apiKey param, or use the x-api-key HTTP header.” }