Javiermateo

Terrace Weather API

Tells restaurants whether their terrace is viable for a given hour or service window, based on the weather forecast. Weather data by Open-Meteo.com (CC BY…

Maps & location#weather

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Tells restaurants whether their terrace is viable for a given hour or service window, based on the weather forecast. Weather data by Open-Meteo.com (CC BY 4.0). Limit: 60 requests/minute per IP.

Endpoints 5

Terrace

  • POSTVerdicts for up to 25 service windows of the same location in one call/api/v1/terrace/windowsCheck every reservation of a day at once. Counts as a single request for the rate limit and a single weather lookup. Each window is evaluated independently:…
  • GETSingle verdict and suggested terrace capacity for a service window/api/v1/terrace/window?lat=40.4168&lon=-3.7038&start=2026-09-22T13:00:00&end=2026-09-22T16:00:00Uses the worst hour of the window, e.g. lunch 13:00-16:00: one storm closes the terrace. start is inclusive and end exclusive. Times are local to the…
  • GETClimate profiles and the thresholds they apply/api/v1/terrace/profilesPresets to use as the profile parameter. Explicit thresholds override them.
  • GETHour-by-hour terrace score for the next hours (max 72)/api/v1/terrace/forecast?lat=40.4168&lon=-3.7038Starts at the current hour at the location, so the first entry is 'now'. Each hour has a 0-100 score, a verdict (OPEN, CAUTION, CLOSED) and the reasons that…
  • GETBest window of a given length on a day, plus non-overlapping alternatives/api/v1/terrace/best-window?lat=13.7563&lon=100.5018&date=2026-09-22Searches every start hour between fromHour and toHour (the restaurant's service hours) and ranks windows by their worst hour, then average, then earliest…

API details

Base URL
https://terrace.javiermateo.dev
Authentication
None declared in the description
Operations
5 operations on 5 pathsGET 4POST 1
Main resources
Terrace 5
Response formats
application/problem+json
Description format
OpenAPI 3.1.0, API version v1

How to test the Terrace Weather API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Terrace Weather API collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “Verdicts for up to 25 service windows of the same location in one call” (POST /api/v1/terrace/windows), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Terrace Weather API?

Tells restaurants whether their terrace is viable for a given hour or service window, based on the weather forecast. Weather data by Open-Meteo.com (CC BY… It is listed under Maps & location and has 5 endpoints.

Who publishes the Terrace Weather API?

It is listed from Javiermateo's public API description (an OpenAPI document), not published by Javiermateo on Swastik Codes. Anyone who controls terrace.javiermateo.dev can claim the profile by adding a DNS TXT record.

What is the base URL of the Terrace Weather API?

Requests go to https://terrace.javiermateo.dev. Endpoint paths are added to this base URL.

How do I authenticate with the Terrace Weather API?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the Terrace Weather API have?

5 operations on 5 paths (4 GET, 1 POST). The largest groups are Terrace.

Is forking the Terrace Weather API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.