Van onze partner GrafiStore
Tips en trucs: Zet een Application Programming Interface (API) op.
22 september 2023
Op het gebied van drukwerk Wij delen graag kennis. Kennis waarmee je klanten beter kunt adviseren, de werkefficiëntie kunt verbeteren of kunt inspireren. Deze keer: GrafiStore gaat over het opzetten van een eenvoudige API voor jouw relaties.
Er is een toenemende vraag naar application programming interfaces (API’s) voor de levering van bestellingen. Maar niet iedereen is een programmeur en kan het goed. De volgende uitleg is een leidraad voor iedere beginner.
Wat is een API?
Een API (Application Programming Interface) is een interface tussen applicaties die communicatie mogelijk maakt. Zie het als WhatsApp: je stuurt een bericht, krijgt een reactie dat het is ontvangen, en vervolgens kan de ander reageren. We zullen een eenvoudige API opzetten.
Wat is winst?
De leverende kant kan een taak, bestand, XML of JSON bedienen via een enkele API-aanroep – vergelijkbaar met een enkele applicatie. De afzender ontvangt een antwoord dat de overdracht is gelukt. Een voordeel hiervan is dat het een oplossing is om de stress bij uw medewerkers te verlichten. Vergelijk het met het handmatig openen van e-mails en het downloaden van honderden bestanden via links.
Welke programma’s zijn vereist?
Enfocus PitStop Server beschikt al enkele jaren over een “Switch Core Engine”. Dit is de basisversie van Switch. Je mag er een hebben Download de gratis demo Om het zelf te proberen.
Stap 1: Creëer uw API
Open Switch en maak een nieuwe stream. Ik noem dit de “Printmatters API”.
Sleep het object “Webhook” naar uw canvas en koppel het aan een map. Alles wat binnenkomt, komt in deze map terecht.
Voer de volgende parameters in:
• Naam: “printmatters versie 1”
• Pad: ‘printmatters_v1’
De rest laten we zoals het is.
Stap 2: Test de API
Schakel Flow in en installeer de gratis applicatie “Postman” op uw systeem. Deze kunt u downloaden via: www.postman.com/downloads. Dit is een tool voor het testen van API’s en wordt veel gebruikt door ontwikkelaars. (Foto 2)
1. Maak een nieuw bericht (hiermee worden de gegevens verzonden).
2. Voer deze URL in: http://127.0.0.1:51088/scripting/printmatters_v1
3. Kies “Raw” (onbewerkte gegevens) en geef aan dat u “Tekst” wilt verzenden.
4. Tekst als “Hallo!” Komt dit? Nu compatibel.
Wanneer u op Verzenden klikt, moet Postman { “Status”: True } retourneren en moet er een bestand in de map “Ontvangen” staan. Gefeliciteerd! U heeft zojuist uw eerste API-aanroep gedaan.
verduidelijking:
• Het IP-adres 127.0.0.1 is altijd uw computer, ook wel “localhost” genoemd. Wanneer Postman vanaf een andere computer met uw Switch praat, voert u hier het IP-adres van uw Switch in.
• POST is het tegenovergestelde van GET. GET is als het bekijken van een website: u brengt deze naar uw computer. Een POST doet precies het tegenovergestelde: hij verzendt iets.
Stap 3: Open uw API voor relaties
Het is nu belangrijk om uw relatie te delen. Hiervoor moet het externe IP-adres voor de switch worden ingesteld. Surf bijvoorbeeld naar www.whatismyip.com. Laten we zeggen dat dit 149.143.60.165 is, dan zou de API-URL voor uw relaties moeten zijn: http://149.143.60.165:51088/scripting/printmatters_v1.
Op uw firewall of router moet poort 51088 (of een andere poort) verwijzen naar de computer waarop de switch draait, wat het interne IP-adres is.
Stap 4: Breid de workflow uit
Vanaf dit punt kunnen we de workflow naar wens aanpassen. Bijvoorbeeld het opslaan van bestanden met een tijdstempel en een uniek nummer.
- Voeg een item “Hernoemen” en een map toe.
- Selecteer ‘Vervangen’ voor de eerste actie en kies ‘Act op: volledige bestandsnaam’.
- Kies onder Vervangen door de optie Tekst van één regel met variabele definitie. Voer de volgende waarden in: [Switch. Date:TimeZone=”System”]_UID[Switch. Counter:Id=”3”].kort bericht.
Als je al bestanden in de stream hebt, kun je zien of je het goed doet:
Het resultaat zou het volgende moeten zijn:
Het is voor elke relatie mogelijk om verschillende API-eindpunten te maken en nieuwe versies uit te proberen. Probeer gewoon XML of JSON in te voegen.
“Valt vaak neer. Subtiel charmante tv-liefhebber. Toegewijde internetfan. Muziekbeoefenaar.”