Skip to content

Latest commit

 

History

History
108 lines (99 loc) · 3.17 KB

README.md

File metadata and controls

108 lines (99 loc) · 3.17 KB

API

Installation

  • Install git bash.
  • Install docker and docker-compose.
  • Clone repository:
    • git clone https://github.com/SchlafenderFox/Java-API.git
  • Enter to repository folder.
  • Open terminal (Linux) or cmd (Windows).
  • Run API:
    • docker-compose up -d --build
  • Ready.

Info

  • Application port: 9999
  • Run command:
    • docker-compose up -d --build
  • Default request address:
    • localhost:9999/api/get-news/

Category:

  • Allow category:
  • "Всі",
    "Економіка",
    "За кордоном",
    "Здоров'я",
    "Київські новини",
    "Курйози",
    "Події",
    "Політика України",
    "Спорт",
    "Суспільство",
    "Технології",
    "Фоторепортаж",
    "Шоу-бізнес"
    

Language:

  • Allow language:
  • "ua",
    "ru",
    "en"
    

Main endpoints:

  • /api/get-news/:
    • method POST
    • returns news
    • parameters:
      • category:

        • type: string
        • required: True
        • default: Всі
        • example: Економіка
      • time:

        • type: string
        • required: False
        • defaults: 00:00-23:59
        • example: hh:mm, hh:mm-hh:mm, 09:00-10:00
      • date:

        • type: string
        • required: False
        • defaults: today
        • example: dd.mm.yyyy, dd.mm.yyyy-dd.mm.yyyy, 01.01.2019-01.12.2019
      • language:

        • type: string
        • required: False
        • defaults: ua
        • example: en
      • response format:

          {
                "status": "ok",
                "result": [],
                "error": ""
          }
           
          {
            "status": "error",
            "result": [],
            "error": "error message"
          }
      • response example:

        {
          "status": "ok",
          "result": [
                      {
                       "title": "Трамп у розмові з Мей оскаржував висновки розвідслужб Великої Британії щодопричетності Росії до отруєння Скрипаля, - WP",
                       "date": "05.10.19",
                       "time": "23:47",
                       "text": "Президент Сполучених Штатів Америки Дональд Трамп у телефонній розмові з колишнім прем'єр-міністром Великої Британії Терезою Мей засумнівався впричетності Росії до отруєння Скрипалів.", 
                       "url": "https://censor.net.ua/ua/news/3152326/tramp_u_rozmovi_z_meyi_oskarjuvav_vysnovky_rozvidslujb_velykoyi_brytaniyi_schodo_prychetnosti_rosiyi",
                       "img-url": "https://storage1.censor.net/images/1/1/b/b/11bb19b9be3de92f26e09d8b37ec3d8c/censor_news_small.jpg"
                      }
                    ],
          "count": 1,
          "error": ""
        }