{
  "components": {
    "schemas": {
      "Erro": {
        "properties": {
          "erro": {
            "type": "string"
          },
          "mensagem": {
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "securitySchemes": {
      "chave": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "Resultados da Mega-Sena, Quina, Lotofácil, Lotomania, Timemania, Dupla Sena, Dia de Sorte, Super Sete, +Milionária e Federal. Autenticação por chave Bearer, gerada no console (APIs).",
    "title": "API de Loterias",
    "version": "1.0.0"
  },
  "openapi": "3.0.3",
  "paths": {
    "/v1/loterias": {
      "get": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "loterias": [
                    {
                      "slug": "megasena",
                      "nome": "Mega-Sena"
                    },
                    {
                      "slug": "quina",
                      "nome": "Quina"
                    },
                    {
                      "slug": "lotofacil",
                      "nome": "Lotofácil"
                    }
                  ]
                },
                "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": "Lista das loterias"
      }
    },
    "/v1/loterias/sessao": {
      "get": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "nome": "Meu site",
                  "plano": "Loterias 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/loterias/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"
      }
    },
    "/v1/loterias/{loteria}": {
      "get": {
        "parameters": [
          {
            "description": "megasena, quina, lotofacil, lotomania, timemania, duplasena, diadesorte, supersete, maismilionaria ou federal.",
            "in": "path",
            "name": "loteria",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Número do concurso; sem ele, o mais recente.",
            "in": "query",
            "name": "concurso",
            "required": false,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "loteria": "megasena",
                  "concurso": 3087,
                  "data": "17/11/2026",
                  "local": "ESPAÇO DA SORTE em SÃO PAULO, SP",
                  "dezenas": [
                    "06",
                    "10",
                    "23",
                    "35",
                    "41",
                    "52"
                  ],
                  "dezenasOrdemSorteio": [
                    "23",
                    "06",
                    "52",
                    "10",
                    "41",
                    "35"
                  ],
                  "trevos": [],
                  "timeCoracao": null,
                  "mesSorte": null,
                  "premiacoes": [
                    {
                      "descricao": "6 acertos",
                      "faixa": 1,
                      "ganhadores": 0,
                      "valorPremio": 0
                    },
                    {
                      "descricao": "5 acertos",
                      "faixa": 2,
                      "ganhadores": 41,
                      "valorPremio": 52310.77
                    },
                    {
                      "descricao": "4 acertos",
                      "faixa": 3,
                      "ganhadores": 3012,
                      "valorPremio": 1021.43
                    }
                  ],
                  "acumulou": true,
                  "proximoConcurso": 3088,
                  "dataProximoConcurso": "19/11/2026",
                  "valorArrecadado": 42979824,
                  "valorAcumuladoProximoConcurso": 32125746.68,
                  "valorEstimadoProximoConcurso": 40000000,
                  "atualizado_em": "2026-11-19T21:32:20Z",
                  "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": "Resultado de uma loteria"
      }
    }
  },
  "security": [
    {
      "chave": []
    }
  ],
  "servers": [
    {
      "url": "https://dev-api.primux.cloud"
    }
  ]
}