API Overview

Sky Style exposes a versioned REST API for external developers. All endpoints are under the v1 base path.

Base URL

https://skystyle.app/api/v1

Available Endpoints

Method	Path	Description	Credits
POST	/recommend	AI outfit recommendation	2
POST	/recweather	Recommendation + full weather in one call	3
GET	/weather	Raw weather data for coordinates	1
GET	/closet	Your saved closet items	1
GET	/health	Bounded, cached connectivity checks	0

Authentication

Recommendation, weather and closet requests require an API key as a Bearer token. Public read-only health endpoints do not require a key and consume no API credits. See the Authentication guide for setup instructions.

Authorization: Bearer sk_live_YOUR_API_KEY

Response format

All responses are application/json. Error responses always include a top-level error field:

{ "error": "lat must be a number between -90 and 90, and lon between -180 and 180." }

See the full Error Reference for status codes.

The web application's Shop endpoint is POST /api/shop, outside v1. It requires a web session, not an API key, and uses the current app recommendation allowance. See Shop request and source limits.