API-Dokumentation
Integrieren Sie Grulas leistungsstarke Pricing-Engine in Ihre Anwendungen mit unserer umfassenden REST-API. Berechnen Sie Preise, verwalten Sie Preisrichtlinien und konfigurieren Sie dynamische Anpassungen programmatisch.
Schnellstart
Beginnen Sie mit der Grula-API in wenigen Minuten. Alles was Sie brauchen ist ein API-Token, um Anfragen zu stellen.
Authentifizierung
Alle API-Anfragen erfordern eine Authentifizierung mit einem Bearer-Token. Sie können Ihren API-Token im Grula-Dashboard generieren.
Authorization: Bearer YOUR_API_TOKENBase URL
https://api.grula.netWichtige Konzepte
Preisrichtlinien (Preislisten)
Preisrichtlinien definieren Ihre Grundpreise für Produkte oder Dienstleistungen. Denken Sie an sie wie an Ihre Preislisten, die die grundlegenden Preisregeln für Ihr Unternehmen enthalten.
Preisanpassungsrichtlinien (Rabatte & Gebühren)
Preisanpassungsrichtlinien modifizieren Ihre Grundpreise durch Anwendung von Rabatten, Gebühren oder anderen Anpassungen basierend auf spezifischen Bedingungen wie Kundentyp, Volumen oder saisonalen Faktoren.
Get PricePOST
Berechnen Sie einen einzelnen Preis basierend auf Preistreibern, Währung und optionalem Preisdatum. Dies ist der Kern-Endpoint für Echtzeit-Preisberechnungen.
Endpoint
POST /api/v1/pricecurl -X POST "https://api.grula.net/api/v1/price" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"environmentId": "123e4567-e89b-12d3-a456-426614174000",
"priceDrivers": [
{
"name": "product",
"value": "laptop"
},
{
"name": "customer_tier",
"value": "premium"
}
],
"currencyThreeLetterCode": "USD",
"pricingDate": "2024-01-15T10:00:00Z"
}'Get Multiple PricesPOST
Berechnen Sie mehrere Preise in einer einzigen Anfrage. Effizient für Bulk-Pricing-Operationen mit maximal 100 Preisanfragen pro Aufruf.
Endpoint
POST /api/v1/pricescurl -X POST "https://api.grula.net/api/v1/prices" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"environmentId": "123e4567-e89b-12d3-a456-426614174000",
"priceRequests": [
{
"priceDrivers": [
{"name": "product", "value": "laptop"},
{"name": "customer_tier", "value": "premium"}
],
"currencyThreeLetterCode": "USD",
"pricingDate": "2024-01-15T10:00:00Z"
},
{
"priceDrivers": [
{"name": "product", "value": "desktop"},
{"name": "customer_tier", "value": "standard"}
],
"currencyThreeLetterCode": "EUR",
"pricingDate": "2024-01-15T10:00:00Z"
}
]
}'Antwortbeispiele
Das Verständnis der Struktur von API-Antworten hilft Ihnen, Preisdaten effektiv in Ihre Anwendungen zu integrieren.
Price Response
{
"amount": {
"amount": 1299.99,
"currencyThreeLetterCode": "USD"
},
"priceComponents": [
{
"pricingPolicyId": "123e4567-e89b-12d3-a456-426614174000",
"amount": {
"amount": 1499.99,
"currencyThreeLetterCode": "USD"
}
},
{
"priceAdjustmentPolicyId": "456e7890-e89b-12d3-a456-426614174001",
"amount": {
"amount": -200.00,
"currencyThreeLetterCode": "USD"
},
"priceAdjustmentPolicyActionName": "Premium Customer Discount",
"priceAdjustmentPolicyValue": 0.15
}
]
}Fehlerbehandlung
Die API verwendet Standard-HTTP-Statuscodes, um den Erfolg oder Misserfolg von Anfragen anzuzeigen. Hier sind die häufigsten Statuscodes, die Sie antreffen werden.