Saturn Planet - Ruby
Planetary positions request example, documented inputs, server-side authentication and integration checks.
Locate Saturn in a planetary-position result
This operation calculates the documented position data for the supplied timestamp and location. Inspect the returned collection for Saturn, using the field names in the response reference. A topic name in this page’s URL is an application display choice, rather than an additional request parameter.
Planetary positions: request contract
Supply the calculation timestamp and location. Keep the returned coordinates and any display conventions separate from narrative interpretations added by your application.
POST /v2/astrology/planetary-positions · OpenAPI request and response schema
The values below are synthetic examples. They describe request wiring, rather than a measured result or an accuracy claim. Production requests use your account’s published billing terms; the sandbox provides fixed mock examples for development.
| Field | Location | Type | Schema requirement |
|---|---|---|---|
datetime | body | string | Optional in the request schema; provide it when your calculation needs it |
latitude | body | number | Optional in the request schema; provide it when your calculation needs it |
longitude | body | number | Optional in the request schema; provide it when your calculation needs it |
timezone | body | string | Optional in the request schema; provide it when your calculation needs it |
Make the request safely
Set VEDIKA_API_KEY in the trusted server or command-line environment. Keep that key out of browser bundles, mobile builds, URLs and shared logs. The example runs in a trusted process; a mobile or browser application can call your own backend to keep the production credential private.
Ruby standard-library request
require 'net/http'
require 'uri'
uri = URI("https://api.vedika.io/v2/astrology/planetary-positions")
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer ' + ENV.fetch('VEDIKA_API_KEY')
request['Content-Type'] = 'application/json'
request.body = "{\"datetime\":\"1990-05-15T10:30:00\",\"latitude\":19.07,\"longitude\":72.87,\"timezone\":\"+05:30\"}"
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true, open_timeout: 20, read_timeout: 20) do |http|
http.request(request)
end
raise "HTTP #{response.code}" unless response.is_a?(Net::HTTPSuccess)
puts response.bodyCheck the result before displaying it
- Validate the selected date, location and relevant calculation settings before making a production request.
- Check HTTP status and the operation-specific JSON schema. Keep errors and timeouts visible instead of displaying a previous or invented result.
- Retain only the inputs and result fields your feature needs. Use synthetic cases in public bug reports and avoid copying private birth details into logs.
- When caching, include every input that affects this operation and keep private results scoped to the appropriate user.
Continue with the quickstart, supported SDKs, current billing units and published technical evidence. Create production access through API-key signup.
Try the FREE Sandbox
978 mock operations for development. Production plans from $12/month.
Explore Sandbox →