Clickfin

Referência da API
Portal oficial
POST/service

Criar um novo serviço

Cria um novo serviço vinculado à empresa selecionada no token. Sem status, o serviço é criado ativo (status: 1). Campos fora do contrato (por exemplo minValueISS) são descartados sem erro. O item da Lista de Serviços (serviceItem.code) não pode repetir o de outro serviço não excluído da empresa. Requer perfil de Administrador.

AcessoChave de API · services:write
Parâmetros0
Respostas6

Respostas

201Sucesso

Serviço criado com sucesso.

400Erro

Erro de validação, empresa não selecionada no token ou item da Lista de Serviços já usado por outro serviço não excluído da empresa (SERVICE.CREATE.CODE_IN_USE, mensagem em pt-BR).

401Erro

Token ausente, inválido ou expirado, ou empresa da sessão excluída ou fora do licenciado no momento da gravação (SERVICE.CREATE.NOT_AUTHORIZED).

403Erro

Acesso comercial do licenciado bloqueado ou usuário sem perfil de Administrador.

429Erro

Limite de requisições excedido (RATE_LIMIT.EXCEEDED). Por chave: 120 requisições por minuto (janela fixa de 60 s); o 429 da chave traz X-RateLimit-* da chave. Por IP, para tráfego com chave: 600 requisições em 10 minutos; esse 429 traz só Retry-After, sem X-RateLimit-* (os cabeçalhos descrevem apenas o limite da chave). Aguarde Retry-After segundos antes de tentar de novo.

503Erro

Credencial não pôde ser verificada por falha temporária do servidor (AUTH.SESSION_UNAVAILABLE). Não invalida a chave nem a sessão: repita com backoff.