Conectividade

API e integrações

Credenciais do SpinCare, coletor de contingência e tokens da API interna em módulos separados.

Canal 1

API oficial SpinCare

Usada no backend para autenticar e obter cadastros, escala, evoluções e documentos quando a API oficial disponibiliza o dado.

Não configurada

Canal 2 · contingência

Coletor de anexos no Chrome

A API oficial é o canal principal. A extensão fica disponível somente como contingência se o SpinCare deixar de aceitar o token oficial nos endpoints de anexos.

Verificando acesso aos anexos
Extensão não conectada
Guia da extensão
Procurando a extensão neste Chrome...
1
ExtensãoAguardando detecção
2
PareamentoAguardando autorização
3
Sessão SpinCareAguardando login

Pareamentos

Doc Care Developer Platform

Central de API

Credenciais, catálogo de endpoints e documentação operacional em um único ambiente.

API operacionalCarregando contrato…
Credenciais ativas—Carregando
Endpoints publicados—módulos documentados
Chamadas registradas—contagem agrupada por credencial
SegurançaHMACexpiração, escopos e auditoria

Primeiros passos

Integre em três etapas

  1. 1
    Crie uma credencialEscolha apenas os módulos e ações necessários.
  2. 2
    Consulte o contratoUse o catálogo navegável, OpenAPI ou a coleção Postman.
  3. 3
    Implemente com segurançaBearer token, idempotência nas escritas e ETag nas edições.

Ambiente de produção

Endpoint base

/api/v1
Autenticação
Bearer token
Formato
JSON · UTF-8
Contrato
OpenAPI 3.1
Paginação
page + pageSize
Nenhuma pendência crítica detectada.

Controle de acesso

Credenciais da API

O segredo completo aparece uma única vez. A plataforma armazena somente hash protegido.

Carregando credenciais…

Referência técnica

Catálogo de endpoints

Separado por módulo, com filtros, parâmetros, escopos e exemplos.

OpenAPI JSONPostman
Carregando contrato…

Implementação

Guias técnicos

Padrões obrigatórios para integrações estáveis e auditáveis.

01

Autenticação

Envie Authorization: Bearer <token>. Nunca grave o segredo em frontend, log ou URL.

02

Paginação e filtros

Listagens usam page, pageSize e filtros específicos exibidos em cada endpoint.

03

Escritas idempotentes

Uploads e ações POST exigem Idempotency-Key para impedir duplicidade em retentativas.

04

Concorrência

Edições usam o ETag do GET no cabeçalho If-Match. Versão antiga recebe HTTP 412.

05

Erros

Respostas incluem código estável e requestId. Use 429 com retentativa progressiva e não repita erros 4xx.

06

Arquivos

Binários são carregados apenas nas rotas de download. Uploads aceitam um arquivo de até 25 MB.

Exemplo mínimo

Consultar documentos

curl --request GET \
  --url 'https://doccare.cuidarsaude.cloud/api/v1/documents?page=1&pageSize=50' \
  --header 'Authorization: Bearer SEU_TOKEN'