Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

contato/save?



DESCRIÇÃOEste método tem a função de atualizar e/ou registrar contatos novos, de acordo com os dados informado nos campos.
ESTRUTURA DA URLhttps://api.directcallsoft.com/contato/save?
VERSÃO1
MÉTODOPOST
PARÂMETROS

format opcional Opção de retorno da API, podendo ser JSON ou XML (se não informado, JSON será o padrão)

access_token obrigatório Chave de acesso ao método. Para saber como obter, clique aqui

id_contato opcional Se não for informado sera incluído um novo registro. Se for informado vai localizar o cadastro e atualizar

id_grupo obrigatório Código do grupo de contatos onde será atualizado e ou cadastrado

razao_social obrigatório Nome razão social da empresa

contato obrigatório Nome do Contato

telefone_fixo obrigatório Numero de telefone fixo do contato

celular obrigatório Numero de telefone celular

email opcional Endereço de e-mail do contato

pais opcional Nome do país

cep opcional Número do cep de endereço

rua opcional Logradouro do endereço

numero opcional Numero do endereço

bairro opcional Nome do Bairro do endereço

complemento opcional Informações adicionais ao endereço do contato

cidade opcional Nome da Cidade de endereço do contato

estado opcional Abreviação do nome do Estado  (XX)

ramo_atividade opcional Área em que atua no mercado 

observacao opcional Dados adicionais

oauth_id_responsavel opcional código do usuário de acesso da API


RETORNO

api Nome da API que esta sendo usada

modulo Módulo que está sendo chamado

status Mensagem de status

codigo Código de retorno - Clique aqui para listar os códigos e suas descrições

data Array de resposta da API



{                                                                                                                                                                                             
    "api": "contato",
    "modulo": "contato",
    "status": "ok",
    "codigo": "000",
    "msg": "Contato atualizado com sucesso",
    "data": {
        "id_contato": "XXXXXXX",
        "id_empresa": "XXXX",
        "id_usuario": "XXXX",
        "id_grupo": "XXXXX",
        "razao_social": "NOME EMPRESA LTDA",
        "contato": "CONTATO",
        "telefone_fixo": "5541XXXXXXXX",
        "celular": "5541XXXXXXXXX",
        "email": "",
        "pais": "",
        "cep": "",
        "rua": "",
        "numero": "0",
        "bairro": "",
        "complemento": "",
        "cidade": "",
        "estado": "",
        "ramo_atividade": "",
        "observacao": "",
        "criado_em": "2020-01-14 14:09:37",
        "excluido_em": null
    }
}



Informações

Validade dos tokens: Os tokens de acesso têm uma validade limitada, por isso convém que o sistema criado tenha em conta estes timings para que possa desenvolver rotinas de requisição de novos tokens.