Start here

Get started

Make a keyless sandbox call, read the response, then connect your server to production when you are ready.

1. Run a quickstart in your preferred language.
2. Choose a product guide for your integration.
3. Get your production key from the dashboard and follow the authentication guide.

Sandbox returns fixed demonstration data with zero charge. It is separate from a production wallet: there is no free tier, trial or credit grant.

Authentication

Send your production API key in the x-api-key header. Keep it on your server and read it from an environment variable. Never put a production key in browser code, a shared URL or a committed file.

Use the reference below to check the authentication requirement for each operation. Sandbox access is explicit and may be unavailable for some operations.

Read the authentication guide →

Quickstarts

These three examples request the same fixed daily-horoscope sandbox response. Read the result from data; production inputs and responses are documented per operation below.

curl --fail-with-body --silent --show-error \
  "https://api.vedika.io/sandbox/horoscope/daily?sign=aries&lang=en"

// Node.js 18 or later. No API key needed for this fixed sandbox sample.
const response = await fetch(
  "https://api.vedika.io/sandbox/horoscope/daily?sign=aries&lang=en"
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const result = await response.json();
if (!result.success || !result.data) throw new Error("Sandbox returned no data");
if (typeof result.data.prediction !== "string" || !result.data.prediction.trim()) throw new Error("Sandbox returned no prediction");
console.log(result.data.prediction);
console.log(result.data.luckyNumber, result.data.luckyColor);

# Python 3. No additional packages or API key needed.
import json
from urllib.request import urlopen

url = "https://api.vedika.io/sandbox/horoscope/daily?sign=aries&lang=en"
with urlopen(url, timeout=30) as response:
    result = json.load(response)
if not result.get("success") or not result.get("data"):
    raise RuntimeError("Sandbox returned no data")
prediction = result["data"].get("prediction")
if not isinstance(prediction, str) or not prediction.strip():
    raise RuntimeError("Sandbox returned no prediction")
print(prediction)
print(result["data"]["luckyNumber"], result["data"]["luckyColor"])

Product guides

Follow the existing guides for your product. The reference remains available below for exact endpoint inputs and recorded responses.

Browse all guides →

Errors & limits

Check the HTTP status and error response before reading data. Correct invalid input before retrying; check your key and access for authentication errors. On a rate-limit response, honour Retry-After when provided and back off.

Use the operation contract for required fields and your current plan for its limits. Keep paid retries tied to the documented idempotency contract for that operation.

Error handling guide → · Rate limits →

SDK pages

Use the published SDK documentation for installation, supported methods and examples.

Changelog

Check published changes before upgrading your integration.

Read the changelog →