Quick Start Guide | JuheAPI Document

Getting started with JUHE API is quick and easy! This guide will walk you through the basics to help you make your first API call in just minutes. Let's dive in!

Sign Up for an Account

Before you can start using our APIs, you'll need to create a JUHE API account:

Visit juheapi.com and click the Sign Up button
Fill in your details (name, email, password)
Verify your email address by clicking the link in the confirmation email
Complete your profile with your company or developer information

🎉 Fun Fact: Did you know that over 75% of developers are able to make their first API call within 5 minutes of creating an account? Challenge accepted!

Get Your API Key

Every request to JUHE API requires authentication using an API key:

Log in to your JUHE API console at juheapi.com/console
Navigate to My Apps in the left sidebar
Click Create Your First App
Name your app (e.g., "Development," "Production")
Copy the Generate Key
Subscribe the API you plan to use

⚠️ Important: Keep your API key secure! Never share it publicly or commit it to version control systems. Treat it like a password.

💡 Pro Tip: Create different API keys for development and production environments. This makes it easier to track usage and rotate keys if needed.

Make Your First API Call

Now for the exciting part—making your first API call! Let's try the Weather API, one of our most popular services:

Using cURL

curl -X GET "https://hub.juheapi.com/weather/v1/city?apikey=YOUR_API_KEY"

Using JavaScript

const params = {
    apikey: 'YOUR_API_KEY'
};

const queryString = new URLSearchParams(params).toString();
const url = `https://hub.juheapi.com/weather/v1/city?${queryString}`;

fetch(url)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Using Python

import requests

params = {
    'apikey': 'YOUR_API_KEY'
}

response = requests.get('https://hub.juheapi.com/weather/v1/city', params=params)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f'Error: {response.status_code}')

🌞 Fun Challenge: Try changing the location parameter to your hometown and see what weather data you get back!

Process the Response

After making your API call, you'll receive a JSON response. Here's an example of what the response might look like:

{
  "code": "200",
  "msg": "Success",
  "data": {
    "name": "Los Angeles",
    "weather": "Clear",
    "weather_description": "clear sky",
    "temp": "21.5°C",
    "humidity": "75%",
    "pressure": "1012 hPa",
    "sunrise": "05:44",
    "sunset": "20:08",
    "coord": {
      "lon": -118.2437,
      "lat": 34.0522
    },
    "wind_speed": "2.1 m/s",
    "wind_deg": "240°",
    "timezone": "-25200"
  }
}

Working with the Response

Here's how to extract and use the data in JavaScript:

// Assuming you have the response stored in a variable called 'data'
if (data.msg === "success") {
  const name = data.data.name;
  const weather = data.data.weather;
  const temp = data.data.temp;
  const humidity = data.data.humidity;

  console.log(`Current weather in ${name}: ${temp}°C and ${humidity}`);
} else {
  console.error("Error:", data.message || "Failed to get weather data");
}

🎮 Fun Activity: Create a simple weather dashboard that displays the current conditions for your favorite cities. You can use HTML, CSS, and the JavaScript code above as a starting point!

Next Steps

Congratulations! You've successfully made your first API call to JUHE API. Here's what to explore next:

Check out our Basic Integration guide for more in-depth information
Explore other API categories that might be useful for your project
Learn about rate limits and usage tiers
Browse our Integration Examples for your preferred programming language

Remember, if you encounter any issues or have questions, our support team is here to help!

💪 Challenge: Can you integrate two different JUHE APIs in a single application? For example, combine the Weather API with the Geolocation API to automatically show weather for a user's current location!

API Documentation