Getting Started

Getting Started

Welcome to the Pillexa API! This guide will help you get up and running with our pharmacy e-commerce platform integration.

Prerequisites

Before you begin, you'll need:

  • API Access: Contact our team (dev@pillexa.com) to obtain API credentials
  • Development Environment: Any programming language that supports HTTP requests
  • HTTPS Support: All production requests must use HTTPS

Step 1: Obtain API Access

To get started with the Pillexa API:

  1. Contact our Developer Team: Reach out to get your API credentials
  2. Choose Your Plan: Select the appropriate access level for your needs
  3. Receive Credentials: You'll get your API key and base URL

Step 2: Set Up Your Environment

Base URL

All API requests should be made to:

https://api.pillexa.com

Authentication

Include your API key in the request headers:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.pillexa.com/endpoint

Step 3: Make Your First Request

Here's a simple example to test your connection:

# Test API connection with authentication
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.pillexa.com/brand/cart/list-available-products

Example Response

{
  "products": [
    {
      "id": "prod_123",
      "name": "Sample Product",
      "price": 29.99,
      "available": true
    }
  ],
  "total": 1
}

Step 4: Explore the API

Now that you're connected, explore our comprehensive pharmacy e-commerce API:

  • Brand Endpoints - E-commerce storefront, cart management, health questionnaires, ID Verification, and customer operations
  • Clinician Endpoints - Medical professional tools, prescription management, and telehealth workflows
  • Pharmacy Endpoints - Backend pharmacy operations, order fulfillment, inventory, and shipping
  • Shared Endpoints - Common utilities, webhooks, permissions, and cross-service functionality

Development Best Practices

  1. Use HTTPS: Always use secure connections in production
  2. Store Keys Securely: Never hardcode API keys in your source code
  3. Handle Errors: Implement proper error handling for API responses
  4. Rate Limiting: Respect our rate limits to ensure optimal performance
  5. Testing: Use our sandbox environment for development and testing

Need Help?