Detalhes da petição
- URL Base: {host}/ASMSAPI/
- URI:
/api/v9/additionalsfields/values/{fieldValueId} - Cara:PÔR
-
Cabeçalhos necessários:
content-type: application/jsonX-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
idna 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). OParentId, oRestrictLevele oStatusdos 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) |