API de anexos

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 17 min. de leitura
  • . Anexo A API fornece endpoints que permitem carregar e consultar anexos de arquivo.

    Você pode carregar ou recuperar um único arquivo com cada solicitação.

    . Anexo A API respeita todas as limitações do sistema em arquivos carregados, como tamanho máximo de arquivo e tipos de anexo permitidos. Você pode controlar essas configurações usando as propriedades com.glide.attachment.max_size1024 MB por padrão, e. glide.attachment.extensions.

    Nota:
    . Anexo A API aceita todos os valores de Content-Type (*/*). Especifique o tipo de conteúdo do arquivo ao carregar um anexo. O tipo de conteúdo é armazenado com metadados de arquivo, permitindo que outras ferramentas identifiquem e analisem corretamente o arquivo.

    O vídeo a seguir fornece mais informações sobre Anexo API:

    Requisitos de função da API de anexo

    Para criar anexos, o registro do usuário usado para autenticar a solicitação HTTP com ServiceNow Todas as funções necessárias para criar registros de Anexo [sys_attachment]. Ele também deve ter todas as funções necessárias para ler e gravar registros na tabela de destino, como a função itil para adicionar anexos a registros de incidentes.

    Por padrão, não há uma função única que permita que um usuário adicione anexos. Você pode criar uma função para permitir explicitamente a adição de anexos e atribuir essa função à conta de usuário que está sendo usada para fazer a solicitação.

    Anexo - EXCLUA /now/attachment/

    Este método exclui o anexo com um valor sys_id específico.

    Formato de URL

    URL com controle de versão: /api/now/v1/attachment/

    URL padrão: /api/now/attachment/

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 1. Parâmetros de caminho
    Nome Descrição
    sys_id Valor sys_id do anexo a ser excluído.

    Tipo de dados: Cadeia de caracteres

    Tabela 2. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 3. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    Nenhum(a)

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 4. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Nenhum(a)
    Tabela 5. Cabeçalhos de resposta
    Cabeçalho Descrição
    Nenhum(a)

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 6. Códigos de status
    Código do status Descrição
    204 Indica que a solicitação foi executada com sucesso.
    401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
    404 Não encontrado. O item solicitado não foi encontrado.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Nome Descrição
    Nenhum(a)

    Solicitação de curl

    curl "https://instance.servicenow.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5" \
    --request DELETE \
    --user 'username':'password'
    
    ""

    Anexo - OBTER /now/attachment

    Retorna os metadados de vários anexos.

    Formato de URL

    URL com controle de versão: api/now/v1/attachment

    URL padrão: api/now/anexo

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 7. Parâmetros de caminho
    Nome Descrição
    Nenhum(a)
    Tabela 8. Parâmetros de consulta
    Nome Descrição
    sysparm_limit Limite a ser aplicado na paginação.
    Nota:
    Incomum grande sysparm_limit os valores podem afetar o desempenho do sistema.

    Tipo de dados: Cadeia de caracteres

    Padrão: 1000

    sysparm_offset Número de registros a serem excluídos da consulta. Use este parâmetro para obter mais registros do que o especificado em sysparm_limitparâmetro. Por exemplo, se sysparm_limitestá definido como 500, mas há registros adicionais que você deseja consultar, você pode especificar um sysparm_offsetvalor do parâmetro de 500 para obter o segundo conjunto de registros.

    Tipo de dados: Cadeia de caracteres

    Padrão: 0

    sysparm_query Consulta codificada. Consultas para Anexo As APIs são relativas à tabela Anexos [sys_attachment].

    Por exemplo: (sysparm_query=file_name=attachment.doc)

    A consulta codificada fornece suporte para ordenar por . Para classificar respostas com base em determinados campos, use ORDERBY e. ORDERBYDESC cláusulas em sysparm_query. Por exemplo, Se você não tiver certeza de que o arquivo está sendo executado ordena os resultados em ordem crescente pelo nome primeiro e, em seguida, em ordem decrescente pelo nome da tabela.

    Tipo de dados: Cadeia de caracteres

    Tabela 9. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    Nenhum(a)

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 10. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json

    Tabela 11. Cabeçalhos de resposta
    Cabeçalho Descrição
    Tipo de conteúdo Tipo de conteúdo da resposta. Para solicitações de metadados, este é o tipo de conteúdo dos metadados, não o tipo de conteúdo dos arquivos de anexo.
    Link Links para baixar os anexos.

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 12. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Nome Descrição
    As informações retornadas dependem dos anexos selecionados.

    Solicitação de curl

    curl "https://instance.servicenow.com/api/now/attachment?sysparm_limit=1" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      "result": [
        {
          "table_sys_id": "5054b6f8c0a800060056addcf551ecf8",
          "size_bytes": "462",
          "download_link": "https://instance.service-now.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5/file",
          "sys_updated_on": "2009-05-21 04:12:21",
          "sys_id": "615ea769c0a80166001cf5f2367302f5",
          "image_height": "",
          "sys_created_on": "2009-05-21 04:12:21",
          "file_name": "blocks.swf",
          "sys_created_by": "glide.maint",
          "compressed": "true",
          "average_image_color": "",
          "sys_updated_by": "glide.maint",
          "sys_tags": "",
          "table_name": "content_block_programmatic",
          "image_width": "",
          "sys_mod_count": "0",
          "content_type": "application/x-shockwave-flash",
          "size_compressed": "485"
        }
      ]
    }

    Anexo - OBTÉM /now/attachment//file

    Retorna o anexo de arquivo binário com um valor sys_id específico.

    Formato de URL

    URL com controle de versão: /api/now/v1/attachment/sys_id/file

    URL padrão: /api/now/attachment/sys_id/file

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 13. Parâmetros de caminho
    Nome Descrição
    sys_id Sys_id do registro de anexo do qual retornar dados binários.
    Tabela 14. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 15. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    Nenhum(a)

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 16. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Por exemplo, use imagem/jpeg ou imagem/png Para aceitar arquivos de imagem JPEG ou PNG exclusivamente. Para permitir todos os tipos de imagem, especifique imagem/* ; para permitir qualquer tipo de arquivo, especifique */* .

    Padrão: */*

    Tabela 17. Cabeçalhos de resposta
    Cabeçalho Descrição
    X-Attachment-Metadados Metadados sobre o arquivo retornado, como tamanho, nome e tipo de arquivo.

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 18. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    400 Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
    401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Nome Descrição
    Anexo de arquivo binário

    Solicitação de curl

    curl "https://instance.servicenow.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5/file" \
    --request GET \
    --header "Accept:*/*" \
    --user "username":"password"
    Binary response not shown.

    Anexo - OBTER /now/attachment/

    Retorna os metadados do arquivo de anexo com um valor sys_id específico.

    Formato de URL

    URL com controle de versão: /api/now/v1/attachment/

    URL padrão: /api/now/attachment/

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 19. Parâmetros de caminho
    Nome Descrição
    sys_id Sys_id do registro de anexo cujos metadados serão recuperados.
    Tabela 20. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 21. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    Nenhum(a)

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 22. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json

    Tabela 23. Cabeçalhos de resposta
    Cabeçalho Descrição
    Tipo de conteúdo O tipo de conteúdo da resposta. Para solicitações de metadados, este é o tipo de conteúdo dos metadados, não o tipo de conteúdo dos arquivos de anexo.

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 24. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
    404 Indica que o anexo especificado não existe ou que o usuário atual não pode acessá-lo.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Nome Descrição
    Metadados específicos do anexo especificado.

    Solicitação de curl

    curl "https://instance.servicenow.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    {
      "result": {
        "table_sys_id": "5054b6f8c0a800060056addcf551ecf8",
        "size_bytes": "462",
        "download_link": "https://instance.service-now.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5/file",
        "sys_updated_on": "2009-05-21 04:12:21",
        "sys_id": "615ea769c0a80166001cf5f2367302f5",
        "image_height": "",
        "sys_created_on": "2009-05-21 04:12:21",
        "file_name": "blocks.swf",
        "sys_created_by": "glide.maint",
        "compressed": "true",
        "average_image_color": "",
        "sys_updated_by": "glide.maint",
        "sys_tags": "",
        "table_name": "content_block_programmatic",
        "image_width": "",
        "sys_mod_count": "0",
        "content_type": "application/x-shockwave-flash",
        "size_compressed": "485"
      }
    }

    POST /now/attachment/file

    Carrega um arquivo binário especificado como um anexo para um registro especificado.

    Nota:
    O arquivo a ser anexado deve ser especificado após o último parâmetro na lista de parâmetros de solicitação aprovados.

    Formato de URL

    URL com controle de versão: /api/now/v1/attachment/file

    URL padrão: /api/now/attachment/file

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 25. Parâmetros de caminho
    Nome Descrição
    Nenhum(a)
    Tabela 26. Parâmetros de consulta
    Nome Descrição
    creation_time Data e hora de criação do anexo.

    Use este parâmetro para capturar os horários de criação de anexo quando App Now Mobile está off-line e o anexo é carregado em um registro posteriormente.

    Tipo de dados: Cadeia de caracteres

    Data e hora atuais.

    encryption_context Sys_id de um registro de contexto de criptografia. Especifique este parâmetro para permitir que somente usuários com o contexto de criptografia especificado acessem o anexo. Para obter informações adicionais sobre registros de contexto de criptografia, consulte Field Encryption.

    Tipo de dados: Cadeia de caracteres

    Padrão: O arquivo é criptografado usando contexto de criptografia acessível ao usuário, caso contrário, o arquivo anexado não será criptografado com nenhum contexto de criptografia.

    file_name Obrigatório. Nome a ser fornecido ao anexo.

    Tipo de dados: Cadeia de caracteres

    table_name Obrigatório. Nome da tabela à qual anexar o arquivo.

    Tipo de dados: Cadeia de caracteres

    table_sys_id Obrigatório. Sys_id do registro na tabela especificada em table_nameao qual você deseja anexar o arquivo.

    Tipo de dados: Cadeia de caracteres

    Tabela 27. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    <String> Caminho para o arquivo binário a ser anexado ao registro especificado.

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 28. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json

    Tipo de conteúdo Tipo de conteúdo do arquivo a ser anexado, como image/jpeg ou */*. Este cabeçalho é obrigatório para publicar anexos de arquivo.
    Tabela 29. Cabeçalhos de resposta
    Cabeçalho Descrição
    Local URL do novo anexo.

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 30. Códigos de status
    Código do status Descrição
    201 Indica que a consulta foi executada com sucesso.
    400 Indica que um ou mais parâmetros obrigatórios estavam ausentes na solicitação.
    404 Indica o registro especificado pelo table_namee. table_sys_idos parâmetros não existem ou não estão acessíveis para o usuário atual.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Elemento Descrição
    resultado Metadados do anexo solicitado.

    Tipo de dados: Objeto

    "result": {
      "average_image_color": "String",
      "compressed": "String", 
      "content_type": "String",
      "created_by_name": "String",
      "download_link": "String",
      "file_name": "String",
      "image_height": "String",
      "image_width": "String",
      "size_bytes": "String",
      "size_compressed": "String",
      "sys_created_by": "String",
      "sys_created_on": "String",
      "sys_id": "String",
      "sys_mod_count": "String",
      "sys_tags": "String",
      "sys_updated_by": "String",
      "sys_updated_on": "String",
      "table_name": "String",
      "table_sys_id": "String",
      "updated_by_name": "String"
    }
    average_image_color Se o anexo for uma imagem, a soma de todas as cores.

    Tipo de dados: Cadeia de caracteres

    RGB ou número de pixels.

    result.compressed Sinalizador que indica se o arquivo de anexo foi compactado.
    Valores possíveis:
    • Verdadeiro: O arquivo foi compactado.
    • Falso: O arquivo não foi compactado.

    Tipo de dados: Cadeia de caracteres

    result.content_type Content-type do arquivo de anexo associado, como image ou jpeg ou application/x-shockwave-flash.

    Tipo de dados: Cadeia de caracteres

    created_by_name Nome completo da entidade que criou originalmente o arquivo de anexo.

    Tipo de dados: Cadeia de caracteres

    resultado.download_link URL de download do anexo no ServiceNow instância.

    Tipo de dados: Cadeia de caracteres

    result.file_name Nome do arquivo do anexo.

    Tipo de dados: Cadeia de caracteres

    result.image_height Se for um arquivo de imagem, a altura da imagem.

    Tipo de dados: Cadeia de caracteres

    Unidade: Pixels

    result.image_width Se for um arquivo de imagem, a largura da imagem.

    Tipo de dados: Cadeia de caracteres

    Unidade: Pixels

    result.size_bytes Tamanho do anexo.

    Tipo de dados: Cadeia de caracteres

    Unidade: Bytes

    resultado.size_compacted Tamanho do arquivo de anexo compactado. Se o arquivo não estiver compactado, vazio.

    Tipo de dados: Cadeia de caracteres

    Unidade: Bytes

    resultado.sys_created_by Entidade que criou originalmente o arquivo de anexo.

    Tipo de dados: Cadeia de caracteres

    resultado.sys_created_on Data e hora em que o arquivo de anexo foi salvo inicialmente na instância.

    Tipo de dados: Cadeia de caracteres

    sys_id.result.sys_id Sys_id do arquivo de anexo.

    Tipo de dados: Cadeia de caracteres

    resultado.sys_mod_count Número de vezes que o arquivo de anexo foi modificado (carregado na instância).

    Tipo de dados: Cadeia de caracteres

    result.sys_tags Marcadores do sistema associados ao arquivo de anexo.

    Tipo de dados: Cadeia de caracteres

    resultado.sys_updated_by Entidade que atualizou o arquivo de anexo pela última vez.

    Tipo de dados: Cadeia de caracteres

    resultado.sys_updated_on Data e hora em que o arquivo de anexo foi atualizado pela última vez.

    Tipo de dados: Cadeia de caracteres

    result.table_name Nome da tabela à qual o anexo está associado.

    Tipo de dados: Cadeia de caracteres

    result.table_sys_id Sys_id da tabela associada ao anexo.

    Tipo de dados: Cadeia de caracteres

    result.updated_by_name Nome completo da entidade que atualizou o arquivo de anexo pela última vez.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    curl "https://instance.servicenow.com/api/now/attachment/file?table_name=incident&table_sys_id=d71f7935c0a8016700802b64c67c11c6&file_name=Issue_screenshot" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type: image/jpeg" \
    --user "username":"password" \
    --data-binary "@ location of the file on file system"
    {
      "result": {
        "table_sys_id": "d71f7935c0a8016700802b64c67c11c6",
        "size_bytes": "36597",
        "download_link": "https://instance.servicenow.com/api/now/attachment/6ea10fe64f411200adf9f8e18110c739/file",
        "sys_updated_on": "2016-01-22 15:14:07",
        "sys_id": "6ea10fe64f411200adf9f8e18110c739",
        "image_height": "",
        "sys_created_on": "2016-01-22 15:14:07",
        "file_name": "Issue_screenshot",
        "sys_created_by": "admin",
        "compressed": "true",
        "average_image_color": "",
        "sys_updated_by": "admin",
        "sys_tags": "",
        "table_name": "incident",
        "image_width": "",
        "sys_mod_count": "0",
        "content_type": "image/jpeg",
        "size_compressed": "25130"
      }
    }

    Anexo - PUBLICAR /now/attachment/upload

    Carrega um anexo de arquivo de várias partes.

    O método POST DE várias partes não aceita parâmetros. Você deve especificar o nome da tabela e os valores sys_id do registro no corpo do formulário. Consulte o exemplo de cURL para obter uma amostra de uma solicitação multipart/form-data.

    Importante:
    Ao usar POST DE várias partes, certifique-se de que o conteúdo do arquivo esteja contido somente na parte final da mensagem. Peças anteriores devem conter somente metadados, como nome da tabela e sys_id do registro.

    Formato de URL

    URL com controle de versão: /api/now/v1/attachment/upload

    URL padrão: /api/now/attachment/upload

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 31. Parâmetros de caminho
    Nome Descrição
    Nenhum(a)
    Tabela 32. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 33. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    Nenhum(a)

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 34. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json

    Tipo de conteúdo Tipo de conteúdo da solicitação. Defina este valor como multipart/form-data ao usar o método POST multipart.
    Tabela 35. Cabeçalhos de resposta
    Cabeçalho Descrição
    Local URL do novo anexo.

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 36. Códigos de status
    Código do status Descrição
    201 Indica que a consulta foi executada com sucesso.
    400 Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
    401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
    404 Não encontrado. O item solicitado não foi encontrado.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Elemento Descrição
    resultado Metadados do anexo solicitado.

    Tipo de dados: Objeto

    "result": {
      "average_image_color": "String",
      "compressed": "String", 
      "content_type": "String",
      "created_by_name": "String",
      "download_link": "String",
      "file_name": "String",
      "image_height": "String",
      "image_width": "String",
      "size_bytes": "String",
      "size_compressed": "String",
      "sys_created_by": "String",
      "sys_created_on": "String",
      "sys_id": "String",
      "sys_mod_count": "String",
      "sys_tags": "String",
      "sys_updated_by": "String",
      "sys_updated_on": "String",
      "table_name": "String",
      "table_sys_id": "String",
      "updated_by_name": "String"
    }
    average_image_color Se o anexo for uma imagem, a soma de todas as cores.

    Tipo de dados: Cadeia de caracteres

    RGB ou número de pixels.

    result.compressed Sinalizador que indica se o arquivo de anexo foi compactado.
    Valores possíveis:
    • Verdadeiro: O arquivo foi compactado.
    • Falso: O arquivo não foi compactado.

    Tipo de dados: Cadeia de caracteres

    result.content_type Content-type do arquivo de anexo associado, como image ou jpeg ou application/x-shockwave-flash.

    Tipo de dados: Cadeia de caracteres

    created_by_name Nome completo da entidade que criou originalmente o arquivo de anexo.

    Tipo de dados: Cadeia de caracteres

    resultado.download_link URL de download do anexo no ServiceNow instância.

    Tipo de dados: Cadeia de caracteres

    result.file_name Nome do arquivo do anexo.

    Tipo de dados: Cadeia de caracteres

    result.image_height Se for um arquivo de imagem, a altura da imagem.

    Tipo de dados: Cadeia de caracteres

    Unidade: Pixels

    result.image_width Se for um arquivo de imagem, a largura da imagem.

    Tipo de dados: Cadeia de caracteres

    Unidade: Pixels

    result.size_bytes Tamanho do anexo.

    Tipo de dados: Cadeia de caracteres

    Unidade: Bytes

    resultado.size_compacted Tamanho do arquivo de anexo compactado. Se o arquivo não estiver compactado, vazio.

    Tipo de dados: Cadeia de caracteres

    Unidade: Bytes

    resultado.sys_created_by Entidade que criou originalmente o arquivo de anexo.

    Tipo de dados: Cadeia de caracteres

    resultado.sys_created_on Data e hora em que o arquivo de anexo foi salvo inicialmente na instância.

    Tipo de dados: Cadeia de caracteres

    sys_id.result.sys_id Sys_id do arquivo de anexo.

    Tipo de dados: Cadeia de caracteres

    resultado.sys_mod_count Número de vezes que o arquivo de anexo foi modificado (carregado na instância).

    Tipo de dados: Cadeia de caracteres

    result.sys_tags Marcadores do sistema associados ao arquivo de anexo.

    Tipo de dados: Cadeia de caracteres

    resultado.sys_updated_by Entidade que atualizou o arquivo de anexo pela última vez.

    Tipo de dados: Cadeia de caracteres

    resultado.sys_updated_on Data e hora em que o arquivo de anexo foi atualizado pela última vez.

    Tipo de dados: Cadeia de caracteres

    result.table_name Nome da tabela à qual o anexo está associado.

    Tipo de dados: Cadeia de caracteres

    result.table_sys_id Sys_id da tabela associada ao anexo.

    Tipo de dados: Cadeia de caracteres

    result.updated_by_name Nome completo da entidade que atualizou o arquivo de anexo pela última vez.

    Tipo de dados: Cadeia de caracteres

    PUBLICAR valores obrigatórios de várias partes

    Ao enviar uma solicitação POST DE várias partes para carregar um anexo de arquivo, inclua os dados do anexo no corpo da mensagem, não nos parâmetros de URL. Você deve especificar estes valores no corpo da mensagem:
    Tabela 37. Valores obrigatórios
    Valor Descrição
    Tipo de conteúdo Content-Type do arquivo, incluído no corpo da mensagem para carregamentos de várias partes.
    Nota:
    O Content-Type deve ser definido na parte do arquivo da mensagem POST, não nos dados do formulário. Consulte o exemplo de mensagem de várias partes POST para obter um exemplo de uma mensagem de várias partes.

    Tipo de dados: Cadeia de caracteres

    table_name Nome da tabela à qual você deseja anexar o arquivo.

    Tipo de dados: Cadeia de caracteres

    table_sys_id Sys_id do registro na tabela especificada à qual você deseja anexar o arquivo.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    curl "https://instance.servicenow.com/api/now/attachment/upload" \
    --request POST \
    --header "Accept:application/json"\
    --user "username":"password"\
    --header "Content-Type:multipart/form-data"\
     -F 'table_name=incident' \
     -F 'table_sys_id=d71f7935c0a8016700802b64c67c11c6'\
     -F 'uploadFile=@ location of the file on file system'
    \
    {
      "result": {
        "table_sys_id": "d71f7935c0a8016700802b64c67c11c6",
        "size_bytes": "36597",
        "download_link": "https://instance.service-now.com/api/now/attachment/994adbc64f511200adf9f8e18110c796/file",
        "sys_updated_on": "2016-02-02 14:00:21",
        "sys_id": "994adbc64f511200adf9f8e18110c796",
        "image_height": "",
        "sys_created_on": "2016-02-02 14:00:21",
        "file_name": "banner-CS0001345_v1_1.jpeg",
        "sys_created_by": "admin",
        "compressed": "true",
        "average_image_color": "",
        "sys_updated_by": "admin",
        "sys_tags": "",
        "table_name": "incident",
        "image_width": "",
        "sys_mod_count": "0",
        "content_type": "image/jpeg",
        "size_compressed": "25130"
      }
    }