Authentication

🔐 API Key Required

To use the Juleb ERP API, you must have a valid API key. Currently, API keys are provided exclusively through our customer success or sales team.

Getting Your API Key

🏢 Existing Customers

Contact your dedicated customer success manager or reach out to our support team.

support@juleb.com

🆕 New to Juleb?

Speak with our sales team to learn about Juleb ERP and get started with API access.

sales@juleb.com

Authentication Method: OAuth 2.0

The Juleb ERP API uses OAuth 2.0 for secure authentication. This industry-standard protocol ensures your data remains protected while providing seamless access to your ERP system.

How It Works

🔄 Authentication Flow

1. Request API Key - Contact our team
2. Receive API Key - Secure token provided
3. Make API Calls - Include in headers

Adding Authentication to Your Requests

Include your API key in the Authorization header of every request:

📝 Header Format

Authorization: Bearer {YOUR_API_KEY}

💡 Replace the Placeholder

Always replace {YOUR_API_KEY} with your actual API key. Never commit API keys to version control!

🔧 Code Examples

JavaScript

Setting up authentication headers

const apiKey = process.env.JULEB_API_KEY; // Store securely in environment variables
const accountName = process.env.JULEB_ACCOUNT_NAME;

const headers = {
  "Content-Type": "application/json",
  Authorization: `Bearer ${apiKey}`,
};

// Example API call
const response = await fetch(
  `https://${accountName}.juleb.com/api/v1/inventory/product`,
  {
    method: "GET",
    headers: headers,
  }
);

const data = await response.json();
console.log(data);

Python

Python authentication setup

import os
import requests

# Load from environment variables
api_key = os.getenv('JULEB_API_KEY')
account_name = os.getenv('JULEB_ACCOUNT_NAME')

headers = {
    'Content-Type': 'application/json',
    'Authorization': f'Bearer {api_key}'
}

# Example API call
response = requests.get(
    f'https://{account_name}.juleb.com/api/v1/inventory/product',
    headers=headers
)

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

cURL

cURL authentication example

# Set environment variables first
export JULEB_API_KEY="your-api-key-here"
export JULEB_ACCOUNT_NAME="your-account-name"

# Make authenticated request
curl -X GET \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $JULEB_API_KEY" \
  "https://$JULEB_ACCOUNT_NAME.juleb.com/api/v1/inventory/product"

API Base URL and Versioning

URL Structure

https://{ACCOUNT_NAME}.juleb.com/api/v1/{endpoint}

🏷️ URL Components Explained

• {ACCOUNT_NAME}: Your unique Juleb account identifier (subdomain)
• api: API namespace
• v1: API version (ensures backward compatibility)
• {endpoint}: Specific API endpoint (e.g., inventory/product)

Examples by Account

Demo Account

https://demo.juleb.com/api/v1/inventory/product
https://demo.juleb.com/api/v1/pos/order
https://demo.juleb.com/api/v1/resources/partner

Your Account

https://yourpharmacy.juleb.com/api/v1/inventory/product
https://yourpharmacy.juleb.com/api/v1/pos/order
https://yourpharmacy.juleb.com/api/v1/resources/partner

Security Best Practices

Security Best Practices

✅ Do

• Store API keys in environment variables
• Use server-side applications for API calls
• Rotate API keys regularly
• Monitor API usage and logs
• Use HTTPS for all requests

❌ Don't

• Hardcode API keys in your source code
• Expose API keys in client-side JavaScript
• Share API keys via email or chat
• Use API keys in URLs or query parameters
• Commit API keys to version control

Testing Your Authentication

Try the Interactive API Explorer

Before building your integration, test your API key with our interactive documentation:

🧪 API Explorer

Interactive documentation where you can test endpoints directly in your browser

👉 Open API Explorer (opens in new tab)

Quick Authentication Test

Simple Test

Test your API key

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://YOUR_ACCOUNT.juleb.com/api/v1/inventory/product?limit=1"

Expected Response:

{
  "data": [...],
  "meta": { "count": 1, "total": 150 },
  "pagination": { ... }
}

Detailed Test

🔧 Setup Required

Before running this code, make sure to:

1. Replace YOUR_API_KEY_HERE and YOUR_ACCOUNT_NAME_HERE with your actual values, OR
2. Set environment variables: JULEB_API_KEY and JULEB_ACCOUNT_NAME

Complete authentication test

async function testAuthentication() {
  // Replace these with your actual values or set them as environment variables
  const apiKey = process.env.JULEB_API_KEY || "YOUR_API_KEY_HERE";
  const accountName =
    process.env.JULEB_ACCOUNT_NAME || "YOUR_ACCOUNT_NAME_HERE";

  // Check if API key and account name are properly set
  if (
    apiKey === "YOUR_API_KEY_HERE" ||
    accountName === "YOUR_ACCOUNT_NAME_HERE"
  ) {
    console.log(
      "❌ Please replace YOUR_API_KEY_HERE and YOUR_ACCOUNT_NAME_HERE with your actual values"
    );
    return;
  }

  try {
    const response = await fetch(
      `https://${accountName}.juleb.com/api/v1/inventory/product?limit=1`,
      {
        headers: {
          Authorization: `Bearer ${apiKey}`,
          "Content-Type": "application/json",
        },
      }
    );

    if (response.ok) {
      const data = await response.json();
      console.log("✅ Authentication successful!");
      console.log("Sample data:", data);
    } else {
      console.log("❌ Authentication failed:", response.status);
      const errorText = await response.text();
      console.log("Error details:", errorText);
    }
  } catch (error) {
    console.log("❌ Network error:", error.message);
  }
}

testAuthentication();

Browser Console Test

For quick testing in your browser's developer console:

Direct browser test (replace values first!)

// Replace these with your actual values
const API_KEY = "your-actual-api-key";
const ACCOUNT_NAME = "your-actual-account-name";

fetch(`https://${ACCOUNT_NAME}.juleb.com/api/v1/inventory/product?limit=1`, {
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
})
  .then((response) => response.json())
  .then((data) => console.log("✅ Success:", data))
  .catch((error) => console.log("❌ Error:", error));

Common Authentication Errors

Status Code	Error	Solution
401	Unauthorized	Check your API key and ensure it's included in the Authorization header
403	Forbidden	Your API key may not have permission for this endpoint or account
404	Not Found	Verify your account name in the URL is correct
429	Rate Limited	Slow down your requests or contact support for higher limits

🎯 Next Steps

Now that you're authenticated, learn how to explore API queries to get the most out of your API calls!