Faciledoc - API Docs
    Faciledoc - API Docs
    • Apresentação
      • Autenticação
      • Verificar status da conta
        GET
    • V1
      • DataLens
        • Estrutura de respostas
        • CNPJ Cadastral
        • CNPJ Sintegra
        • CNPJ Sócios
        • CPF Cadastral
        • Buscar Análise

    Apresentação

    Logo API(2).png
    Documentação para utilização da plataforma Faciledoc via API. Um guia simples que mostra como realizar a integração entre aplicações e a API da Faciledoc.

    Rota básica#

    Todas as requisições para a API devem utilizar a URL básica:
    https://www.faciledoc.com.br/api
    

    Retorno de erros#

    Erros podem ocorrer por diversos motivos. Abaixo segue um mapeamento dos possíveis erros de requisição:
    statusmensagem
    400Sem preenchimento de parâmetro obrigatório
    400Erro no formato do parâmetro
    401O Token de acesso não foi fornecido
    401A conta não está ativa
    403O Token é inválido
    404Objeto não encontrado
    405Método não permitido

    Padrão da estrutura de resposta#

    Padrão da estrutura de resposta para erros:
    {
        "api_versao": string,
        "req_data": datetime,
        "req_status": inte, # código do erro
        "req_msg": string, # descrição do erro
    }
    Padrão de estrutura pararespostas com sucesso:
    {
       'api_versao': string,
       'req_data': datetime,
       'req_status': int,
       'req_msg': string,
       'dados': [], # a estrutura da resposta depende do endpoint solicitado. 
    }

    Descriação das chaves:#

    api_versao: versão da api utilizada
    req_data: timestamp da requisição
    req_status: código do status da requisição
    req_msg: texto explicativo sobre o status da resposta
    dados: estrutura específica da resposta do endpoint solicitado

    Exemplos de respostas:#

    Requisição retornando com sucesso:
    {
       'api_versao': string,
       'req_data': datetime,
       'req_status': int, # código do status
       'req_msg': string, # descrição do status
       'dados': [], # a estrutura da resposta depende do endpoint solicitado. 
    }
    Requisição retornando com erro:
    Erro no método de requisição:
    {
       'api_versao': string,
       'req_data': datetime,
       'req_status': int, # código do erro
       'req_msg': string, # descrição do status
    }
    Próxima página
    Autenticação
    Built with