Detalles de la Petición

• URL Base: {host}/ASMSAPI/
• Uri: /api/v9/additionalsfields/{fieldId}/values
• Tipo: POST

• Encabezados requeridos:

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

Descripción de la URL

• {host}: Representa el dominio del ambiente en el que se encuentra la API.
• ASMSAPI/: Prefijo fijo de la API.
• {fieldId}: ID del campo adicional tipo árbol donde se agregará el valor.
• Uri: Endpoint específico para la petición.

⚐ EJEMPLO URL:

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

Paso Previo: Obtener Valores Padres Disponibles

Antes de agregar un valor hijo, consulta los valores padres disponibles para asociarle el nuevo valor:

Endpoint de consulta:

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

Parámetros de consulta:

Respuesta ejemplo:

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

⚐ Nota: >

• El campo id en la respuesta es el que se debe usar como ParentId al agregar un nuevo valor.

Parámetros de la Petición

Cuerpo de la petición

{
  "Value": "Colombia",
  "ParentId": 2950
}

⚐ Nota: >

• Si no incluyes ParentId, el valor se agregará como un valor raíz sin padre.

Respuesta

Éxito (Status 200)

{
    "result": true
}

Parámetros Response

Mensajes de Error