Documentação da API para Desenvolvedores

Esta documentação apresenta os requisitos essenciais para integração com a API PrimaSis, incluindo URL, autenticação, método de envio, estrutura do payload, estrutura da resposta e erros possíveis.

Nosso pessoal de Suporte estará a disposição para o seu caso específico, informando seu token e os campos necessários na requisição.

Dúvidas pelo nosso canal de atendimento: suporte@primasis.com.

---

1. URL Base da API

https://www.prima1.app/api2026V1.php

---

2. Autenticação (Token)

A autenticação é feita por meio de um token exclusivo fornecido ao cliente.

O token deve ser enviado no corpo da requisição JSON:

{
  "token": "SEU_TOKEN_AQUI"
}

---

3. Método de Envio

A API aceita apenas requisições:

• Método HTTP: POST
• Formato: JSON
• Content-Type: application/json

Content-Type: application/json

---

4. Exemplo de Estrutura do JSON Enviado (Payload)

No exemplo fictício de uma listagem de lançamentos do Livro Caixa
o corpo da requisição deve conter:

• token – chave de autenticação
• case – operação desejada
• dtInicial – data inicial
• dtFinal – data final

{
  "token": "SEU_TOKEN_AQUI",
  "case": "livroCaixa",
  "dtInicial": "2026-06-01",
  "dtFinal": "2026-06-03"
}

---

5. Estrutura da Resposta

A API sempre retorna JSON. Exemplo:

{
  "status": "OK",
  "mensagem": "Dados encontrados",
  "dados": [
    {
      "id": 1,
      "data": "2026-06-01",
      "descricao": "Entrada",
      "valor": 150.00
    }
  ]
}

status → OK ou ERRO

mensagem → descrição do resultado

dados → array com registros retornados

---

6. Possíveis Erros

{ "status": "ERRO", "mensagem": "Token inválido" }

{ "status": "ERRO", "mensagem": "Case não encontrado" }

{ "status": "ERRO", "mensagem": "Parâmetros insuficientes" }