Earth API

Earth API - это многофункциональный бесплатный REST сервис от разработчиков DevelNext, созданный специально для использования в develnext проектах всеми пользователями нашей среды. Сервис умеет предоставлять разную информацию и выполняет некоторые удобные функции, а также не требует никакой регистрации.

Он располагается по следующему адресу:

https://api.develnext.org/data/v1/

v1 - первая версия api

---

Методы

• Информация об IP (/data/v1/ip/...)
• QR Код (генерация) (/data/v1/qr-code/...)
• Цитаты и афоризмы (/data/v1/quote/...)

---

Информация об IP

  GET  https://api.develnext.org/data/v1/ip/{ip-address}

{ip-address} - можно передать любой ip версии 4 или ключевое слово current, чтобы использовать ip от клиента, который сделал запрос.

Метод возвращает следующую информацию об IP:

• hostname - имя хоста, если оно имеется.
• city - город, к которому принадлежит ip.
• country - страна, к которому принадлежит ip.
• continent - код континента, к которому принадлежит ip, например EU или NA.
• location - временная зона и широта/долгота местоположения по ip.
• postal - почтовый индекс.

Пример запроса и ответа:

GET  https://api.develnext.org/data/v1/ip/108.70.12.107

{
  "ip":"108.70.12.107",
  "hostname":"108-70-12-107.lightspeed.clmasc.sbcglobal.net",
  "city":{
    "id":4575352,
    "name":"Columbia",
    "names":{
      "de":"Columbia",
      "ru":"Колумбия",
      "pt-BR":"Colúmbia",
      "ja":"コロンビア",
      "en":"Columbia",
      "fr":"Columbia",
      "zh-CN":"哥伦比亚",
      "es":"Columbia"
    }
  },
  "country":{
    "id":6252001,
    "iso":"US",
    "name":"United States",
    "names":{
      "de":"USA",
      "ru":"США",
      "pt-BR":"Estados Unidos",
      "ja":"アメリカ合衆国",
      "en":"United States",
      "fr":"États-Unis",
      "zh-CN":"美国",
      "es":"Estados Unidos"
    }
  },
  "continent":"NA",
  "location":{
    "latitude":34.0484,
    "longitude":-81.111,
    "timeZone":"America/New_York",
    "population":null
  },
  "postal":"29210"
}

Как получить текущий IP?

Вернуть информацию о текущем IP клиента:

GET  https://api.develnext.org/data/v1/ip/current

Формат ответа см. выше.

---

QR Код (генерация)

Метод позволяет сконвертировать любой текст не более 2048 символов в изображение QR кода. Метод возвращает изображение в формате png (image/png).

GET https://api.develnext.org/data/v1/qr-code/generate?text={text}&size={size}

Где параметры:

• {text} - текст для конвертирования (обязательный).
• {size} - размер изображения результата QR кодирования, от 64 до 1024 пикселей.

Варианты кодов ответа:

• 200 - изображение сгенерированно корректно.
• 400 - если параметры переданы неверно, ответ в виде строки.

Пример (перейдите по ссылке): https://api.develnext.org/data/v1/qr-code/generate?text=DevelNext&size=300

---

Цитаты и афоризмы

Следующие методы позволяют получать случайные известные цитаты на заданные темы.

GET https://api.develnext.org/data/v1/quote/random?minRating={minRating}&subject={subject}&tags={tags}