Integration Guides

Integration Guides

Integrate Source Parts into your existing workflows and systems with our comprehensive APIs and tools. This guide covers everything from simple API calls to complex ERP integrations.

Integration Options

🔗 REST API

• Base URL: https://api.source.parts/v1/
• Authentication: API key-based authentication
• Format: JSON requests and responses
• Rate Limits: Tiered limits based on subscription level
• Documentation: Complete API reference

📊 GraphQL API

• Endpoint: https://api.source.parts/graphql
• Schema: Self-documenting schema with introspection
• Playground: Interactive query builder available
• Real-time: Subscription support for live data

🔄 Webhooks

• Real-time Updates: Instant notifications for events
• Reliable Delivery: Retry logic and failure handling
• Event Types: Order status, inventory changes, pricing updates
• Security: HMAC signature verification

📁 File-Based Integration

• CSV Upload/Download: Bulk operations via CSV files
• Excel Integration: Direct Excel add-in for component lookup
• EDI Support: Electronic Data Interchange for enterprise customers
• FTP/SFTP: Secure file transfer for automated processing

Common Integration Patterns

🔍 Component Search Integration

Integrate component search into your design tools or procurement systems:

Basic Search Example

curl -X GET "https://api.source.parts/v1/components/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -G -d "q=STM32F407" \
  -d "limit=10" \
  -d "availability=in_stock"

Advanced Search with Filters

{
  "query": "ARM Cortex M4",
  "filters": {
    "manufacturer": ["STMicroelectronics", "NXP"],
    "package": ["LQFP-100", "BGA-144"],
    "price_range": {"min": 5.00, "max": 50.00},
    "stock_level": {"min": 100}
  },
  "sort": "price_asc",
  "limit": 25
}

💰 Real-time Pricing Integration

Get up-to-date pricing for your BOMs and quotes:

Bulk Pricing Request

POST /v1/pricing/bulk
{
  "items": [
    {"part_number": "STM32F407VGT6", "quantity": 100},
    {"part_number": "LM358N", "quantity": 1000},
    {"part_number": "1N4148", "quantity": 5000}
  ],
  "currency": "USD",
  "include_breaks": true
}

Platform-Specific Integrations

🏢 ERP System Integration

SAP Integration

• SAP Ariba: Certified supplier integration
• SAP MM: Materials Management module integration
• Custom IDocs: Standard SAP interface documents
• Real-time Catalogs: Live pricing and availability in SAP

Oracle Integration

• Oracle iProcurement: Direct catalog integration
• Oracle Cloud SCM: Supply chain management integration
• Custom APIs: REST API connections to Oracle systems
• Data Synchronization: Automated inventory updates

🛠️ Design Tool Integration

Altium Designer

• Supply Chain Panel: Real-time component data in schematic
• BOM Export: Direct BOM upload to Source Parts
• Part Selection: Guided component selection with availability
• Pricing Integration: Cost analysis during design

KiCad Integration

• Plugin Development: Python-based plugin for KiCad
• Symbol Libraries: Pre-built component symbols
• Footprint Libraries: Accurate PCB footprints
• BOM Generation: Automated BOM creation and pricing

Authentication and Security

🔐 API Authentication

API Key Authentication

GET /v1/components/search?q=STM32
Authorization: Bearer your_api_key_here
Content-Type: application/json

🛡️ Security Best Practices

• API Key Management: Rotate keys regularly and use environment variables
• Rate Limiting: Implement client-side rate limiting to avoid throttling
• HTTPS Only: All API calls must use HTTPS
• Webhook Verification: Verify webhook signatures for security
• IP Whitelisting: Available for enterprise accounts

Code Examples by Language

🐍 Python Integration

import requests
import json

class SourcePartsAPI:
    def __init__(self, api_key):
        self.api_key = api_key
        self.base_url = "https://api.source.parts/v1"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }
    
    def search_components(self, query, limit=10):
        url = f"{self.base_url}/components/search"
        params = {"q": query, "limit": limit}
        response = requests.get(url, headers=self.headers, params=params)
        return response.json()
    
    def get_pricing(self, part_number, quantity):
        url = f"{self.base_url}/pricing"
        data = {"part_number": part_number, "quantity": quantity}
        response = requests.post(url, headers=self.headers, json=data)
        return response.json()

# Usage
api = SourcePartsAPI("your_api_key")
components = api.search_components("STM32F407")
pricing = api.get_pricing("STM32F407VGT6", 100)