Lista programas inscrito

Só são suportadas integrações no padrão REST.

Introdução

Método de listagem de atividades do programa de APS

Método "aps/programasInscritos"

Este método é obrigatório;
Atente-se aos critérios de preenchimento;
Atente-se as mensagens de retorno para cada HTTPS Status Code;

Endpoint

Endpoint	Método	Header Content-Type	Descrição

Endpoint	Método	Header Content-Type	Descrição
exemplo.com / aps/programasInscrito	POST	application/json	Endpoint responsavel por realizar a adesão no programa de APS

Parâmetros de entrada

Serão enviados no HEADER os headers estáticos definidos ao configurar a integração, combinado com os tokens retornados pela configuração de autorização da integração (caso seja vinculada) e os headers de segurança retornado no login do beneficiário.

Serão enviados no BODY os seguintes parâmetros:

Parâmetro	Obrigatório	Tipo	Descrição

Parâmetro	Obrigatório	Tipo	Descrição
chaveUnica	M	String	Chave de identificação do usuário retornada no login
integracao	OP	Objeto	Nó integração retornado no login do usuário
beneficiario	M	Objeto	Beneficiario selecionado para agendamento da consulta

{
    "chaveUnica":"String",
    "integracao":{ Objeto },
    "beneficiario":{ Objeto }
}

Objeto beneficiario

Atributo	Critério	Tipo	Descrição	Regra de preenchimento

Atributo	Critério	Tipo	Descrição
chaveUnica	M	String	Chave de identificação do paciente
numeroContrato	M	String	Número do contrato do paciente
integracao	OP	Objeto	Nó integração retornado no login do usuário

{
    "beneficiario":{
      "chaveUnica":"String",
      "numeroContrato":"String",
      "integracao":{ Objeto }
}

Exemplo request

{
  "chaveUnica": "101012",
  "integracao": {
    "cpf": "123456789123",
    "numero_cartao": "9288701",
  },
  "beneficiario": {
    "chaveUnica": "101012", //geralmente é o cpf
    "numeroContrato": "616161",
    "integracao": {
        "cpf": "123456789123", 
        "numero_cartao": "9288701",
      },
  }
}

Descrição dos objetos e atributos de retorno - Sucesso

Está indicado abaixo a estrutura de retorno do método. Esse método deve obedecer as regras indicadas no objeto principal e em seus desdobramentos.

Objeto principal

Atributo	Critério	Tipo	Descrição	Regra de preenchimento

Atributo	Critério	Tipo	Descrição	Regra de preenchimento
programas	M	Array de objetos do tipo "programa"

{
  "programas": [ "Objeto" ],
}

Objeto "programa"

Atributo	Critério	Tipo	Descrição	Regra de preenchimento

Atributo	Critério	Tipo	Descrição
codigo	M	Numer	Codigo identificador do porgrama
titulo	M	String	Titulo do programa
descricao	OP	String	Descrição do programa
icone	OP	String	Icone do programa
grupos	OP	Array de objetos do tipo "grupo"

{
    "programa":{
      "codigo":" Number,
      "titulo":"String",
      "descricao":"String",
      "icone":"String",
      "grupos":[ "Objeto" ],
    }
}

Objeto "grupo"

Atributo	Critério	Tipo	Descrição	Regra de preenchimento

Atributo	Critério	Tipo	Descrição
codigo	M	Numer	Codigo identificador do grupo
titulo	M	String	Titulo do grupo
descricao	OP	String	Descrição do grupo
icone	OP	String	Icone do grupo
subgrupo	OP	Objeto do tipo subgrupo

{
    "grupos":[
      {
        "codigo": Number,
        "titulo":"String",
        "descricao":"String",
        "icone":"String",
        "subgrupo":"Objeto",
      }
    ]
}

Objeto "subgrupo"

Atributo	Critério	Tipo	Descrição	Regra de preenchimento

Atributo	Critério	Tipo	Descrição
codigo	M	Numer	Codigo identificador do subgrupo
titulo	M	String	Titulo do subgrupo
descricao	OP	String	Descrição do subgrupo
icone	OP	String	Icone do subgrupo

{
    "codigo": Number,
    "titulo":"String",
    "descricao":"String",
    "icone":"String",
}

Retorno da API - Sucesso

{
    "programas":[
        {
          "codigo":11023,
          "titulo": "Atendimento Primário a Saúde",
          "descricao": "A linha de cuidado atendimento primário a saúde é a linha de cuidado que...", //Parametro opcional
          "icone":"<link da imagem>", //Parametro opcional
          "grupos":[
            {
              "codigo": 123,
              "titulo": "Atendimento Primário a Saúde",
              "descricao": "Grupo Xpto", //Parametro opcional
              "icone":"<link da imagem>", //Parametro opcional
              "subgrupo":{
                "codigo":123,
                "titulo": "Atendimento Primário a Saúde",
                "descricao": "xpto",//Parametro opcional
                "icone":"<link da imagem>", //Parametro opcional
              },
            },
            {
              "codigo": 123,
              "titulo": "Atendimento Primário a Saúde",
              "descricao": "Grupo Xpto", //Parametro opcional
              "icone":"<link da imagem>", //Parametro opcional
              "subgrupo":{
                "codigo":123,
                "titulo": "Atendimento Primário a Saúde",
                "descricao": "xpto",//Parametro opcional
                "icone":"<link da imagem>", //Parametro opcional
              },
            }
          ]
        },
        {
          "codigo":11023,
          "titulo": "Atendimento Primário a Saúde",
          "descricao": "A linha de cuidado atendimento primário a saúde é a linha de cuidado que...", //Parametro opcional
          "icone":"<link da imagem>", //Parametro opcional
          "grupos":[
            {
              "codigo": 123,
              "titulo": "Atendimento Primário a Saúde",
              "descricao": "Grupo Xpto", //Parametro opcional
              "icone":"<link da imagem>", //Parametro opcional
              "subgrupo":{
                "codigo":123,
                "titulo": "Atendimento Primário a Saúde",
                "descricao": "xpto",//Parametro opcional
                "icone":"<link da imagem>", //Parametro opcional
              },
            }
          ]
        },
    ] 
}

Retorno da API - Falha

{
  "mensagem": "Não foi possível listar suas atividades"
}

Atente-se as mensagens de retorno para cada HTTPS Status Code;
Siga as instruções de Descrição dos objetos e atributos de retorno - falha;

Mosia Omnichannel Parceiros