Astroclaw Forecasts API

openapi: 3.2.0
info:
  title: Astroclaw Xyz Forecasts API
  version: 2.0.0
  description: 'Operations tagged Forecasts across 2 of this provider''s published API definitions: astroclaw-xyz-openapi.yaml, astroclaw-xyz.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.astroclaw.xyz
tags:
- name: Forecasts
paths:
  /api/forecasts/today/{sign}.json:
    get:
      operationId: getTodayForecast
      summary: Get today's horoscope for one sign
      description: Returns the latest published forecast for the sign. Call findSign first if you do not know your sign.
      parameters:
      - $ref: '#/components/parameters/Sign'
      responses:
        '200':
          description: The latest forecast for the sign.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TodayForecast'
        '404':
          description: Unknown sign.
      tags:
      - Forecasts
    servers:
    - url: https://www.astroclaw.xyz
  /api/forecasts/today.json:
    get:
      operationId: getTodayForecasts
      summary: Get today's horoscopes for all twelve signs
      responses:
        '200':
          description: Every forecast for the latest published day.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TodayForecasts'
      tags:
      - Forecasts
    servers:
    - url: https://www.astroclaw.xyz
  /api/forecasts/{date}/{sign}.json:
    get:
      operationId: getForecast
      summary: Get the horoscope for one sign on a past day
      parameters:
      - $ref: '#/components/parameters/Date'
      - $ref: '#/components/parameters/Sign'
      responses:
        '200':
          description: The forecast.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Forecast'
        '404':
          description: No forecast for that sign and day.
      tags:
      - Forecasts
    servers:
    - url: https://www.astroclaw.xyz
  /api/forecasts/{date}.json:
    get:
      operationId: getForecastDay
      summary: Get every sign's horoscope for one day
      parameters:
      - $ref: '#/components/parameters/Date'
      responses:
        '200':
          description: All forecasts for the day.
          content:
            application/json:
              schema:
                type: object
                required:
                - date
                - count
                - forecasts
                properties:
                  date:
                    type: string
                    format: date
                  count:
                    type: integer
                  forecasts:
                    type: array
                    items:
                      $ref: '#/components/schemas/Forecast'
        '404':
          description: No forecasts for that day.
      tags:
      - Forecasts
    servers:
    - url: https://www.astroclaw.xyz
  /api/forecasts/index.json:
    get:
      operationId: listForecastDates
      summary: List the days that have forecasts
      responses:
        '200':
          description: Available days, newest first.
          content:
            application/json:
              schema:
                type: object
                properties:
                  latest:
                    type: string
                    format: date
                  dates:
                    type: array
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                          format: date
                        url:
                          type: string
                          format: uri
      tags:
      - Forecasts
    servers:
    - url: https://www.astroclaw.xyz
components:
  schemas:
    Forecast:
      type: object
      required:
      - sign
      - date
      - horoscope
      - url
      - json_url
      - text_url
      properties:
        sign:
          $ref: '#/components/schemas/SignName'
        date:
          type: string
          format: date
        horoscope:
          type: string
        forecast:
          type: string
          deprecated: true
          description: Same as horoscope; kept for older clients.
        url:
          type: string
          format: uri
          description: Human-readable page.
        json_url:
          type: string
          format: uri
        text_url:
          type: string
          format: uri
    TodayForecasts:
      type: object
      required:
      - date
      - forecasts
      properties:
        date:
          type: string
          format: date
        next_update_expected_at:
          type: string
          format: date-time
        count:
          type: integer
        forecasts:
          type: array
          items:
            $ref: '#/components/schemas/Forecast'
        links:
          type: object
          additionalProperties:
            type: string
    TodayForecast:
      allOf:
      - $ref: '#/components/schemas/Forecast'
      - type: object
        properties:
          next_update_expected_at:
            type: string
            format: date-time
    SignName:
      type: string
      enum:
      - aries
      - taurus
      - gemini
      - cancer
      - leo
      - virgo
      - libra
      - scorpio
      - sagittarius
      - capricorn
      - aquarius
      - pisces
  parameters:
    Sign:
      name: sign
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/SignName'
    Date:
      name: date
      in: path
      required: true
      schema:
        type: string
        format: date
  securitySchemes:
    managementToken:
      type: http
      scheme: bearer
      description: The management_token returned when the subscription was created.
externalDocs:
  description: Agent guide
  url: https://www.astroclaw.xyz/llms.txt
x-refined-from:
- astroclaw-xyz-openapi.yaml
- astroclaw-xyz.yaml