---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API de pièce jointe

# API de pièce jointe {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 17 minutes de lecture

L'API de pièces jointes fournit des points de terminaison qui vous permettent de charger et d'interroger des pièces jointes.

Vous pouvez charger ou récupérer un seul fichier à chaque demande.

L'API Attachment respecte toutes les limitations du système sur les fichiers chargés, telles que la taille maximale du fichier et les types de pièces jointes autorisés. Vous pouvez contrôler ces paramètres à l'aide des propriétés com.glide.attachment.max_size, 1024 Mo par défaut, et glide.attachment.extensions.  
Remarque :  
L'API de pièce jointe accepte toutes les valeurs de type de contenu (\*/\*). Spécifiez le type de contenu du fichier lors du chargement d'une pièce jointe. Le type de contenu est stocké avec les métadonnées du fichier, ce qui permet à d'autres outils d'identifier et d'analyser correctement le fichier.

La vidéo suivante fournit plus d'informations sur l'API de pièce jointe :


## Pièces jointes Exigences du rôle API {#c_AttachmentAPI__section_tby_gn1_xhb}

Pour créer des pièces jointes, l'enregistrement utilisateur utilisé pour authentifier la requête HTTP avec ServiceNow doit avoir tous les rôles requis pour créer des enregistrements de pièce jointe \[sys_attachment\]. Il doit également disposer de tous les rôles requis pour lire et écrire des enregistrements sur la table cible, tels que le rôle itil pour ajouter des pièces jointes aux enregistrements d'incidents.

Par défaut, il n'existe pas de rôle unique permettant à un utilisateur d'ajouter des pièces jointes. Vous pouvez créer un rôle pour autoriser explicitement l'ajout de pièces jointes, puis affecter ce rôle au compte d'utilisateur utilisé pour effectuer la demande.

## Pièce jointe : DELETE /now/attachment/{sys_id} {#ariaid-title2}

Cette méthode supprime la pièce jointe associée à une valeur sys_id spécifique.

### Format d'URL {#attachment-DELETE__section_xl1_kft_2mb}

URL versionnée : /api/now/v1/attachment/{sys_id}

URL par défaut : /api/now/attachment/{sys_id}

### Paramètres de demande pris en charge

{#attachment-DELETE__entry__2}

| Nom | Description |
|-|-|
| sys_id | Sys_id valeur de la pièce jointe à supprimer. Type de données : chaîne |
[Tableau 1. Paramètres de chemin d'accès]

{#attachment-DELETE__entry__6}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 2. Paramètres de requête]

{#attachment-DELETE__entry__10}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 3. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#attachment-DELETE__entry__14}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 4. En-têtes de demandes]

{#attachment-DELETE__entry__18}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 5. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#attachment-DELETE__entry__22}{#attachment-DELETE__entry-401-status-code}{#attachment-DELETE__entry-404-status-code}{#attachment-DELETE__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 204 | Indique que la demande a été exécutée avec succès. |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 404 | Introuvable. L'élément demandé est introuvable. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 6. Codes d'état]

### Paramètres du corps de réponse (JSON ou XML)

{#attachment-DELETE__entry__32}

| Nom | Description |
|-|-|
| Aucun |   |
[ ]

### Demande cURL

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

    ""

## Pièce jointe : GET /now/attachment {#ariaid-title3}

Renvoie les métadonnées pour plusieurs pièces jointes.

### Format d'URL {#attachment-GET__section_efx_gw4_dmb}

URL versionnée : api/now/v1/attachment

URL par défaut : api/now/attachment

### Paramètres de demande pris en charge

{#attachment-GET__entry__2}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 7. Paramètres de chemin d'accès]

{#attachment-GET__entry__6}{#attachment-GET__row_sysparm_offset}

| Nom | Description |
|-|-|
| sysparm_limit | Limite à appliquer à la pagination. Remarque : Des valeurs `de sysparm_limit` anormalement élevées peuvent avoir un impact sur les performances du système. Type de données : chaîne Par défaut : 1 000 |
| sysparm_offset | Nombre d'enregistrements à exclure de la requête. Utilisez ce paramètre pour obtenir plus d'enregistrements que ce qui est spécifié dans `sysparm_limit`. Par exemple, si `sysparm_limit` est définie sur 500, mais qu'il existe des enregistrements supplémentaires que vous souhaitez interroger, vous pouvez spécifier une valeur `sysparm_offset` de 500 pour obtenir le deuxième ensemble d'enregistrements. Type de données : chaîne Par défaut : 0 |
| sysparm_query | Requête codée. Les requêtes de l'API de pièce jointe sont relatives à la table Pièces jointes \[sys_attachment\]. Par exemple : (sysparm_query=file_name=attachment.doc) La requête codée prend en charge le tri par. Pour trier les réponses en fonction de certains champs, utilisez les clauses ORDERBY et ORDERBYDESC dans sysparm_query. Par exemple, `sysparm_query=ORDERBYfile_name^ORDERBYDESCtable_Name` trie les résultats par ordre croissant par nom d'abord, puis par ordre décroissant par nom de table. Type de données : chaîne |
[Tableau 8. Paramètres de requête]

{#attachment-GET__entry__14}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 9. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#attachment-GET__entry__18}{#attachment-GET__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 10. En-têtes de demandes]

{#attachment-GET__entry__22}

| En-tête | Description |
|-|-|
| Type de contenu | Le type de contenu de la réponse. Pour les demandes de métadonnées, il s'agit du type de contenu des métadonnées, et non du type de contenu des fichiers en pièce jointe. |
| Lien | Liens pour télécharger les pièces jointes. |
[Tableau 11. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#attachment-GET__entry__28}{#attachment-GET__entry-200-status-code}{#attachment-GET__entry-401-status-code}{#attachment-GET__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 12. Codes d'état]

### Paramètres du corps de réponse (JSON ou XML)

{#attachment-GET__entry__36}

| Nom | Description |
|-|-|
| Les informations renvoyées dépendent des pièces jointes sélectionnées. |   |
[ ]

### Demande 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"
        }
      ]
    }

## Pièce jointe : GET /now/attachment/{sys_id}/fichier {#ariaid-title4}

Renvoie la pièce jointe du fichier binaire avec une valeur sys_id spécifique.

### Format d'URL {#attachment-GET-file__section_apn_ybk_2mb}

URL versionnée : /api/now/v1/attachment/{sys_id}/file

URL par défaut : /api/now/attachment/{sys_id}/file

### Paramètres de demande pris en charge

{#attachment-GET-file__entry__2}

| Nom | Description |
|-|-|
| sys_id | Sys_id de l'enregistrement de pièce jointe à partir duquel renvoyer des données binaires. |
[Tableau 13. Paramètres de chemin d'accès]

{#attachment-GET-file__entry__6}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 14. Paramètres de requête]

{#attachment-GET-file__entry__10}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 15. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#attachment-GET-file__entry__14}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Par exemple, utilisez `image/jpeg` ou `image/png` pour accepter exclusivement les fichiers image JPEG ou PNG. Pour autoriser tous les types d'images, spécifiez `image/*` ; Pour autoriser n'importe quel type de fichier, `spécifiez */*`. Faire défaut:\*/\* |
[Tableau 16. En-têtes de demandes]

{#attachment-GET-file__entry__18}

| En-tête | Description |
|-|-|
| X-Attachment-Metadata (Pièce jointe X) | Métadonnées sur le fichier renvoyé, telles que la taille, le nom et le type de fichier. |
[Tableau 17. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#attachment-GET-file__entry__22}{#attachment-GET-file__entry-200-status-code}{#attachment-GET-file__entry-400-status-code}{#attachment-GET-file__entry-401-status-code}{#attachment-GET-file__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 18. Codes d'état]

### Paramètres du corps de réponse (JSON ou XML)

{#attachment-GET-file__entry__32}

| Nom | Description |
|-|-|
| Pièce jointe de fichier binaire |   |
[ ]

### Demande cURL

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

    Binary response not shown.

## Pièce jointe : GET /now/attachment/{sys_id} {#ariaid-title5}

Renvoie les métadonnées du fichier joint avec une valeur de sys_id spécifique.

### Format d'URL {#attachment-GET-sys_id__section_wmy_pyj_2mb}

URL versionnée : /api/now/v1/attachment/{sys_id}

URL par défaut : /api/now/attachment/{sys_id}

### Paramètres de demande pris en charge

{#attachment-GET-sys_id__entry__2}

| Nom | Description |
|-|-|
| sys_id | Sys_id de l'enregistrement de pièce jointe pour lequel récupérer les métadonnées. |
[Tableau 19. Paramètres de chemin d'accès]

{#attachment-GET-sys_id__entry__6}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 20. Paramètres de requête]

{#attachment-GET-sys_id__entry__10}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 21. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#attachment-GET-sys_id__entry__14}{#attachment-GET-sys_id__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 22. En-têtes de demandes]

{#attachment-GET-sys_id__entry__18}

| En-tête | Description |
|-|-|
| Type de contenu | Le type de contenu de la réponse. Pour les demandes de métadonnées, il s'agit du type de contenu des métadonnées, et non du type de contenu des fichiers en pièce jointe. |
[Tableau 23. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#attachment-GET-sys_id__entry__22}{#attachment-GET-sys_id__entry-200-status-code}{#attachment-GET-sys_id__entry-401-status-code}{#attachment-GET-sys_id__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 404 | Indique que la pièce jointe spécifiée n'existe pas ou que l'utilisateur actuel ne peut pas y accéder. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 24. Codes d'état]

### Paramètres du corps de réponse (JSON ou XML)

{#attachment-GET-sys_id__entry__32}

| Nom | Description |
|-|-|
| Métadonnées spécifiques à la pièce jointe spécifiée. |   |
[ ]

### Demande 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"
      }
    }

## Pièce jointe : POST /now/attachment/file {#ariaid-title6}

Charge un fichier binaire spécifié en tant que pièce jointe à un enregistrement spécifié.
Remarque :  
Le fichier à joindre doit être spécifié après le dernier paramètre de la liste des paramètres de demande transmis.

### Format d'URL {#attachment-POST-file__section_phs_45s_2mb}

URL versionnée : /api/now/v1/attachment/file

URL par défaut : /api/now/attachment/file

### Paramètres de demande pris en charge

{#attachment-POST-file__entry__2}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 25. Paramètres de chemin d'accès]

{#attachment-POST-file__entry__6}

| Nom | Description |
|-|-|
| encryption_context | Sys_id d'un enregistrement de contexte de chiffrement. Spécifiez ce paramètre pour autoriser uniquement les utilisateurs avec le contexte de chiffrement spécifié à accéder à la pièce jointe. Pour plus d'informations sur les enregistrements de contexte de chiffrement, reportez-vous à la section [Column Level Encryption](https://www.servicenow.com/docs/access?context=column-level-encryption-landing&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). Type de données : chaîne Par défaut : le fichier est chiffré à l'aide d'un contexte de chiffrement accessible à l'utilisateur, sinon le fichier joint n'est chiffré à l'aide d'aucun contexte de chiffrement. |
| file_name | Requis. Nom à donner à la pièce jointe. Type de données : chaîne |
| table_name | Requis. Nom de la table à laquelle joindre le fichier. Type de données : chaîne |
| table_sys_id | Requis. Sys_id de l'enregistrement dans la table spécifiée dans table_name laquelle vous souhaitez joindre le fichier. Type de données : chaîne |
[Tableau 26. Paramètres de requête]

{#attachment-POST-file__entry__16}

| Nom | Description |
|-|-|
| \<chaîne\> | Chemin d'accès au fichier binaire à joindre à l'enregistrement spécifié. |
[Tableau 27. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#attachment-POST-file__entry__20}{#attachment-POST-file__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
| Type de contenu | Type de contenu du fichier à joindre, tel que image/jpeg ou \*/\*. Cet en-tête est obligatoire pour publier les pièces jointes. |
[Tableau 28. En-têtes de demandes]

{#attachment-POST-file__entry__26}

| En-tête | Description |
|-|-|
| Emplacement | URL de la nouvelle pièce jointe. |
[Tableau 29. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#attachment-POST-file__entry__30}{#attachment-POST-file__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 201 | Indique que la requête a été exécutée avec succès. |
| 400 | Indique qu'un ou plusieurs paramètres obligatoires étaient manquants dans la demande. |
| 404 | Indique que l'enregistrement spécifié par les paramètres and table_sys_id n'existe table_name pas ou n'est pas accessible à l'utilisateur actuel. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 30. Codes d'état]

### Paramètres du corps de réponse (JSON ou XML)

{#attachment-POST-file__table_kbr_qck_llb__entry__2}

| Élément | Description |
|-|-|
| résultat | Métadonnées de la pièce jointe demandée. Type de données : objet "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" } |
| result.average_image_color | Si la pièce jointe est une image, la somme de toutes les couleurs. Type de données : chaîne Unité : RVB ou nombre de pixels. |
| résultat.compressé | Marqueur indiquant si le fichier joint a été compressé. Valeurs valides : * true : le fichier a été compressé. * faux : le fichier n'a pas été compressé. {#attachment-POST-file__ul_ev1_fmk_jlb} Type de données : chaîne |
| result.content_type | Type de contenu du fichier joint associé, par exemple image, jpeg ou application/x-shockwave-flash. Type de données : chaîne |
| result.created_by_name | Nom complet de l'entité qui a créé le fichier joint à l'origine. Type de données : chaîne |
| result.download_link | URL de téléchargement de la pièce jointe sur l'instance ServiceNow . Type de données : chaîne |
| result.file_name | Nom du fichier de la pièce jointe. Type de données : chaîne |
| result.image_height | S'il s'agit d'un fichier image, la hauteur de l'image. Type de données : chaîne Unité : Pixels |
| result.image_width | S'il s'agit d'un fichier image, la largeur de l'image. Type de données : chaîne Unité : Pixels |
| result.size_bytes | Taille de la pièce jointe. Type de données : chaîne Unité : octets |
| result.size_compressed | Taille du fichier compressé en pièce jointe. Si le fichier n'est pas compressé, vide. Type de données : chaîne Unité : octets |
| result.sys_created_by | Entité qui a créé le fichier de pièce jointe à l'origine. Type de données : chaîne |
| result.sys_created_on | Date et heure auxquelles le fichier de pièce jointe a été initialement enregistré dans l'instance. Type de données : chaîne |
| result.sys_id | Sys_id du fichier joint. Type de données : chaîne |
| result.sys_mod_count | Nombre de fois où le fichier joint a été modifié (chargé sur l'instance). Type de données : chaîne |
| result.sys_balises | Toutes les balises système associées au fichier en pièce jointe. Type de données : chaîne |
| result.sys_updated_by | Entité qui a mis à jour le fichier de pièce jointe pour la dernière fois. Type de données : chaîne |
| result.sys_updated_on | Date et heure de la dernière mise à jour du fichier en pièce jointe. Type de données : chaîne |
| result.table_name | Nom de la table à laquelle la pièce jointe est associée. Type de données : chaîne |
| result.table_sys_id | Sys_id de la table associée à la pièce jointe. Type de données : chaîne |
| result.updated_by_name | Nom complet de l'entité qui a mis à jour le fichier joint pour la dernière fois. Type de données : chaîne |
[ ]

{#attachment-POST-file__table_kbr_qck_llb}  

### Demande 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"
      }
    }

## Pièce jointe : POST /now/attachment/upload {#ariaid-title7}

Charge une pièce jointe de fichier partitionné.
La méthode POST en plusieurs parties n'accepte aucun paramètre. Vous devez spécifier le nom de la table et les valeurs sys_id enregistrement dans le corps du formulaire. Consultez l'exemple cURL pour obtenir un exemple de requête en plusieurs parties/form-data.  
Important :  
Lors de l'auto-test de démarrage (POST) en plusieurs parties, assurez-vous que le contenu du fichier ne figure que dans la partie finale du message. Les parties antérieures doivent contenir uniquement des métadonnées telles que le nom de la table et le sys_id d'enregistrement.

### Format d'URL {#attachment-POST-upload__section_jby_v2t_2mb}

URL versionnée : /api/now/v1/attachment/upload

URL par défaut : /api/now/attachment/upload

### Paramètres de demande pris en charge

{#attachment-POST-upload__entry__2}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 31. Paramètres de chemin d'accès]

{#attachment-POST-upload__entry__6}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 32. Paramètres de requête]

{#attachment-POST-upload__entry__10}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 33. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#attachment-POST-upload__entry__14}{#attachment-POST-upload__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
| Type de contenu | Type de contenu de la demande. Définissez cette valeur sur multipart/form-data lors de l'utilisation de la méthode POST en plusieurs parties. |
[Tableau 34. En-têtes de demandes]

{#attachment-POST-upload__entry__20}

| En-tête | Description |
|-|-|
| Emplacement | URL de la nouvelle pièce jointe. |
[Tableau 35. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#attachment-POST-upload__entry__24}{#attachment-POST-upload__entry-400-status-code}{#attachment-POST-upload__entry-401-status-code}{#attachment-POST-upload__entry-404-status-code}{#attachment-POST-upload__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 201 | Indique que la requête a été exécutée avec succès. |
| 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 404 | Introuvable. L'élément demandé est introuvable. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 36. Codes d'état]

### Paramètres du corps de réponse (JSON ou XML)

{#attachment-POST-upload__table_bbj_pfk_llb__entry__2}

| Élément | Description |
|-|-|
| résultat | Métadonnées de la pièce jointe demandée. Type de données : objet "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" } |
| result.average_image_color | Si la pièce jointe est une image, la somme de toutes les couleurs. Type de données : chaîne Unité : RVB ou nombre de pixels. |
| résultat.compressé | Marqueur indiquant si le fichier joint a été compressé. Valeurs valides : * true : le fichier a été compressé. * faux : le fichier n'a pas été compressé. {#attachment-POST-upload__ul_ev1_fmk_jlb} Type de données : chaîne |
| result.content_type | Type de contenu du fichier joint associé, par exemple image, jpeg ou application/x-shockwave-flash. Type de données : chaîne |
| result.created_by_name | Nom complet de l'entité qui a créé le fichier joint à l'origine. Type de données : chaîne |
| result.download_link | URL de téléchargement de la pièce jointe sur l'instance ServiceNow . Type de données : chaîne |
| result.file_name | Nom du fichier de la pièce jointe. Type de données : chaîne |
| result.image_height | S'il s'agit d'un fichier image, la hauteur de l'image. Type de données : chaîne Unité : Pixels |
| result.image_width | S'il s'agit d'un fichier image, la largeur de l'image. Type de données : chaîne Unité : Pixels |
| result.size_bytes | Taille de la pièce jointe. Type de données : chaîne Unité : octets |
| result.size_compressed | Taille du fichier compressé en pièce jointe. Si le fichier n'est pas compressé, vide. Type de données : chaîne Unité : octets |
| result.sys_created_by | Entité qui a créé le fichier de pièce jointe à l'origine. Type de données : chaîne |
| result.sys_created_on | Date et heure auxquelles le fichier de pièce jointe a été initialement enregistré dans l'instance. Type de données : chaîne |
| result.sys_id | Sys_id du fichier joint. Type de données : chaîne |
| result.sys_mod_count | Nombre de fois où le fichier joint a été modifié (chargé sur l'instance). Type de données : chaîne |
| result.sys_balises | Toutes les balises système associées au fichier en pièce jointe. Type de données : chaîne |
| result.sys_updated_by | Entité qui a mis à jour le fichier de pièce jointe pour la dernière fois. Type de données : chaîne |
| result.sys_updated_on | Date et heure de la dernière mise à jour du fichier en pièce jointe. Type de données : chaîne |
| result.table_name | Nom de la table à laquelle la pièce jointe est associée. Type de données : chaîne |
| result.table_sys_id | Sys_id de la table associée à la pièce jointe. Type de données : chaîne |
| result.updated_by_name | Nom complet de l'entité qui a mis à jour le fichier joint pour la dernière fois. Type de données : chaîne |
[ ]

{#attachment-POST-upload__table_bbj_pfk_llb}

### PUBLIER les valeurs obligatoires en plusieurs parties {#attachment-POST-upload__section_tk4_1ft_2mb}

Lors de l'envoi d'une demande POST en plusieurs parties pour charger une pièce jointe, incluez les données de la pièce jointe dans le corps du message, et non dans les paramètres d'URL. Vous devez spécifier ces valeurs dans le corps du message :{#attachment-POST-upload__table_p1v_nnj_js__entry__2}

| Valeur | Description |
|-|-|
| Type de contenu | Type de contenu du fichier, inclus dans le corps du message pour les téléchargements en plusieurs parties. Remarque : Le type de contenu doit être défini dans la partie fichier du message POST, et non dans les données du formulaire. Consultez l'exemple de message en plusieurs parties POST pour obtenir un exemple de message en plusieurs parties. Type de données : chaîne |
| table_name | Nom de la table à laquelle vous souhaitez joindre le fichier. Type de données : chaîne |
| table_sys_id | Sys_id de l'enregistrement sur la table spécifiée à laquelle vous souhaitez joindre le fichier. Type de données : chaîne |
[Tableau 37. Valeurs obligatoires]

{#attachment-POST-upload__table_p1v_nnj_js}  

### Demande 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"
      }
    }