{
  "components": {
    "schemas": {
      "Erro": {
        "properties": {
          "erro": {
            "type": "string"
          },
          "mensagem": {
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "securitySchemes": {
      "chave": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "Tempo atual e previsão de 7 dias para a cidade escolhida em cada consulta. Os dados são renovados no máximo a cada 30 minutos por cidade. Autenticação por chave Bearer, gerada no console (APIs).",
    "title": "API de Previsão do Tempo",
    "version": "1.0.0"
  },
  "openapi": "3.0.3",
  "paths": {
    "/v1/clima": {
      "get": {
        "parameters": [
          {
            "description": "Nome da cidade (2 a 80 caracteres). Obrigatório sem latitude e longitude.",
            "in": "query",
            "name": "cidade",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Sigla do estado (ex.: PR) para desambiguar cidades de mesmo nome.",
            "in": "query",
            "name": "uf",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "País com 2 letras (padrão BR).",
            "in": "query",
            "name": "pais",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Latitude (-90 a 90), no lugar da cidade.",
            "in": "query",
            "name": "latitude",
            "required": false,
            "schema": {
              "type": "number"
            }
          },
          {
            "description": "Longitude (-180 a 180), junto com a latitude.",
            "in": "query",
            "name": "longitude",
            "required": false,
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "local": {
                    "nome": "Londrina",
                    "estado": "Paraná",
                    "pais": "BR",
                    "latitude": -23.31028,
                    "longitude": -51.16278,
                    "fuso": "America/Sao_Paulo"
                  },
                  "atual": {
                    "temperatura_c": 30.1,
                    "sensacao_c": 33.2,
                    "umidade_pct": 55,
                    "chuva_mm": 0,
                    "vento_kmh": 4.6,
                    "vento_direcao_graus": 201,
                    "codigo": 3,
                    "descricao": "Nublado",
                    "dia": true,
                    "observado_em": "2026-11-19T18:30"
                  },
                  "previsao": [
                    {
                      "data": "2026-11-19",
                      "minima_c": 20.4,
                      "maxima_c": 31.2,
                      "chance_chuva_pct": 27,
                      "chuva_mm": 1.6,
                      "indice_uv": 9.1,
                      "nascer_do_sol": "2026-11-19T05:32",
                      "por_do_sol": "2026-11-19T18:41",
                      "codigo": 95,
                      "descricao": "Trovoada"
                    }
                  ],
                  "atualizado_em": "2026-11-19T21:32:19Z",
                  "desatualizado": false
                },
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Sucesso"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          }
        },
        "summary": "Previsão do tempo de uma cidade"
      }
    },
    "/v1/clima/sessao": {
      "get": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "nome": "Meu site",
                  "plano": "Clima 5.000",
                  "estado": "criada",
                  "valido_ate": "2026-12-19T14:30:00Z",
                  "limite_diario": 5000,
                  "limite_por_minuto": 60
                },
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Sucesso"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          }
        },
        "summary": "Dados da sessão e do plano"
      }
    },
    "/v1/clima/uso": {
      "get": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": "2026-11-19",
                  "consultas_hoje": 128,
                  "consultas_no_mes": 2410,
                  "limite_diario": 5000,
                  "restante_hoje": 4872
                },
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Sucesso"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          }
        },
        "summary": "Consultas feitas hoje e no mês"
      }
    }
  },
  "security": [
    {
      "chave": []
    }
  ],
  "servers": [
    {
      "url": "https://dev-api.primux.cloud"
    }
  ]
}