Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: add the documents for state holidays #545

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion pages/docs/doc/basic_info.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"openapi": "3.0.5",
"info": {
"title": "Brasil API",
"description": "Acesso programático de informações é algo fundamental na comunicação entre sistemas, mas, para nossa surpresa, uma informação tão útil e pública quanto um CEP não consegue ser acessada diretamente por um navegador por conta da API dos Correios não possuir CORS habilitado.\nDado a isso, este projeto experimental tem como objetivo centralizar e disponibilizar endpoints modernos com baixíssima latência utilizando tecnologias como Vercel Smart CDN responsável por fazer o cache das informações em atualmente 23 regiões distribuídas ao longo do mundo (incluindo Brasil). Então não importa o quão devagar for a fonte dos dados, nós queremos disponibilizá-la da forma mais rápida e moderna possível.\n\nRecursos disponíveis\n - CEP\n - DDD\n - Bank\n - CNPJ\n - IBGE\n - Feriados Nacionais\n - Tabela FIPE\n - ISBN\n - Registros de domínio br\n - Taxas",
"description": "Acesso programático de informações é algo fundamental na comunicação entre sistemas, mas, para nossa surpresa, uma informação tão útil e pública quanto um CEP não consegue ser acessada diretamente por um navegador por conta da API dos Correios não possuir CORS habilitado.\nDado a isso, este projeto experimental tem como objetivo centralizar e disponibilizar endpoints modernos com baixíssima latência utilizando tecnologias como Vercel Smart CDN responsável por fazer o cache das informações em atualmente 23 regiões distribuídas ao longo do mundo (incluindo Brasil). Então não importa o quão devagar for a fonte dos dados, nós queremos disponibilizá-la da forma mais rápida e moderna possível.\n\nRecursos disponíveis\n - CEP\n - DDD\n - Bank\n - CNPJ\n - IBGE\n - Feriados Estaduais\n - Feriados Nacionais\n - Tabela FIPE\n - ISBN\n - Registros de domínio br\n - Taxas",
"termsOfService": "/#termos-de-uso",
"version": "1.0.0",
"contact": {
Expand Down
110 changes: 110 additions & 0 deletions pages/docs/doc/statewideHolydays.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,110 @@
{
"tags": [
{
"name": "Feriados Estaduais",
"description": "Informações sobre feriados estaduais"
}
],
"paths": {
"/feriados/v1/{ano}/{uf}": {
"get": {
"tags": ["Feriados Estaduais"],
"summary": "Lista os feriados estaduais de determinado ano e estado.",
"description": "Calcula os feriados móveis com base no próprio e adiciona os feriados fixos",
"parameters": [
{
"name": "ano",
"description": "Ano para calcular os feriados.\n",
"in": "path",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "uf",
"description": "uf para filtrar os feriados do estado.\n",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/statewideHolidays"
}
}
}
}
},
"404": {
"description": "Ano fora do intervalo suportado.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorMessage"
},
"example": {
"type": "feriados_range_error",
"message": "Ano fora do intervalo suportado entre 1900 e 2199."
}
}
}
},
"400": {
"description": "Uf inexistente.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorMessage"
},
"example": {
"type": "state_does_not_exist_error",
"message": "Uf inexistente."
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"statewideHolidays": {
"title": "statewideHolidays",
"type": "object",
"required": ["date", "type", "name"],
"properties": {
"date": {
"type": "string"
},
"type": {
"type": "string"
},
"name": {
"type": "string",
"format": "int32"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

int32 não deveria ser usado só para tipos numéricos?

},
"fullName": {
"type": "string"
}
},
"example": {
"date": "2023-11-20",
"name": "Dia da consciência Negra",
"type": "state"
}
}
}
}
}
Loading