Développeur de signes OneSpan : téléchargez plusieurs documents avec REST

Duo Liang, août 15, 2018

Si vous développez votre application avec OneSpan Sign à l'aide de REST, vous avez très probablement rencontré des messages d'erreur lors de l'envoi de demandes Post/Put. Pour les fins de dépannage, je recommande d'utiliser des outils de surveillance HTTP comme Fiddler ou Charles pour capturer le trafic de réseautage va à OneSpan Sign. Cela permettra de mieux comprendre ce qui se passe.

Dans le blog de cette semaine, je vais télécharger plusieurs documents à une transaction existante comme un exemple pour mieux expliquer ce qu'est une demande HTTP devrait ressembler, ce qu'il faut rechercher dans Fiddler, et comment atteindre cet exemple en utilisant REST avec C .

Commençons !

À quoi ressemble une trace de violon

Voici un instantané tiré de Fiddler:

8-15-1

Pour mieux explorer la question, nous analyserons cette demande en utilisant les quatre points suivants.

Télécharger des documents Point 1:

Si vous téléchargez des documents sur un paquet existant, vous pouvez utiliser les paramètres ci-dessous de l'URL aPI et de l'en-tête de demande dans votre code ou test de facteur :

Demande HTTP

POST /api/packages/packageId/documents

En-têtes HTTP

Accepter: texte/html

Type de contenu : multiparties/form-data

Autorisation: api_key de base

Notez que l'attribut " Accepter " doit être réglé sur "texte/html" plutôt que "application/json".

Télécharger des  documents Point 2:

À partir de la capture d'écran, vous pouvez voir que chaque Content-Disposition est en fait séparée par une limite "--".

Si vous transférez votre PDF dans le flux octet, votre type de contenu doit être réglé sur "application/pdf", ou vous pouvez définir votre type de contenu à "texte/plaine" avec un texte simple à des fins de test.

Il devrait y avoir une nouvelle ligne avant le contenu de votre document.

Si vous devez télécharger plusieurs documents, le nom de la disposition de contenu partage le même que le « fichier ».

Télécharger des  documents Point 3:

La charge utile minimale pour le document doit inclure l'attribut "nom" comme indiqué dans la capture d'écran. Cependant, il est toujours recommandé d'ajouter toutes les approbations et attributs dans votre demande JSON en un seul appel plutôt que de mettre à jour vos documents après le téléchargement.

Pour télécharger plusieurs documents, votre charge utile doit être organisée en tant que telle :

[
   {
    "nom":"document1",
     ....
   },
  {
     "nom":"document2",
     ....
  }
]

Télécharger des documents Point 4:

À la fin, vous devez utiliser "---"frontière"--" pour remplir la demande. Spécialement, il ya deux bashes supplémentaires à la fin.

Téléchargement de plusieurs documents

8-15-2

Ci-dessus est une fonction d'échantillon de CMD pour télécharger plusieurs documents. En lisant le code, vous pouvez voir comment la demande Web est transformée à partir du code et créer votre propre fonction dans votre langage de programmation de développement, en fonction de votre propre logique d'affaires. Pour le code complet, vous pouvez vous référer à ce thread. Si vous avez des questions concernant ce blog ou toute autre chose concernant l’intégration de OneSpan Sign dans votre application, visitez les Forums communautairesdes développeurs.