01
Request credentials
Get an API key from the TripGuru team and confirm which environment you should target first.
Treat the key as a server-side secret and avoid exposing it in client code.
Quickstart
QuickstartMake the first requestbefore designing the whole platform
The shortest integration path is still the most reliable one: authenticate, read products, then extend toward cart, order, and payment flows.
10-minute setup pathREST-firstProduction-oriented
Baseline
Base URL: https://api.tripguru.ai/v1
Auth: Bearer token in request headers.
Sequence: Products → Cart → Orders → Payments.
Setup Path
02
Establish the base request shape
Every request starts with the same base URL and authentication headers.
Use this step to centralize retries, error formatting, and request tracing.
03
Fetch products first
The lowest-friction path is catalog retrieval before attempting cart or order workflows.
Validate the product payload shape your frontend or internal tools expect.
04
Expand into booking flow
Once product retrieval is stable, add cart, order, and payment calls in sequence.
This keeps operational debugging straightforward when the first integration goes live.
headers.http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Keep secrets on the server. The API key should stay in backend services, server routes, or private infrastructure.
Log request identifiers. It shortens support loops when you move from sandbox to production.
Expand in order. Product lookup should be stable before you troubleshoot carts, orders, or payment state.
Examples
Start with one language, keep the request shape identical.
All examples below make the same first product request. Pick the one closest to your runtime and move on to real payload validation.
JavaScript
products.js
const response = await fetch('https://api.tripguru.ai/v1/products', {
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
})
const { products } = await response.json()
console.log(products)
Python
products.py
import requests
response = requests.get(
'https://api.tripguru.ai/v1/products',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
)
print(response.json())
cURL
products.sh
curl -X GET "https://api.tripguru.ai/v1/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
Continue