Stap 1: Verkrijg een beveiligingstoken
Open [Postman] (https://www.postman.com) en maak een nieuw verzoek aan.
Stel het verzoektype in op POST (in het vervolgkeuzemenu links van de URL).
- Voer URL in: https://prod2022.plugnotes.com/Apis/External/GetToken.php
- Voeg in het koptekstgedeelte een sleutel toe: X-API-KEY
- Voer voor de waarde de unieke sleutel in die door Plugnotes is opgegeven
Druk op “Verzenden” om het volgende te verkrijgen:
- teken
-uh
Resultaat uit stap 1:
Zodra het verzoek is verzonden, ziet u dit net onder de door u ingevulde parameters:
Stap 2: De API gebruiken
Maak met behulp van het beveiligingstoken een nieuw POST-verzoek.
- Stel de URL in op: https://prod2022.plugnotes.com/Apis/External/1302_update_pn.php
- Voeg in het koptekstgedeelte een sleutel toe: X-AUTH-TOKEN
- Voor de waarde is dit het token uit het vorige verzoek in “Resultaat uit stap 1”.
1. Je moet dan naar het gedeelte Lichaam gaan en 'onbewerkt' selecteren.
2. Zodra je dat hebt gedaan, moet je de “uh”, “num_pf” (of “pn_hash”) en “modif” invullen:
“uh”: Van het vorige verzoek.
“num_pf”: het nummer van de Plugnote. Verplicht als u de pn_hash niet opgeeft
“pn_hash”: de hash van de Plugnote. Verplicht als u het num_pn niet opgeeft
Let op: De Plugnote die u probeert te updaten moet in de juiste Pf_key staan (Pf_key bepaald bij het bouwen van uw webservice)!
Voor “modif” moet je eerst begrijpen hoe een Plugnote werkt:
Hier is een voorbeeld:
Als het eerste veld bijvoorbeeld een string is, ziet de dataregel er als volgt uit:
{"type": "F", "num": 1, "data": "Dit zijn gegevens"}.
Typ "F" voor strings, "num": 1 voor het veldnummer en data is de string die moet worden ingevoegd.
Voor een tabel zou het type 'T' zijn, maar u moet voor elke cel een kolom- en rijnummer toevoegen:
{"type": "T", "num": 3,"l": 1,"c": 1,"data": "gegevens in de cel in de eerste regel en eerste kolom"}
Typ “T” voor tabel, “num”: 3 voor het veldnummer, “l” (L) is voor het rijnummer, “c” is het kolomnummer en gegevens zijn de string die in de cel moet worden ingevoegd.
Als u een bijlage wilt toevoegen, moet u het volgende gebruiken:
{"type": "A", "name": "mijnbestand.txt", "data"»: "YmxhYmxhYmxhYiBjb3Vjb3U="}
Typ 'A' voor bestanden, 'naam' is de naam van het bestand en 'data' is het bestand in basis 64.
Resultaat uit stap 2
Zodra u de hoofdtekst van het verzoek correct heeft ingevuld, kunt u het verzenden en ontvangt u ongeveer dit:
Resultaat:
- Indien succesvol, ontvangt u een bevestiging.
- Bij een probleem wordt er een foutmelding gegeven.
Opmerking: zorg ervoor dat u elke stap voltooit voordat u doorgaat naar de volgende. Raadpleeg in geval van een probleem het foutbericht voor hulp.
--
Klantsucces
Als je vragen hebt, neem dan contact op met ons Klantsucces Team