PT
Español
English
Português
    Editar valores em campos adicionais como lista, árvore e multi-seleção

    Detalhes da petição

    • URL Base: {host}/ASMSAPI/
    • URI: /api/v9/additionalsfields/values/{fieldValueId}
    • Cara:PÔR
    • Cabeçalhos necessários:

    • content-type: application/json
    • X-Authorization: Bearer {token}

    Descrição do URL

    • {host}: Ele representa o domínio do ambiente no qual a API está localizada.
    • ASMSAPI/: Prefixo de API fixo.
    • {fieldValueId}: ID do valor do campo adicional (lista, árvore ou multi-seleção) que você deseja editar.
    • URI: Ponto de extremidade específico para a solicitação.


    ⚐ URL DE EXEMPLO:

    https://{host}/ASMSAPI/api/v9/additionalsfields/values/2950
    


    Passo Anterior: Faça o ID do valor para editar

    Antes de editar um valor, consulte a lista de valores no campo para identificar o id do valor a ser alterado:

    Endpoint da consulta:

    GET /ASMSAPI/api/v9/additionalsfields/{fieldId}/type/7/values?dataType=0
    

    Parâmetros de consulta:

    Nome Tipo de dado Descrição
    ID do campo Número ID adicional de campo (lista, árvore ou multi-seleção)
    tipo Número Tipo de campo (7 para lista, árvore e multi-seleção)
    Datatype Número Tipo de Dado (0 padrão)

    Resposta de exemplo:

    [
        {
            "catalogId": 0,
            "description": null,
            "fieldId": 1787,
            "hasChild": false,
            "id": 2950,
            "key": null,
            "name": "API",
            "order": 0,
            "parentId": null,
            "restrictLevel": false,
            "status": 0
        }
    ]
    

    ⚐ Nota: >

    • O campo id na resposta está aquele que deve ser usado como {fieldValueId} na URL de edição.


    Parâmetros da Petição

    Nome Tipo de dado Obrigatório Descrição
    Valor Texto Sim Novo texto/nome que substituirá o valor atual

    Corpo da petição

    {
      "Value": "Bogotá"
    }
    

    ⚐ Nota: >

    • A edição só atualiza o texto/nome do valor (Value). O ParentId, o RestrictLevel e o Status dos valores não são modificados por esse extremo.
    • Você não pode atualizar um valor com um nome que já exista naquele mesmo campo.


    Responder

    Sucesso (Status 200)

    {
        "result": true
    }
    

    Parâmetros de resposta

    Nome Tipo de dado Descrição
    resultado Booleano Indica se a operação foi bem-sucedida


    Mensagens de erro

    Código Status HTTP Mensagem de erro
    401 Desautorizado Você não tem permissão para visualizar este diretório ou página
    400 Solicitação incorreta FailureUpdateFieldValue
    400 Solicitação incorreta InvalidAdditionalFieldValue (o fieldValueId não existe)