get https://{subdomain}.kommo.com/api/v4//custom_fields/
Este método permite obter um campo personalizado específico pelo seu ID dentro da conta (leads, empresas, contatos).
Limitações
O método está disponível para todos os usuários da conta.
Cabeçalho de tipo de dado quando a solicitação é bem-sucedida
Content-Type: application/hal+json
Cabeçalho de tipo de dado em caso de erro
Content-Type: application/problem+json
Parâmetros de resposta
O método retorna um array de modelos de campos personalizados. As propriedades do objeto de campo personalizado estão listadas abaixo. As propriedades do objeto variam dependendo da entidade.
| Parâmetro | Tipo de dado | Descrição |
|---|---|---|
| id | int | ID do campo |
| name | string | Nome do campo |
| code | string | Código do campo que pode ser usado para atualizar o valor sem passar o ID do campo na solicitação. |
| sort | int | Ordenação do campo |
| type | int | Tipo de campo |
| entity_type | string | Tipo de campo (leads, contatos, empresas) |
| is_predefined | bool | Define se o campo é predefinido (Este parâmetro é apenas retornado para listas de campos de leads, contatos ou empresas). |
| is_deletable | bool | Define se o campo pode ser excluído (Este parâmetro é apenas retornado para listas de campos de leads, contatos ou empresas). |
| remind | string|null | Configuração de lembretes de aniversário (nunca, dia - dia antes do evento, semana - semana antes do evento, mês - mês antes do evento) – Este valor está disponível apenas para campos do tipo aniversário. (Este parâmetro é apenas retornado para listas de campos de leads, contatos ou empresas). |
| enums | array|null | Array de valores disponíveis para campos com valores enumerados. |
| enums[0] | object | Modelo de valor disponível. |
| enums[0][id] | int | ID do valor |
| enums[0][value] | string | Valor |
| enums[0][sort] | int | Ordenação de valores. |
| is_api_only | bool | Define se o campo é editável apenas via API (apenas para leads, contatos ou empresas). |
| group_id | string|null | ID do grupo de campos ao qual pertence (Este parâmetro é apenas retornado para listas de campos de leads, contatos ou empresas). |
| required_statuses | array|null | Array de campos obrigatórios para mudança de status de lead (apenas para leads, contatos ou empresas). |
| required_statuses[0] | object | Modelo de campo obrigatório (apenas para leads, contatos ou empresas). |
| required_statuses[0][status_id] | int | ID do estágio que exige um valor no campo antes de mover o lead (Este parâmetro é apenas retornado para listas de campos de leads, contatos ou empresas). |
| required_statuses[0][pipeline_id] | int | ID do pipeline que exige um valor no campo antes de mover o lead (Este parâmetro é apenas retornado para listas de campos de leads, contatos ou empresas). |