​
Adding a Rest API

Let’s use the OpenWeatherMap API as an example. This is a popular weather API that provides current weather data for any location.

​
Example: OpenWeatherMap API

API Endpoint: https://api.openweathermap.org/data/2.5/weather

Method: GET

Headers:

json

{
  "Content-Type": "application/json"
}

Query Parameters:

  • q: The city name (e.g., London)

  • appid: Your API key from OpenWeatherMap

  • units: Units of measurement (optional, e.g., metric for Celsius)

​
Example Request

URL:

https://api.openweathermap.org/data/2.5/weather?q=London&appid=YOUR_API_KEY&units=metric

Headers:

json

{
  "Content-Type": "application/json"
}

Body (JSON):

json

{}

​
How to Set Up in Botcraft Pro

  1. Select Data Source: REST API

  2. Method: GET

  3. URL: https://api.openweathermap.org/data/2.5/weather?q=London&appid=YOUR_API_KEY&units=metric

  4. Headers:

    json

    {
  "Content-Type": "application/json"
}

  5. Body (JSON):

    json

    {}

  6. Chat Model: Choose your preferred model (e.g., GPT-3.5 Turbo)

  7. Embedding Model: Choose your preferred embedding model (e.g., text-embedding-ada-002)

  8. Click Create

​
Example Response

A successful response from the OpenWeatherMap API will look something like this:

json

{
  "coord": {
    "lon": -0.1257,
    "lat": 51.5085
  },
  "weather": [
    {
      "id": 800,
      "main": "Clear",
      "description": "clear sky",
      "icon": "01d"
    }
  ],
  "base": "stations",
  "main": {
    "temp": 15.5,
    "feels_like": 14.8,
    "temp_min": 14.0,
    "temp_max": 17.0,
    "pressure": 1015,
    "humidity": 72
  },
  "visibility": 10000,
  "wind": {
    "speed": 3.09,
    "deg": 240
  },
  "clouds": {
    "all": 0
  },
  "dt": 1624531200,
  "sys": {
    "type": 2,
    "id": 2019646,
    "country": "GB",
    "sunrise": 1624508400,
    "sunset": 1624564800
  },
  "timezone": 3600,
  "id": 2643743,
  "name": "London",
  "cod": 200
}

Replace YOUR_API_KEY with your actual API key from OpenWeatherMap. If you don’t have an API key, you can sign up for one here.

This setup will allow your bot to fetch and display current weather information for the specified location.