Shaka Naruto RPG Akatsuki

Shaka Naruto RPG Akatsuki · GPT-Aktionen

Regras Akatsuki

API publica e somente de leitura para pesquisar, ler e relacionar as regras oficiais do Naruto RPG Akatsuki. Antes de responder, pesquise; leia integralmente cada resultado relevante; siga referencias internas e links oficiais.

  • GET /buscar.phpBuscar regras oficiais

    Pesquise nomes, mecanismos, sinonimos e assuntos em todas as categorias. Use antes de responder e passe os IDs relevantes para lerRegra.

  • GET /regra.phpLer uma regra oficial integralmente

    Le uma regra sem resumo pelo ID retornado na busca. Se tem_mais for verdadeiro, repita com proximo_offset antes de responder.

  • GET /referencias.phpLocalizar dependencias e links de uma regra

    Resolve referencias internas para outras regras e lista links oficiais. Use depois de ler uma regra relevante.

  • GET /categorias.phpListar categorias da base

    Lista categorias oficiais e quantidades para orientar buscas e navegacao.

  • GET /secoes.phpListar secoes organizadas de uma categoria

    Navega pelas secoes de uma categoria e pode filtrar pela rota interna.

  • GET /status.phpVerificar integridade da base oficial

    Confirma se o indice esta online, integro e atualizado.

Ursprüngliches API-Schema
{
  "openapi": "3.1.0",
  "info": {
    "title": "Regras Akatsuki",
    "description": "API publica e somente de leitura para pesquisar, ler e relacionar as regras oficiais do Naruto RPG Akatsuki. Antes de responder, pesquise; leia integralmente cada resultado relevante; siga referencias internas e links oficiais.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://narutorpgakatsuki.com/pagina/conversor/action"
    }
  ],
  "paths": {
    "/buscar.php": {
      "get": {
        "operationId": "buscarRegras",
        "summary": "Buscar regras oficiais",
        "description": "Pesquise nomes, mecanismos, sinonimos e assuntos em todas as categorias. Use antes de responder e passe os IDs relevantes para lerRegra.",
        "x-openai-isConsequential": false,
        "parameters": [
          {
            "name": "consulta",
            "in": "query",
            "required": true,
            "description": "Nome, mecanismo, termo, sinonimo ou assunto procurado.",
            "schema": {
              "type": "string",
              "maxLength": 300
            }
          },
          {
            "name": "categoria",
            "in": "query",
            "required": false,
            "description": "Nome exato ou aproximado de uma categoria retornada por listarCategorias.",
            "schema": {
              "type": "string",
              "maxLength": 120
            }
          },
          {
            "name": "limite",
            "in": "query",
            "required": false,
            "description": "Quantidade maxima de resultados.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 15,
              "default": 8
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Resultados ordenados por relevancia.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RespostaBusca"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErroDeConsulta"
          },
          "500": {
            "$ref": "#/components/responses/ErroInterno"
          }
        }
      }
    },
    "/regra.php": {
      "get": {
        "operationId": "lerRegra",
        "summary": "Ler uma regra oficial integralmente",
        "description": "Le uma regra sem resumo pelo ID retornado na busca. Se tem_mais for verdadeiro, repita com proximo_offset antes de responder.",
        "x-openai-isConsequential": false,
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": true,
            "description": "ID global retornado por buscarRegras ou listarSecoes.",
            "schema": {
              "type": "string",
              "maxLength": 300
            }
          },
          {
            "name": "formato",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "markdown",
                "txt"
              ],
              "default": "markdown"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Posicao para continuar uma regra paginada.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "limite_caracteres",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 2000,
              "maximum": 30000,
              "default": 18000
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Conteudo e metadados da regra.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RespostaRegra"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErroDeConsulta"
          },
          "500": {
            "$ref": "#/components/responses/ErroInterno"
          }
        }
      }
    },
    "/referencias.php": {
      "get": {
        "operationId": "seguirReferencias",
        "summary": "Localizar dependencias e links de uma regra",
        "description": "Resolve referencias internas para outras regras e lista links oficiais. Use depois de ler uma regra relevante.",
        "x-openai-isConsequential": false,
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": true,
            "description": "ID global da regra de origem.",
            "schema": {
              "type": "string",
              "maxLength": 300
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Referencias internas e links oficiais.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RespostaGenerica"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErroDeConsulta"
          },
          "500": {
            "$ref": "#/components/responses/ErroInterno"
          }
        }
      }
    },
    "/categorias.php": {
      "get": {
        "operationId": "listarCategorias",
        "summary": "Listar categorias da base",
        "description": "Lista categorias oficiais e quantidades para orientar buscas e navegacao.",
        "x-openai-isConsequential": false,
        "responses": {
          "200": {
            "description": "Categorias disponiveis.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RespostaGenerica"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/ErroInterno"
          }
        }
      }
    },
    "/secoes.php": {
      "get": {
        "operationId": "listarSecoes",
        "summary": "Listar secoes organizadas de uma categoria",
        "description": "Navega pelas secoes de uma categoria e pode filtrar pela rota interna.",
        "x-openai-isConsequential": false,
        "parameters": [
          {
            "name": "categoria",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 120
            }
          },
          {
            "name": "rota",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 300
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "limite",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 30
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Secoes e paginacao.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RespostaGenerica"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErroDeConsulta"
          },
          "500": {
            "$ref": "#/components/responses/ErroInterno"
          }
        }
      }
    },
    "/status.php": {
      "get": {
        "operationId": "verificarBase",
        "summary": "Verificar integridade da base oficial",
        "description": "Confirma se o indice esta online, integro e atualizado.",
        "x-openai-isConsequential": false,
        "responses": {
          "200": {
            "description": "Estado atual da base.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RespostaGenerica"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/ErroInterno"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "RespostaGenerica": {
        "type": "object",
        "required": [
          "ok",
          "dados"
        ],
        "properties": {
          "ok": {
            "type": "boolean",
            "const": true
          },
          "dados": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "additionalProperties": false
      },
      "ResultadoBusca": {
        "type": "object",
        "required": [
          "id",
          "categoria",
          "rota",
          "titulo",
          "trecho"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "categoria": {
            "type": "string"
          },
          "rota": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "titulo": {
            "type": "string"
          },
          "subtitulo": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "pontuacao": {
            "type": "integer"
          },
          "caracteres": {
            "type": "integer"
          },
          "atualizado_em": {
            "type": "string"
          },
          "status_sincronizacao": {
            "type": "string"
          },
          "trecho": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "RespostaBusca": {
        "type": "object",
        "required": [
          "ok",
          "dados"
        ],
        "properties": {
          "ok": {
            "type": "boolean",
            "const": true
          },
          "dados": {
            "type": "object",
            "required": [
              "consulta",
              "resultados",
              "total_encontrado",
              "proximo_passo"
            ],
            "properties": {
              "consulta": {
                "type": "string"
              },
              "resultados": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ResultadoBusca"
                }
              },
              "total_encontrado": {
                "type": "integer"
              },
              "proximo_passo": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "additionalProperties": false
      },
      "RespostaRegra": {
        "type": "object",
        "required": [
          "ok",
          "dados"
        ],
        "properties": {
          "ok": {
            "type": "boolean",
            "const": true
          },
          "dados": {
            "type": "object",
            "required": [
              "id",
              "categoria",
              "rota",
              "titulo",
              "conteudo",
              "tem_mais",
              "instrucao"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "categoria": {
                "type": "string"
              },
              "rota": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "titulo": {
                "type": "string"
              },
              "subtitulo": {
                "type": "string"
              },
              "tags": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "sumario_url": {
                "type": "string"
              },
              "atualizado_em": {
                "type": "string"
              },
              "status_sincronizacao": {
                "type": "string"
              },
              "formato": {
                "type": "string"
              },
              "offset": {
                "type": "integer"
              },
              "caracteres_retornados": {
                "type": "integer"
              },
              "caracteres_totais": {
                "type": "integer"
              },
              "tem_mais": {
                "type": "boolean"
              },
              "proximo_offset": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "sha256_conteudo_completo": {
                "type": "string"
              },
              "conteudo": {
                "type": "string"
              },
              "instrucao": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "additionalProperties": false
      },
      "Erro": {
        "type": "object",
        "required": [
          "ok",
          "erro"
        ],
        "properties": {
          "ok": {
            "type": "boolean",
            "const": false
          },
          "erro": {
            "type": "string"
          },
          "orientacao": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "responses": {
      "ErroDeConsulta": {
        "description": "Parametros invalidos ou regra nao encontrada.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Erro"
            }
          }
        }
      },
      "ErroInterno": {
        "description": "Falha temporaria ao consultar a base.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Erro"
            }
          }
        }
      }
    }
  }
}