---
sourceDocument: Référence API Yokohama
sourceDocumentLink: https://www.servicenow.com/docs/r/fr-FR/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence API Yokohama

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API de pièce jointe

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

* Rversion finale: Yokohama
* 
* Mis à jour 30 janv. 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 18 minutes de lecture

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

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

L'API de pièce jointe respecte toutes les limitations système sur les fichiers chargés, telles que la taille maximale 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 des pièces jointes :


## Pièces jointes Besoins 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 ServiceNow HTTP doit disposer de 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 nécessaires 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 : SUPPRIMER /now/attachment/{sys_id} {#ariaid-title2}

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

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

URL avec version : /api/now/v1/attachment/{sys_id}

URL par défaut : /api/now/attachment/{sys_id}  
Remarque :  
Les versions disponibles sont spécifiées dans [l'explorateur d'API REST](https://www.servicenow.com/docs/dG2Lgt7Ia0fsTVRB2enJ2w "Dans ce tutoriel, vous utiliserez l’explorateur d’API REST pour tester les ServiceNow API REST."). Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le [formulaire Service REST scripté](https://www.servicenow.com/docs/JdvVjM8ffkkIk5XhFcXNwg "La fonctionnalité d’API REST scriptée permet aux développeurs d’applications de créer des API de service Web personnalisées.").

### 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 |
|-|-|
| Aucune |   |
[Tableau 2. Paramètres de requête]

{#attachment-DELETE__entry__10}

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

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent uniquement à cette action HTTP 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://www.servicenow.com/docs/LWqgDZRpj9zEEGdFb5KP_A "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui facilite leur communication entre eux.").
{#attachment-DELETE__entry__14}

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

{#attachment-DELETE__entry__18}

| En-tête | Description |
|-|-|
| Aucune |   |
[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://www.servicenow.com/docs/LWqgDZRpj9zEEGdFb5KP_A "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui facilite leur communication entre eux.").
{#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 s'est 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 |
|-|-|
| Aucune |   |
[ ]

### 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  
Remarque :  
Les versions disponibles sont spécifiées dans [l'explorateur d'API REST](https://www.servicenow.com/docs/dG2Lgt7Ia0fsTVRB2enJ2w "Dans ce tutoriel, vous utiliserez l’explorateur d’API REST pour tester les ServiceNow API REST."). Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le [formulaire Service REST scripté](https://www.servicenow.com/docs/JdvVjM8ffkkIk5XhFcXNwg "La fonctionnalité d’API REST scriptée permet aux développeurs d’applications de créer des API de service Web personnalisées.").

### Paramètres de demande pris en charge

{#attachment-GET__entry__2}

| Nom | Description |
|-|-|
| Aucune |   |
[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` inhabituellement élevées peuvent avoir un impact sur les performances du système. Type de données : chaîne Par défaut : 1000 |
| sysparm_offset | Nombre d'enregistrements à exclure de la requête. Utilisez ce paramètre pour obtenir plus d'enregistrements que spécifié dans le sysparm_limit paramètre. Par exemple, si sysparm_limit est défini sur 500, mais que vous souhaitez interroger des enregistrements supplémentaires, vous pouvez spécifier une sysparm_offset valeur de paramètre 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 fournit une prise en charge de Trier 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 |
|-|-|
| Aucune |   |
[Tableau 9. Paramètres du corps de la demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent uniquement à cette action HTTP 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://www.servicenow.com/docs/LWqgDZRpj9zEEGdFb5KP_A "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui facilite leur communication entre eux.").
{#attachment-GET__entry__18}{#attachment-GET__accept-RESTAPI}

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

{#attachment-GET__entry__22}

| En-tête | Description |
|-|-|
| Type de contenu | 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://www.servicenow.com/docs/LWqgDZRpj9zEEGdFb5KP_A "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui facilite leur communication entre eux.").
{#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é traitée avec succès. |
| 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}/file {#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 avec version : /api/now/v1/attachment/{sys_id}/file

URL par défaut : /api/now/attachment/{sys_id}/file  
Remarque :  
Les versions disponibles sont spécifiées dans [l'explorateur d'API REST](https://www.servicenow.com/docs/dG2Lgt7Ia0fsTVRB2enJ2w "Dans ce tutoriel, vous utiliserez l’explorateur d’API REST pour tester les ServiceNow API REST."). Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le [formulaire Service REST scripté](https://www.servicenow.com/docs/JdvVjM8ffkkIk5XhFcXNwg "La fonctionnalité d’API REST scriptée permet aux développeurs d’applications de créer des API de service Web personnalisées.").

### 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 |
|-|-|
| Aucune |   |
[Tableau 14. Paramètres de requête]

{#attachment-GET-file__entry__10}

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

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent uniquement à cette action HTTP 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://www.servicenow.com/docs/LWqgDZRpj9zEEGdFb5KP_A "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui facilite leur communication entre eux.").
{#attachment-GET-file__entry__14}

| En-tête | Description |
|-|-|
| Accepter | Format des 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 `*/*`. Par défaut : \*/\* |
[Tableau 16. En-têtes de demandes]

{#attachment-GET-file__entry__18}

| En-tête | Description |
|-|-|
| MÉTADONNÉES X-PIÈCES JOINTES | 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://www.servicenow.com/docs/LWqgDZRpj9zEEGdFb5KP_A "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui facilite leur communication entre eux.").
{#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é traitée avec succès. |
| 400 | Demande incorrecte. Un type de demande incorrect ou une demande mal formée 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 de pièce jointe avec une valeur sys_id spécifique.

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

URL avec version : /api/now/v1/attachment/{sys_id}

URL par défaut : /api/now/attachment/{sys_id}  
Remarque :  
Les versions disponibles sont spécifiées dans [l'explorateur d'API REST](https://www.servicenow.com/docs/dG2Lgt7Ia0fsTVRB2enJ2w "Dans ce tutoriel, vous utiliserez l’explorateur d’API REST pour tester les ServiceNow API REST."). Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le [formulaire Service REST scripté](https://www.servicenow.com/docs/JdvVjM8ffkkIk5XhFcXNwg "La fonctionnalité d’API REST scriptée permet aux développeurs d’applications de créer des API de service Web personnalisées.").

### 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 dont les métadonnées doivent être récupérées. |
[Tableau 19. Paramètres de chemin d'accès]

{#attachment-GET-sys_id__entry__6}

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

{#attachment-GET-sys_id__entry__10}

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

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent uniquement à cette action HTTP 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://www.servicenow.com/docs/LWqgDZRpj9zEEGdFb5KP_A "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui facilite leur communication entre eux.").
{#attachment-GET-sys_id__entry__14}{#attachment-GET-sys_id__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format des données du corps de la réponse. Types pris en charge : application/json ou application/xml. 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://www.servicenow.com/docs/LWqgDZRpj9zEEGdFb5KP_A "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui facilite leur communication entre eux.").
{#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é traitée avec succès. |
| 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 dans la liste de paramètres de la demande transmise.

### 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  
Remarque :  
Les versions disponibles sont spécifiées dans [l'explorateur d'API REST](https://www.servicenow.com/docs/dG2Lgt7Ia0fsTVRB2enJ2w "Dans ce tutoriel, vous utiliserez l’explorateur d’API REST pour tester les ServiceNow API REST."). Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le [formulaire Service REST scripté](https://www.servicenow.com/docs/JdvVjM8ffkkIk5XhFcXNwg "La fonctionnalité d’API REST scriptée permet aux développeurs d’applications de créer des API de service Web personnalisées.").

### Paramètres de demande pris en charge

{#attachment-POST-file__entry__2}

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

{#attachment-POST-file__entry__6}

| Nom | Description |
|-|-|
| creation_time | Date et heure de création de la pièce jointe. Utilisez ce paramètre pour capturer les heures de création de pièces jointes lorsque le Application Now Mobile est hors ligne et que la pièce jointe est chargée dans un enregistrement ultérieurement. Type de données : chaîne Par défaut : la date et l'heure actuelles. |
| encryption_context | Sys_id d'un enregistrement de contexte de chiffrement. Spécifiez ce paramètre pour autoriser uniquement les utilisateurs ayant 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 [Field Encryption](https://www.servicenow.com/docs/access?context=field-encryption&version=yokohama&pubname=yokohama-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é avec 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__18}

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

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent uniquement à cette action HTTP 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://www.servicenow.com/docs/LWqgDZRpj9zEEGdFb5KP_A "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui facilite leur communication entre eux.").
{#attachment-POST-file__entry__22}{#attachment-POST-file__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format des données du corps de la réponse. Types pris en charge : application/json ou application/xml. 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 des pièces jointes. |
[Tableau 28. En-têtes de demandes]

{#attachment-POST-file__entry__28}

| 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://www.servicenow.com/docs/LWqgDZRpj9zEEGdFb5KP_A "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui facilite leur communication entre eux.").
{#attachment-POST-file__entry__32}{#attachment-POST-file__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 201 | Indique que la requête s'est 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 le et table_sys_id paramètres 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 en pièce jointe a été compressé. Valeurs possibles : * vrai : 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 de pièce jointe associé, tel que image ou jpeg ou application/x-shockwave-flash. Type de données : chaîne |
| result.created_by_name | Nom complet de l'entité qui a initialement créé le fichier en pièce jointe. 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 de 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 de pièce jointe compressé. Si le fichier n'est pas compressé, vide. Type de données : chaîne Unité : octets |
| result.sys_created_by | Entité qui a créé à l'origine le fichier en pièce jointe. Type de données : chaîne |
| result.sys_created_on | Date et heure auxquelles le fichier en pièce jointe a été initialement enregistré dans l'instance. Type de données : chaîne |
| result.sys_id | Sys_id du fichier en pièce jointe. Type de données : chaîne |
| result.sys_mod_count | Nombre de fois où le fichier de pièce jointe a été modifié (chargé dans 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 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 de pièce jointe 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 : PUBLIER /now/attachment/upload {#ariaid-title7}

Télé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 des sys_id d'enregistrement dans le corps du formulaire. Consultez l'exemple cURL pour un exemple de demande de données en plusieurs parties/de formulaire.  
Important :  
Lorsque vous utilisez POST partitionné, assurez-vous que le contenu du fichier est contenu uniquement dans la partie finale du message. Les parties antérieures ne doivent contenir que des métadonnées telles que le nom de 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  
Remarque :  
Les versions disponibles sont spécifiées dans [l'explorateur d'API REST](https://www.servicenow.com/docs/dG2Lgt7Ia0fsTVRB2enJ2w "Dans ce tutoriel, vous utiliserez l’explorateur d’API REST pour tester les ServiceNow API REST."). Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le [formulaire Service REST scripté](https://www.servicenow.com/docs/JdvVjM8ffkkIk5XhFcXNwg "La fonctionnalité d’API REST scriptée permet aux développeurs d’applications de créer des API de service Web personnalisées.").

### Paramètres de demande pris en charge

{#attachment-POST-upload__entry__2}

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

{#attachment-POST-upload__entry__6}

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

{#attachment-POST-upload__entry__10}

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

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent uniquement à cette action HTTP 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://www.servicenow.com/docs/LWqgDZRpj9zEEGdFb5KP_A "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui facilite leur communication entre eux.").
{#attachment-POST-upload__entry__14}{#attachment-POST-upload__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format des données du corps de la réponse. Types pris en charge : application/json ou application/xml. Par défaut : application/json |
| Type de contenu | Type de contenu de la demande. Définissez cette valeur sur données en plusieurs parties/de formulaire 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://www.servicenow.com/docs/LWqgDZRpj9zEEGdFb5KP_A "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui facilite leur communication entre eux.").
{#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 s'est exécutée avec succès. |
| 400 | Demande incorrecte. Un type de demande incorrect ou une demande mal formée 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 en pièce jointe a été compressé. Valeurs possibles : * vrai : 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 de pièce jointe associé, tel que image ou jpeg ou application/x-shockwave-flash. Type de données : chaîne |
| result.created_by_name | Nom complet de l'entité qui a initialement créé le fichier en pièce jointe. 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 de 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 de pièce jointe compressé. Si le fichier n'est pas compressé, vide. Type de données : chaîne Unité : octets |
| result.sys_created_by | Entité qui a créé à l'origine le fichier en pièce jointe. Type de données : chaîne |
| result.sys_created_on | Date et heure auxquelles le fichier en pièce jointe a été initialement enregistré dans l'instance. Type de données : chaîne |
| result.sys_id | Sys_id du fichier en pièce jointe. Type de données : chaîne |
| result.sys_mod_count | Nombre de fois où le fichier de pièce jointe a été modifié (chargé dans 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 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 de pièce jointe 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 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 chargements partitionnés. Remarque : Le type de contenu doit être défini dans la partie fichier du message POST, et non dans les données du formulaire. Voir l'exemple de message en plusieurs parties POST pour 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"
      }
    }