Quickstart
Sandbox Environment
Test the EUlabel API with pre-populated sample data in the sandbox.
The sandbox environment lets you experiment with the API without affecting production data.
Sandbox endpoint
https://sandbox.api.eulabel.eu/v1Use sandbox API keys (prefixed with sk_test_) to authenticate.
Pre-populated test data
The sandbox includes sample products ready to use:
| Product | GTIN | Category |
|---|---|---|
| Mateus Rosé | 5601012011050 | wine |
| Sandeman Porto Tawny | 5601012012200 | wine |
| Gazela Vinho Verde | 5601012013900 | wine |
Sandbox vs Production
| Feature | Sandbox | Production |
|---|---|---|
| API key prefix | sk_test_ | sk_live_ |
| Data persistence | Reset periodically | Permanent |
| Rate limits | Relaxed | Standard |
| QR codes | Not scannable | Live resolution |
| Webhooks | Test deliveries | Real deliveries |
Getting a sandbox API key
- Log in to the EUlabel Dashboard
- Navigate to Settings > API Keys
- Click Create Key and select the Sandbox environment
- Copy the key -- it is only shown once
Testing with the sandbox
export API_KEY="sk_test_YOUR_SANDBOX_KEY"
# List pre-populated products
curl https://sandbox.api.eulabel.eu/v1/products \
-H "Authorization: Bearer $API_KEY"
# Create a test product
curl -X POST https://sandbox.api.eulabel.eu/v1/products \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Test Wine","category":"wine","brand":"TestBrand","gtin":"4006381333931"}'