Authentication

You'll need to authenticate your requests to access any of the endpoints in the Adlocaite API. Authentication is handled exclusively through Bearer tokens provided by our onboarding team during the integration process.

Bearer token authentication

The Adlocaite API uses Bearer token authentication for all requests. Your API key will be provided by our onboarding team along with your integration documentation. Here's how to authenticate using cURL:

curl https://api.adlocaite.com/functions/v1/api/offers/request/[screenId]?min_bid_cents=200 \
  -H "Authorization: Bearer YOUR_API_KEY"

Getting your API key

API keys are distributed exclusively through our onboarding process to ensure quality and security:

1. Contact our onboarding team to begin the integration process
2. Complete the technical evaluation to ensure compatibility
3. Receive your API key along with detailed integration documentation
4. Test in our sandbox environment before going live

Security best practices

• Keep your API key secure and never expose it in client-side code
• Use HTTPS for all API requests
• Store your key safely using environment variables or secure key management
• Contact us immediately if you suspect your key has been compromised

# Store in environment variable
export ADLOCAITE_API_KEY="your_api_key_here"

# Use in requests
curl https://api.adlocaite.com/functions/v1/api/offers/request/[screenId]?min_bid_cents=200 \
  -H "Authorization: Bearer $ADLOCAITE_API_KEY"

API key permissions

Your API key provides access to:

• Offer retrieval for your assigned screens
• Offer responses (accept/decline)
• Asset caching information for optimization

Rate limiting

The Adlocaite API uses intelligent, adaptive rate limiting that automatically adjusts based on your integration's performance:

Dynamic rate adjustment

• Screen-based scaling: Rate limits increase proportionally with the number of screens in your network
• Performance-based optimization: Successful ad displays improve your rate limits
• Fair usage protection: We never penalize partners for unsuccessful displays that are beyond their control

Partner-friendly approach

Our rate limiting system is designed to support, not hinder, your business:

• No punishment for external factors: Network issues, advertiser problems, or platform issues don't affect your limits
• Automatic scaling: As your network grows, your API limits grow with you
• Success rewards: High-performing integrations receive higher rate limits automatically