Mudanças entre as edições de "API-GUIA-SERVICOS"

De SEADE
Ir para: navegação, pesquisa
(→‎Serviços)
(→‎Serviços)
Linha 418: Linha 418:
 
       "Tipo de cobranças": null,
 
       "Tipo de cobranças": null,
 
       "Alvo do serviço": "Cidadão",
 
       "Alvo do serviço": "Cidadão",
−
       "Descricao": "p style='text-align: justify;'>A Ouvidoria da SAP existe para assegurar aos cidadãos presos o respeito a seus direitos básicos. Permite ao preso,  
+
       "Descricao": "A Ouvidoria da SAP existe para assegurar aos cidadãos presos o respeito a seus direitos básicos. Permite ao preso,  
−
         diretamente ou por seus familiares, registrar sua sugest&atilde;o, den&uacute;ncia ou reclama&ccedil;</p>",
+
         diretamente ou por seus familiares, registrar sua sugest&atilde;o, den&uacute;ncia ou reclama&ccedil;....",
 
       "Data da disponibilização": "2016-04-08 14:43:17"
 
       "Data da disponibilização": "2016-04-08 14:43:17"
 
       }
 
       }
 
     ]
 
     ]
 
     },
 
     },
 +
 +
=== Serviços detalhados por Tema===
 +
 +
 +
'''GET'''
 +
 +
 +
Para buscar todos os serviços do Órgão , é necessário informar os parâmetros de paginação, conforme a sintaxe abaixo:
 +
 +
* '''Path''': /servico/detalhado/tema/{id}/offset={inicial}/limit={limite}
 +
 +
 +
curl -X GET "http://api-guiaserv.seade.gov.br/v1/servico/detalhado/tema/1/offset=0/limit=20"
 +
 +
 +
 +
=== Retorno JSON ===
 +
 +
Exemplo:
 +
 +
   
 +
  {
 +
  "header": {
 +
    "serviços": 3,
 +
    "paginas": 1,
 +
    "offset": "0",
 +
    "limite": "20"
 +
  },
 +
  "servico": [
 +
    {
 +
      "ID_Tema": "1",
 +
      "Tema": "Achados e perdidos",
 +
      "ID_Servico": "981",
 +
      "Nome do serviço": "Achados e Perdidos - Metrô",
 +
      "ID_Orgao": "29",
 +
      "Nome_Secretaria": "Secretaria dos Transportes Metropolitanos",
 +
      "ID_Prestador": "291",
 +
      "Nome_Prestador": "Companhia do Metropolitano de São Paulo - Metrô",
 +
      "Serviços que possuem informações em homepage": "Sim",
 +
      "URL da homepage": "www.metro.sp.gov.br/servicos/achados/achados.shtml",
 +
      "Serviços que oferecem informações por e-mail": "Não",
 +
      "Descrição do e-mail": null,
 +
      "Serviços que oferecem informações por formulário eletrônico": "Não",
 +
      "URL do formúlario eletrônico": null,
 +
      "Serviços que oferecem informações por telefone": "Sim",
 +
      "Número do Telefone 1": "0800 7707722",
 +
      "Número do Telefone 2": null,
 +
      "Número do Telefone 3": null,
 +
      "Serviços que oferecem informações por correspondência": "Sim",
 +
      "Serviços que oferecem informações no próprio órgão": "Sim",
 +
      "Serviço que possuem informações disponibilizadas através do Poupatempo ": "Não",
 +
      "Serviços que oferecem informações em instituições credenciadas": "Não",
 +
      "Serviços que oferecem informações em domicílio ": "Não",
 +
      "Serviços que oferecem informações em Escritórios Regionais/Postos de Atendimento ": "Não",
 +
      "Serviços que oferecem informações de outras formas": "Não",
 +
      "Serviços que são prestados por homepage": "Sim",
 +
      "Serviços realizados parcialmente pela Internet (somente formulários)": "Sim",
 +
      "Serviços que são prestados por formulário": "Não",
 +
      "Serviços que são prestados por telefone": "Não",
 +
      "Serviços que são prestados por correspondência": "Não",
 +
      "Endereço para correspondência": "Rua Vergueiro, 1200 - Paraiso",
 +
      "Cep para correspondência": "01504000",
 +
      "Código Município para correspondência": "3550308",
 +
      "Serviços que são prestados no próprio órgão": "Sim",
 +
      "Serviço que são prestados no Poupatempo ": "Não",
 +
      "Serviços que são prestados em instituições credenciadas": "Não",
 +
      "Serviços que são prestados em domicílio": "Não",
 +
      "Serviços que são prestados em Escritórios Regionais/Postos de Atendimento ": "Não",
 +
      "Serviços que são prestados por outras formas": "Não",
 +
      "Descrição das outras formas de serviços": null,
 +
      "Cobrança para execução do serviço?": "Não gratuito",
 +
      "Tipo de cobranças": null,
 +
      "Alvo do serviço": "Cidadão e Empresa",
 +
      "Descricao": "Permite aos usu&aacute;rios a busca e eventual entrega de objetos perdidos ou encontrados nas esta&ccedil;&otilde;es ou nos trens do Metr&ocirc;.&nbsp;
 +
        <span>O posto central funciona na Esta&ccedil;&atilde;o S&eacute;, de 2&ordf; a 6&ordf;, das 7h &agrave;s 20h..",
 +
      "Data da disponibilização": "2016-04-08 14:43:17"
 +
      }
 +
    ]
 +
    }

Edição das 15h54min de 24 de outubro de 2016

Índice

Apresentação

A API, sigla em inglês para Interface de Programação de Aplicativos, foi desenvolvida para permitir a criação de aplicações que tornem possível a visualização de informações dos serviços públicos em outros sítios, ou a reutilização em sistemas desenvolvidos por usuários, mediante acesso direto à base de informações sempre atualizadas do Guia de Serviços. O formato, em código aberto, é o JSON e não há necessidade de cadastro ou qualquer outro procedimento para o acesso.

URI 

http://api-guiaserv.seade.gov.br/v1

Código HTTP de Retorno

  • Sucesso: 200.
  • Erro: 404.

Recursos Disponíveis

Órgãos

GET


  • Path: /orgao/
  • Parâmetros: id

É necessário informar o "id" (código) ou a palavra "all" para listar todos os registros.


Sintaxe de chamada 

curl -X GET "http://api-guiaserv.seade.gov.br/v1/orgao/all"

ou 

curl -X GET "http://api-guiaserv.seade.gov.br/v1/orgao/{id}"

Retorno JSON

Exemplo: 

{
 "orgao": [
   {
     "Nome": "Procuradoria Geral do Estado",
     "ID_Orgao": "35",
     "Condicao": "1"
   }
 ]
}

  Obs.: Condicao = 1 (órgao ativo) e Condicao = 0 (órgão inativo)

Prestadores

GET


  • Path: /prestador/
  • Parâmetros: id

É necessário informar o "id" (código) ou a palavra "all" para listar todos os registros.


Sintaxe de chamada 

curl -X GET "http://api-guiaserv.seade.gov.br/v1/prestador/all"

ou 

curl -X GET http://api-guiaserv.seade.gov.br/v1/prestador/{id}"

Retorno JSON

Exemplo: 


{
 "prestador": [
   {
     "ID_Prestador": "310",
     "Nome": "Procuradoria Geral do Estado - Sede",
     "ID_Orgao": "35",
     "Nome_Secretaria": "Procuradoria Geral do Estado",
     "Endereco": "Rua Pamplona",
     "EndNumero": "227",
     "EndComplemento": "6º andar",
     "CEP": "01405902",
     "Municipio_IBGE": "3550308",
     "Nome_Municipio": "São Paulo",
     "Telefone": "11-3372-6438",
     "Ramal": null,
     "Fax": "11-3372-6498",
     "HomePage": "www.pge.sp.gov.br",
     "Email": "arinaldi@sp.gov.br",
     "Condicao": "1"
   }
 ]
}

Obs.: Condicao = 1 (prestador ativo) e Condicao = 0 (prestador inativo)

Municípios

GET


  • Path: /municipio/
  • Parâmetros: id

É necessário informar o "id" (código) ou a palavra "all" para listar todos os registros.


Sintaxe de chamada 

curl -X GET "http://api-guiaserv.seade.gov.br/v1/municipio/all"

ou 

curl -X GET "http://api-guiaserv.seade.gov.br/v1/municipio/{id}"

Retorno JSON

Exemplo: 

{
 "muncipio": [
   {
     "Municipio_IBGE": "3550308",
     "Nome": "São Paulo"
   }
 ]
}

Ouvidorias

GET


  • Path: /ouvidoria/
  • Parâmetros: id

É necessário informar o "id" (código do prestador) ou a palavra "all" para listar todos os registros.


Sintaxe de chamada 

curl -X GET "http://api-guiaserv.seade.gov.br/v1/ouvidoria/all"

ou 

curl -X GET "http://api-guiaserv.seade.gov.br/v1/ouvidoria/{id}"

Retorno JSON

Exemplo: 

{
 "ouvidoria": [
   {
     "ID_Prestador": "310",
     "ID_Informante": "38",
     "Nome": "Maria Rita Vaz de Arruda Corsini",
     "Telefone": "11-3372-6405",
     "Ramal": null,
     "Email": "ouvidoria@sp.gov.br",
     "Fax": "11-3372-6406",
     "HomePage": "http://www.ouvidoria.sp.gov.br/RegistraManifestacao.aspx?cod_prestador=310",
     "Endereco": "Rua Pamplona",
     "EndNumero": "227",
     "EndComplemento": "1º andar",
     "CEP": "01405902",
     "Municipio_IBGE": "3550308",
     "Nome_Municipio": "São Paulo",
     "AtendInicio": "10:00",
     "AtendFim": "16:00",
     "Condicao": "2"
   }
 ]
}

Obs.: Condicao = 2 (ouvidor ativo) e Condicao = 1 (ouvidor inativo)

Ouvidores

GET


  • Path: /ouvidor/
  • Parâmetros: id

É necessário informar o "id" (código) ou a palavra "all" para listar todos os registros.


Sintaxe de chamada 

curl -X GET "http://api-guiaserv.seade.gov.br/v1/ouvidor/all"

ou 

curl -X GET "http://api-guiaserv.seade.gov.br/v1/ouvidor/{id}"

Retorno JSON

Exemplo: 

{
 "ouvidor": [
   {
     "ID_Informante": "38",
     "ID_Usuario": "235",
     "Nome": "Maria Rita Vaz de Arruda Corsini",
     "Cargo": "Ouvidora",
     "Gerencia": "Ouvidoria",
     "Telefone": "11-3372-6493",
     "Ramal": "",
     "Fax": "11-3372-6406",
     "Email": "mcorsini@sp.gov.br,tari@uol.com.br"
   }
 ]
}

Serviços

GET

Use o formato abaixo para buscar uma variável por requisição.

  • Path: /servico/
  • Parâmetros: id

Para buscar um serviço específico é necessário informar o "id" (código).

Para buscar todos os serviços, é necessário informar os parâmetros de paginação, conforme a sintaxe abaixo:

  • Path: /servico/offset={inicial}/limit={limite}


Sintaxe de chamada 

curl -X GET "http://api-guiaserv.seade.gov.br/v1/servico/offset=0/limit=10"

ou 

curl -X GET "http://api-guiaserv.seade.gov.br/v1/servico/{id}"

Retorno JSON

Exemplo: 


{
 "servico": [
   {
     "Nome": "Indenização Administrativa de Danos Causados por Agentes do Estado - Procuradoria Geral do Estado",
     "ID_Servico": "1302",
     "ID_Orgao": "35",
     "Nome_Secretaria": "Procuradoria Geral do Estado",
     "ID_Prestador": "310",
     "Nome_Orgao": "Procuradoria Geral do Estado - Sede",
     "Descricao": "Indenização administrativa de danos causados por agentes do Estado. Avalia-se a possibilidade de acordo administrativo sobre indenização de danos, desde que o pretendente não tenha ação judicial veiculando 
      a mesma pretensão indenizatória.",
     "Condicao": "1"
   }
 ]
}

Obs.: Sempre será listado o serviço de Condicao = 1 (registro da última atualização)

Serviços detalhados

GET

Use o formato abaixo para buscar uma variável por requisição.

  • Path: /servico/detalhado/
  • Parâmetros: id


Para buscar um serviço específico é necessário informar o "id" (código).

Para buscar todos os serviços, é necessário informar os parâmetros de paginação, conforme a sintaxe abaixo:

  • Path: /servico/detalhado/offset={inicial}/limit={limite} 


curl -X GET "http://api-guiaserv.seade.gov.br/v1/servico/detalhado/offset=0/limit=10"

ou 

curl -X GET "http://api-guiaserv.seade.gov.br/v1/servico/detalhado/{id}"

Retorno JSON

Exemplo: 

   {
    "header": {
    "serviços": "833",
    "offset": "138",
    "limite": "1"
     },
    "servico": [
     {
     "Nome do serviço": "Indenização Administrativa de Danos Causados por Agentes do Estado - Procuradoria Geral do Estado",
     "ID_Servico": "1302",
     "ID_Orgao": "35",
     "Nome_Secretaria": "Procuradoria Geral do Estado",
     "ID_Prestador": "310",
     "Nome_Prestador": "Procuradoria Geral do Estado - Sede",
     "Serviços que possuem informações em homepage": "Não",
     "URL da homepage": null,
     "Serviços que oferecem informações por e-mail": "Não",
     "Descrição do e-mail": null,
     "Serviços que oferecem informações por formulário eletrônico": "Não",
     "URL do formúlario eletrônico": null,
     "Serviços que oferecem informações por telefone": "Sim",
     "Número do Telefone 1": "(11) 3372-6414 - Procurador Instrutor",
     "Número do Telefone 2": null,
     "Número do Telefone 3": null,
     "Serviços que oferecem informações por correspondência": "Sim",
     "Serviços que oferecem informações no próprio órgão": "Sim",
     "Serviço que possuem informações disponibilizadas através do Poupatempo ": "Não",
     "Serviços que oferecem informações em instituições credenciadas": "Não",
     "Serviços que oferecem informações em domicílio ": "Não",
     "Serviços que oferecem informações em Escritórios Regionais/Postos de Atendimento ": "Não",
     "Serviços que oferecem informações de outras formas": "Não",
     "Serviços que são prestados por homepage": "Não",
     "Serviços realizados parcialmente pela Internet (somente formulários)": null,
     "Serviços que são prestados por formulário": "Não",
     "Serviços que são prestados por telefone": "Não",
     "Serviços que são prestados por correspondência": "Não",
     "Endereço para correspondência": "Rua Pamplona, 227 - 17º andar",
     "Cep para correspondência": "01405902",
     "Código Município para correspondência": "3550308",
     "Serviços que são prestados no próprio órgão": "Sim",
     "Serviço que são prestados no Poupatempo ": "Não",
     "Serviços que são prestados em instituições credenciadas": "Não",
     "Serviços que são prestados em domicílio": "Não",
     "Serviços que são prestados em Escritórios Regionais/Postos de Atendimento ": "Não",
     "Serviços que são prestados por outras formas": "Não",
     "Descrição das outras formas de serviços": null,
     "Cobrança para execução do serviço?": "Não gratuito",
     "Tipo de cobranças": null,
     "Alvo do serviço": "Cidadão e Empresa",
     "Descricao": "Indenização administrativa de danos causados por agentes do Estado. Avalia-se a possibilidade de acordo administrativo sobre indenização de danos, desde que o pretendente 
          não tenha ação judicial veiculando a mesma pretensão indenizatória.",
     "Data da disponibilização": "2016-04-08 14:43:17"
     }
    ]
   }

Serviços detalhados por Órgão

GET


Para buscar todos os serviços do Órgão , é necessário informar os parâmetros de paginação, conforme a sintaxe abaixo:

  • Path: /servico/detalhado/orgao/{id}/offset={inicial}/limit={limite} 


curl -X GET "http://api-guiaserv.seade.gov.br/v1/servico/detalhado/orgao/11/offset=0/limit=20"


Retorno JSON

Exemplo: 


 "header": {
   "serviços": "6",
   "paginas": 1,
   "offset": "0",
   "limite": "10"
 },
 "servico": [
   {
     "Nome do serviço": "Ouvidoria - Secretaria da Administração Penitenciária",
     "ID_Servico": "1",
     "ID_Orgao": "11",
     "Nome_Secretaria": "Secretaria da Administração Penitenciária",
     "ID_Prestador": "1",
     "Nome_Prestador": "Secretaria da Administração Penitenciária - Sede",
     "Serviços que possuem informações em homepage": "Sim",
     "URL da homepage": "www.sap.sp.gov.br/ouvidoria.html",
     "Serviços que oferecem informações por e-mail": "Sim",
     "Descrição do e-mail": "ouvidoria@sap.sp.gov.br",
     "Serviços que oferecem informações por formulário eletrônico": "Não",
     "URL do formúlario eletrônico": null,
     "Serviços que oferecem informações por telefone": "Sim",
     "Número do Telefone 1": "(11) 3775-8103",
     "Número do Telefone 2": "(11) 3775-8126",
     "Número do Telefone 3": "(11)  3775-8122",
     "Serviços que oferecem informações por correspondência": "Sim",
     "Serviços que oferecem informações no próprio órgão": "Sim",
     "Serviço que possuem informações disponibilizadas através do Poupatempo ": "Não",
     "Serviços que oferecem informações em instituições credenciadas": "Não",
     "Serviços que oferecem informações em domicílio ": "Não",
     "Serviços que oferecem informações em Escritórios Regionais/Postos de Atendimento ": "Não",
     "Serviços que oferecem informações de outras formas": "Não",
     "Serviços que são prestados por homepage": "Não",
     "Serviços realizados parcialmente pela Internet (somente formulários)": null,
     "Serviços que são prestados por formulário": "Não",
     "Serviços que são prestados por telefone": "Sim",
     "Serviços que são prestados por correspondência": "Sim",
     "Endereço para correspondência": "Rua Líbero Badaró, 600 - 4º andar",
     "Cep para correspondência": "01008000",
     "Código Município para correspondência": "3550308",
     "Serviços que são prestados no próprio órgão": "Sim",
     "Serviço que são prestados no Poupatempo ": "Não",
     "Serviços que são prestados em instituições credenciadas": "Não",
     "Serviços que são prestados em domicílio": "Não",
     "Serviços que são prestados em Escritórios Regionais/Postos de Atendimento ": "Não",
     "Serviços que são prestados por outras formas": "Não",
     "Descrição das outras formas de serviços": null,
     "Cobrança para execução do serviço?": "Não gratuito",
     "Tipo de cobranças": null,
     "Alvo do serviço": "Cidadão",
     "Descricao": "A Ouvidoria da SAP existe para assegurar aos cidadãos presos o respeito a seus direitos básicos. Permite ao preso, 
       diretamente ou por seus familiares, registrar sua sugestão, denúncia ou reclamaç....",
     "Data da disponibilização": "2016-04-08 14:43:17"
     }
    ]
   },

Serviços detalhados por Tema

GET


Para buscar todos os serviços do Órgão , é necessário informar os parâmetros de paginação, conforme a sintaxe abaixo:

  • Path: /servico/detalhado/tema/{id}/offset={inicial}/limit={limite} 


curl -X GET "http://api-guiaserv.seade.gov.br/v1/servico/detalhado/tema/1/offset=0/limit=20"


Retorno JSON

Exemplo: 


 {
 "header": {
   "serviços": 3,
   "paginas": 1,
   "offset": "0",
   "limite": "20"
 },
 "servico": [
   {
     "ID_Tema": "1",
     "Tema": "Achados e perdidos",
     "ID_Servico": "981",
     "Nome do serviço": "Achados e Perdidos - Metrô",
     "ID_Orgao": "29",
     "Nome_Secretaria": "Secretaria dos Transportes Metropolitanos",
     "ID_Prestador": "291",
     "Nome_Prestador": "Companhia do Metropolitano de São Paulo - Metrô",
     "Serviços que possuem informações em homepage": "Sim",
     "URL da homepage": "www.metro.sp.gov.br/servicos/achados/achados.shtml",
     "Serviços que oferecem informações por e-mail": "Não",
     "Descrição do e-mail": null,
     "Serviços que oferecem informações por formulário eletrônico": "Não",
     "URL do formúlario eletrônico": null,
     "Serviços que oferecem informações por telefone": "Sim",
     "Número do Telefone 1": "0800 7707722",
     "Número do Telefone 2": null,
     "Número do Telefone 3": null,
     "Serviços que oferecem informações por correspondência": "Sim",
     "Serviços que oferecem informações no próprio órgão": "Sim",
     "Serviço que possuem informações disponibilizadas através do Poupatempo ": "Não",
     "Serviços que oferecem informações em instituições credenciadas": "Não",
     "Serviços que oferecem informações em domicílio ": "Não",
     "Serviços que oferecem informações em Escritórios Regionais/Postos de Atendimento ": "Não",
     "Serviços que oferecem informações de outras formas": "Não",
     "Serviços que são prestados por homepage": "Sim",
     "Serviços realizados parcialmente pela Internet (somente formulários)": "Sim",
     "Serviços que são prestados por formulário": "Não",
     "Serviços que são prestados por telefone": "Não",
     "Serviços que são prestados por correspondência": "Não",
     "Endereço para correspondência": "Rua Vergueiro, 1200 - Paraiso",
     "Cep para correspondência": "01504000",
     "Código Município para correspondência": "3550308",
     "Serviços que são prestados no próprio órgão": "Sim",
     "Serviço que são prestados no Poupatempo ": "Não",
     "Serviços que são prestados em instituições credenciadas": "Não",
     "Serviços que são prestados em domicílio": "Não",
     "Serviços que são prestados em Escritórios Regionais/Postos de Atendimento ": "Não",
     "Serviços que são prestados por outras formas": "Não",
     "Descrição das outras formas de serviços": null,
     "Cobrança para execução do serviço?": "Não gratuito",
     "Tipo de cobranças": null,
     "Alvo do serviço": "Cidadão e Empresa",
     "Descricao": "Permite aos usuários a busca e eventual entrega de objetos perdidos ou encontrados nas estações ou nos trens do Metrô. 
       O posto central funciona na Estação Sé, de 2ª a 6ª, das 7h às 20h..",
     "Data da disponibilização": "2016-04-08 14:43:17"
     }
    ]
   }
Disponível em "http://doc.seade.gov.br/index.php?title=API-GUIA-SERVICOS&oldid=206"