Mijn acclaro (preview)

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst	Class	Regions
Copilot Studio	Premium	Alle Power Automate-regio's , met uitzondering van het volgende:      - Amerikaanse overheid (GCC)      - Amerikaanse overheid (GCC High)      - China Cloud beheerd door 21Vianet      - Us Department of Defense (DoD)
Logic-apps	Standaard	Alle Logic Apps-regio's , met uitzondering van het volgende:      - Azure Government-regio's      - Azure China-regio's      - Us Department of Defense (DoD)
Power Apps	Premium	Alle Power Apps-regio's , met uitzondering van het volgende:      - Amerikaanse overheid (GCC)      - Amerikaanse overheid (GCC High)      - China Cloud beheerd door 21Vianet      - Us Department of Defense (DoD)
Power Automate	Premium	Alle Power Automate-regio's , met uitzondering van het volgende:      - Amerikaanse overheid (GCC)      - Amerikaanse overheid (GCC High)      - China Cloud beheerd door 21Vianet      - Us Department of Defense (DoD)

Contactpersoon
Naam	Ondersteuning voor Mijn acclaro
URL	https://www.acclaro.com/support/
E-mailen	support@acclaro.com

Connectormetagegevens
Uitgever	Acclaro Inc.
Webpagina	https://www.acclaro.com/
Privacybeleid	https://www.acclaro.com/privacy-policy/
Categorieën	Samenwerking; Inhoud en bestanden

De Acclaro-webservice-API is een uitbreidbare set RESTful-interfaces waarmee klanten en partners automatisch vertaalactiviteiten kunnen beheren met Acclaro, zoals bestandsoverdrachten, het maken van bestellingen, kwaliteitsclassificaties en statusrapportage. Wanneer de API wordt gebruikt, kan broninhoud die zich in commerciële of aangepaste ontwikkelde inhoudsbeheersystemen bevindt, programmatisch worden verzonden voor vertaling, vervolgens ontvangen en gepubliceerd. Alle vragen of feedback met betrekking tot de Acclaro-API kunnen worden omgeleid naar support@acclaro.com.

Vereiste voorwaarden

U moet een gebruikersnaam en wachtwoord opgeven voor My Acclaro. Als u de referenties wilt aanvragen, neemt u contact op support@acclaro.com of gaat u hierheen.

Zodra u bent ingesteld, meldt u zich aan bij de portal en haalt u uw API-sleutel (een bearer-token) op.

Referenties ophalen

Tokens genereren

De Acclaro-API maakt gebruik van JSON-webtokens (javascript object notation) voor verificatie. Als u geldige API-tokens wilt genereren, kunnen Acclaro-klanten de onderstaande stappen volgen:

Neem rechtstreeks contact op met uw Acclaro-verkoop- of bedrijfsontwikkelingsvertegenwoordiger met uw aanvraag voor een API-token OF stuur een e-mailaanvraag naar portal@acclaro.com

Zodra uw aanvraag is goedgekeurd, ontvangt u aanmeldingsreferenties voor de klantportal 'Mijn Acclaro', waar u toegang hebt tot de functie 'Webtoken genereren' op de pagina Accountinstellingen. Als u uw API-integratie wilt ontwikkelen en testen met de My Acclaro (Sandbox)-API, kan uw sandbox-webtoken worden gebruikt met de URL van het sandbox-eindpunt, maar is deze niet uitwisselbaar met productie-eindpunten.

Nadat u een webtoken hebt gegenereerd, ziet u een tekenreeks van ongeveer 100 tekens, die kan worden gemarkeerd en gekopieerd naar een lokaal klembord.

Tokens presenteren met aanvragen

Elke API-aanvraag moet een geldig token presenteren. Dit wordt in de HTTP-header 'Authorization' geplaatst met het 'Bearer'-schema.

Tokenintrekking

Als er ooit bezorgdheid optreedt dat een token is gecompromitteerd, hetzij via digitale diefstal of via onbedoelde openbare blootstelling, kunnen tokens worden ingetrokken en uniek opnieuw worden gegenereerd op de pagina Instellingen van de klantportal 'Mijn acclaro'.

Details van token-implementatie

Het token is een RFC 7519-compatibel JSON-webtoken met:

Header

• alg: HS256
• typ: JWT

Payload

• sub: acclaro-username
• iat: tijdstempel

Handtekening - HMACSHA256 handtekening van eerste twee secties

De tijdstempel van het probleem wordt gebruikt in de intrekkingslijst en zorgt ervoor dat elk token uniek is. De enige ondersteunde versleutelingsmethode is HS256. Pogingen om andere versleutelingsmethoden, zoals NONE, te gebruiken, mislukken.

Aan de slag met uw connector

Service-URL-eindpunten

De Acclaro-API is een RESTful-interface, die zich bevindt op:

• Productie: https://my.acclaro.com/api/v2
• Zandbak: https://apisandbox.acclaro.com/api/v2

Argumenten voor API-functies worden doorgegeven als standaardwebparameters, die mogelijk URL-gecodeerd zijn als de functie wordt geopend met een GET, bijvoorbeeld: https://api.acclaro.com/api/v2/orders?status=new

Argumenten kunnen ook worden gecodeerd in een POST-hoofdtekst bij het gebruik van multipart-/formuliergegevens, meestal wanneer een bestand dat moet worden vertaald, wordt verzonden.

Retourwaarden zijn JSON-gecodeerd in het HTTP-antwoord. Elke geretourneerde record bevat een veld dat wordt ingesteld true op als de aanroep is geslaagd of false als deze mislukt. Bij een fout zijn er twee extra velden in de record: errorCode is een geheel getal met waarden, zoals verderop in dit document wordt weergegeven en errorMessage een tekenreeks is waarin de fout wordt uitgelegd. Bij succes hebben veel aanroepen een veldgegevens die verwijst naar geretourneerde gegevens.

Houd er rekening mee dat de twee aanroepen /orders/{orderid}/quote-document en /orders/{orderid}/files/{fileid} de bestandsgegevens in het antwoord retourneren in plaats van JSON-gegevens. U kunt onderscheid maken tussen een foutreactie van JSON-gegevens of een geslaagde reactie van bestandsgegevens door het mime-type te controleren of als de gegevens beginnen met "success":.

Interactieve testconsole

In de My Acclaro-portal is er een interactieve testconsole die hier toegankelijk is.

Met deze console kunnen ontwikkelaars de API-functionaliteit uitproberen en de uitvoer van de aanroepen bekijken. Het is handig voor snelle tests van API-voorbeeldwerkstromen, waaronder het maken van orders, het bijvoegen van bestanden en het verzenden voor vertaling.

Samenvattingen van order- en bestandsstatus

Orders kunnen de volgende statussen hebben:

• nieuwe – order wordt gemaakt door API-gebruiker
• offerte verkrijgen – offerte wordt gegenereerd door Acclaro
• goedkeuring nodig – offerte is beschikbaar voor klantbeoordeling
• ter voorbereiding – de bestelling is ingediend bij Acclaro en het werk is gestart
• wordt uitgevoerd – bestelling is ontvangen door Acclaro
• ter beoordeling: initiële vertalingen zijn geleverd door Acclaro en wachten op feedback van klanten voordat definitieve vertalingen worden geleverd of feedback van klanten is verstrekt en Acclaro definitieve vertalingen voorbereidt voor levering
• voltooid: alle definitieve vertaalde bestanden in een bestelling zijn gereed voor het ophalen van API-gebruikers
• geannuleerd: bestelling en alle bijbehorende bestanden zijn geannuleerd door Acclaro op verzoek van API-gebruiker

Bronbestanden kunnen de volgende statussen hebben:

• nieuw – bestand is bijgevoegd bij een bestelling die nog niet is ingediend
• offerte verkrijgen – offerte wordt gegenereerd door Acclaro
• wordt uitgevoerd – het bestand is ontvangen door Acclaro als onderdeel van een bestelling
• preview: een actieve versie van het vertaalde bestand is gereed voor het ophalen van API-gebruikers; editors en proofreaders kunnen feedback bekijken en delen voor aanvullende verbeteringen in bestandsomzetting
• complete – vertaald bestand is gereed voor het ophalen van API-gebruikers
• geannuleerd: bestand is geannuleerd door Acclaro op verzoek van API-gebruiker

Doelbestanden kunnen de volgende status hebben:

• complete – vertaald bestand is gereed voor het ophalen van API-gebruikers

Terugbelverzoeken

Een API-gebruiker kan aanvragen om callbacks te ontvangen wanneer de gegevens worden gewijzigd. Gebruik de aanroep POST /orders/{orderid}/files/{fileid}/callback om op de hoogte te worden gesteld wanneer een bestand wordt gewijzigd, of POST /orders/{orderid}/callback om op de hoogte te worden gesteld wanneer een order wordt gewijzigd. Wijzigingen die een callback kunnen activeren, zijn onder andere het bewerken van de kenmerken van een order, het verzenden van een order, het toevoegen van een opmerking aan een order, een statuswijziging in een order, een voltooide versie van een bestand die wordt weergegeven, het toevoegen van een opmerking aan een bestand of het wijzigen van de status van een bestand.

Elk van deze API-aanroepen bevat een URL als argument. Acclaro voert een HTTP GET-bewerking uit op de opgegeven URL wanneer het opgegeven object wordt gewijzigd. Als uw toepassing een bepaald id-nummer moet worden doorgegeven om deze callback correct te interpreteren, moet u deze opnemen in uw URL, bijvoorbeeld https://www.company.com/admin/plugins/acclaro/filecallback.php?oid=12345.

Acclaro batcheert de verzending van callbacks, dus er kan een vertraging zijn van enkele minuten tussen het wijzigen van het object en de melding van de klant. Om veiligheidsredenen raden we aan dat uw toepassing bij het ontvangen van een callback de database moet controleren om te zien dat er naar een geldig object is verwezen en vervolgens de huidige status van dat object ophalen uit Acclaro met GET /orders/{orderid}/files-info of GET-order/{orderid}. Op deze manier veroorzaken ongeldige of extra callbacks geen problemen.

Uw script dat de callback ontvangt, moet een geslaagde HTTP-antwoordcode retourneren in de reeks 200. Als er een andere antwoordcode wordt geretourneerd, gaan we ervan uit dat u de callback niet hebt verwerkt en herhaal deze een paar minuten later opnieuw. Als u mislukte antwoorden blijft retourneren, zullen we het meerdere keren opnieuw proberen voordat u het opgeeft. Als u geen callbacks meer wilt ontvangen, kunt u DELETE /orders/{orderid}/files/{fileid}/callback of DELETE /orders/{orderid}/callback gebruiken.

Met de callback-functionaliteit van de Acclaro-API kunnen integratiepartners end-to-end geautomatiseerde vertaalwerkstromen bouwen die voltooide vertalingen identificeren en ophalen zodra ze beschikbaar zijn. Met de kracht van callbacks zijn er ook enkele risico's en aanbevolen procedures voor coderen die moeten worden gevolgd om optimale efficiëntie te garanderen voor zowel de verzendende als ontvangende systemen. Pogingen om orders of bestanden te wijzigen als reactie op callbacks die aangeven dat er wijzigingen zijn opgetreden, kunnen bijvoorbeeld runaway-lussen maken. Als u vragen hebt over callbacks of hulp bij peer review voor uw integratiecode wilt, kunt u uw vragen en relevante codefragmenten portal@acclaro.com naar uw Acclaro-klantvertegenwoordiger sturen of contact opnemen met uw Acclaro-klantvertegenwoordiger.

E-mailmeldingen

Net als bij callbacks ondersteunt de API ook e-mailmeldingen op vergelijkbare wijze met de volgende aanroepen: POST /orders/{orderid}/files/{fileid}/email, POST /orders/{orderid}/callback, DELETE /orders/{orderid}/files/{fileid}/email en DELETE /orders/{orderid}/email. Dezelfde acties die een webaanroep zouden activeren, activeren ook dat deze e-mailberichten worden verzonden.

De e-mailmeldingen zijn bedoeld om te worden gelezen door een persoon in plaats van een programma, maar volgen wel een consistente opmaakstijl en bevatten koppelingen naar de mijn acclaro-webportal. Deze e-mailberichten zijn gericht op ontwikkelaars, maar kunnen worden gedeeld met collega's die geen ontwikkelaar zijn als ze geïnteresseerd zijn in het ontvangen van meldingen wanneer relevante volgorde- en bestandsstatussen veranderen. Zie de bezorgingsopties in de Mijn Acclaro-portal of gebruik een web-callback om een script aan te roepen om uw beschrijvende e-mail te verzenden voor meer klantvriendelijke e-mailberichten.

Einddatums

De einddatum in de Acclaro-API wordt opgegeven in ISO8601 indeling. Als u bijvoorbeeld '2016-09-22' gebruikt, kiest u het huidige tijdstip van de dag op 22 september. Als u '2016-09-22T11:22' gebruikt, kiest u 11:22 uur op die datum, in de standaardtijdzone voor het portalgebruikersaccount waarvan het webtoken wordt gebruikt voor verificatie. Als u wilt opgeven met een volledige tijdzoneoverweging, kan een indeling zoals '2016-09-22T11:22:00-06:00' worden gebruikt, wat 6 uur vóór GMT (United States Central Time) aangeeft.

Gegevenssynchronisatie

Het Acclaro-vertaalbeheerplatform synchroniseert de gegevens met de Acclaro-API regelmatig gedurende elke dag. Wanneer u de API-functies in uw toepassing gebruikt, kan het handig zijn om tijdbuffers te overwegen om de nauwkeurigheid van de gegevensrapportage te garanderen. Het kan bijvoorbeeld 15 minuten of langer duren voordat de status van een zojuist ingediende bestelling 'wordt uitgevoerd' wordt weergegeven. Als de API na een uur de status rapporteert die niet aan de verwachtingen voldoet, neemt u contact op portal@acclaro.com om het probleem te melden.

Foutcodes

Wanneer een API-functie niet normaal is voltooid, heeft de geretourneerde record succes = 0 en wordt errorCode ingesteld op een van de onderstaande waarden. Daarnaast heeft errorMessage een tekenreeks die mogelijk specifieker is over het probleem dat is opgetreden.

• Autorisatie ontbreekt. Er is geen webtoken gevonden in de aanvraag.
• Ongeldige autorisatie: er is een webtoken opgegeven, maar heeft geen cryptografische controles doorstaan of verwijst naar een account zonder de juiste machtigingen.
• Onjuiste argumenten: u hebt geen vereist argument opgegeven voor de API-aanroep of aanvullende onverwachte argumenten doorgegeven.
• Databasefout: er is een databasefout opgetreden tijdens het verwerken van de API-aanroep. Hoewel het systeem waarschijnlijk al systeembeheerders van Acclaro heeft gewaarschuwd, laat het ons dan weten als u deze fout herhaaldelijk ziet.
• Machtiging geweigerd: u hebt geprobeerd een actie uit te voeren op een object waartoe u geen toegang hebt.
• Bestand bestaat: u hebt geprobeerd een bestand te verzenden met een naam die conflicteert met een ander bestand in de volgorde.
• Plunet-communicatiefout: de API-laag kan niet communiceren met het interne beheersysteem van Acclaro. Hoewel het systeem waarschijnlijk al systeembeheerders van Acclaro heeft gewaarschuwd, laat het ons dan weten als u deze fout herhaaldelijk ziet.
• Geen dergelijke volgorde - u hebt geprobeerd een aanroep uit te voeren op een bestelling die niet bestaat.
• Kan niet verwijderen: u hebt geprobeerd een bestelling of bestand te verwijderen nadat het werk is gestart. Neem contact op met uw Acclaro-projectmanager om een annulering van werk in uitvoering aan te vragen.
• Kan niet bijwerken: u hebt geprobeerd een order of bestand te wijzigen nadat het werk is gestart. Neem contact op met uw Acclaro-projectmanager om een annulering van werk in uitvoering aan te vragen.
• Ongeldige taal: u hebt een bron- of doeltaal opgegeven die niet wordt ondersteund door Acclaro.
• Geen dergelijk bestand - u hebt geprobeerd een aanroep uit te voeren op een bestand dat niet bestaat.
• Ongeldige datum: de opgegeven datum/tijd kan niet worden geparseerd.
• Geen dergelijke callback- we konden de opgegeven callback niet vinden.
• Slechte levering: er is een niet-ondersteunde leveringswaarde gegeven
• Geen simulatie: de aanroepen van de simulatie-API zijn niet ingeschakeld
• Te groot - het ingediende bestand is te groot om te worden verwerkt.

Bekende problemen en beperkingen

• De maximale hoeveelheid resultaten per pagina is 50. Het wordt aanbevolen om die query's te pagineren die naar verwachting meer dan 50 resultaten opleveren.
• De maximale hoeveelheid aanvragen per minuut die voor elk IP-adres is toegestaan, is 180; neem contact op met de ondersteuning als dit een beperking voor u veroorzaakt.

Veelvoorkomende fouten en oplossingen

Een bestelling maken en deze niet verzenden:

Wanneer een order wordt gemaakt, blijft de order open voor het geval de gebruiker meer items wil toevoegen of meer tijd nodig heeft om de order te voltooien. Zodra de bestelling is voltooid, moet de gebruiker de order voor vertaling "indienen".

Het is gebruikelijk om deze stap te missen wanneer de API handmatig wordt uitgevoerd via opdrachten of handmatige stappen.

Acclaro neemt standaard geen actie op een order die niet is ingediend. Als u de order om welke reden dan ook niet kunt indienen via de API of de gebruikersinterface, neemt u contact op met uw toegewezen Program Manager of het ondersteuningsteam op: support@acclaro.com

Datumnotatie

De API werkt met ISO8601 datumnotatie, bijvoorbeeld '2022-01-21T16:24:00-05:00', maar datums, worden uitgevoerd als tekenreeksen in het JSON-antwoord. Als u de notatie van tekenreeks naar datum wilt converteren, kunt u deze formule formatDateTime({anyMyAcclaroDateField},'g')gebruiken. Velden die datums bevatten, zijn created, modified, due_date. requested_due_date

Als u een einddatum wilt instellen vanuit een ander hulpprogramma, bijvoorbeeld MS Forms, moet u deze opmaken in ISO8601 met dezelfde formule die hierboven wordt weergegeven.

Veelgestelde vragen

1. Biedt Acclaro een faseringsomgeving om de API te testen?

Acclaro biedt een sandbox-API-omgeving waarnaar u API-aanvragen kunt indienen. Voor toegang tot deze omgeving kunt u het eindpunt wijzigen in 'apisandbox.acclaro.com' en een Bearer-token voor deze omgeving dienovereenkomstig verkrijgen. Als u wilt teruggaan naar het productie-eindpunt, moet u overschakelen naar 'my.acclaro.com'.

2. Worden er kosten in rekening gebracht voor het gebruik van de My Acclaro-portal?

Nee, Acclaro-kosten voor de services die zijn aangevraagd via de portal My Acclaro, maar het gebruik van de portal en de BIJBEHORENDE API is gratis voor alle Acclaro-klanten.

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:

standaard	Parameters voor het maken van verbinding.	Alle regio's	Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam	Typologie	Description	Verplicht
API-sleutel	beveiligde string	De API-sleutel voor deze API	Klopt

Beperkingslimieten

Name	Aanroepen	Verlengingsperiode
API-aanroepen per verbinding	100	60 seconden

Acties

Accountgegevens ophalen	Retourneert profielgegevens over het API-gebruikersaccount dat wordt gebruikt.
Alle bestellingen ophalen	Retourneert alle orders die zijn toegewezen aan de huidige gebruiker, als een matrix met orderrecords. Houd er rekening mee dat oudere voltooide orders kunnen worden gearchiveerd en verwijderd uit het actieve systeem. Kan worden gefilterd met de status.
Alle ondersteunde ordertypen ophalen	Retourneert alle ordertypen die beschikbaar zijn voor het account als een matrix van ordertypen, elk ordertype dat bestaat uit een naam en een vlag 'standaard' die nul of één is, waarmee wordt aangegeven welk ordertype wordt ingesteld wanneer er geen is opgegeven.
Bestandsgegevens ophalen	Haalt informatie over het opgegeven bestand op.
Bron- en doeltaal toevoegen aan de volgorde	Voor orders met 0 bronbestanden op het moment van indiening kan deze aanroep worden gebruikt om het systeem te laten weten welke talen vereist zijn voor deze bestelling. Kan alleen worden gebruikt voor nieuwe orders die niet zijn ingediend of die geen offertes hebben ontvangen. Aanvragen van al bekende talen worden genegeerd.
De bestandsgegevens van een bestelling ophalen	Retourneert informatie over alle bestanden in de volgorde.
Een beoordelings-URL voor een bestand toevoegen	Voegt een URL toe aan een bestand, zodat er mogelijk naar wordt verwezen in contextbeoordeling op het web. Hierbij wordt ervan uitgegaan dat de URL openbaar beschikbaar is of dat de vertaler persoonlijke toegangsreferenties heeft om de inhoud weer te geven. Voor bronbestanden kan deze URL vertalers helpen bij het begrijpen van de initiële context en indelingsbeperkingen van de inhoud. Voor doelbestanden kan deze URL vertalers, editors en testers helpen met verificatiewerkstromen om ervoor te zorgen dat vertaalde inhoud wordt weergegeven zoals verwacht op de doelwebpagina's.
Een bestand beoordelen	Verzendt beoordelingsinformatie over bestanden. Classificatieschaal is 1-5, waarbij 1 slechte kwaliteit is en 5 perfecte kwaliteit zijn. Controleer teksttekenreeksen zijn optioneel en kunnen worden opgenomen om de redenering voor de classificatie uit te leggen, zoals geïdentificeerde fouten of gebieden van classificaties voor vertaalverbetering.
Een bestand ophalen	Retourneert de inhoud van een eerder verzonden bestand. Dit is een van de weinige bewerkingen die geen JSON-gegevens retourneren, in plaats daarvan rechtstreeks de bestandsinhoud retourneren. Als er een fout optreedt tijdens het verwerken van de aanvraag, zijn de JSON-gegevens van het antwoord, dus het type antwoord moet altijd worden gecontroleerd.
Een bestand uit de order verwijderen	Hiermee verwijdert u het opgegeven bestand uit de bestelling voordat een bestelling wordt verzonden. Als een bronbestand ooit moet worden geannuleerd nadat het is verzonden als onderdeel van een order, kan 'CANCEL FILE' worden ingediend als opmerking in /orders/{orderid}/files/{fileid}/comment. We vragen ook dat u afzonderlijk contact op neemt met uw Acclaro-projectmanager met de aanvraag voor het annuleren van het bronbestand.
Een bestelling bewerken	Hiermee wordt een order bijgewerkt en wordt de nieuwe record geretourneerd. Nadat een order is gemaakt en de status 'nieuw' heeft, kan de functie alleen worden gebruikt om naam- en leveringskenmerken te wijzigen. Argumenten zijn hetzelfde als beschreven in create order(/orders). Hoewel duedate, levering, estwordcount en type optioneel zijn, moet u ervoor zorgen dat u de vorige waarden van deze waarden indient als u deze niet wilt wijzigen, anders worden ze opnieuw ingesteld op standaardwaarden.
Een bestelling ophalen	Retourneert ordergegevens op basis van de opgegeven id.
Een bestelling verwijderen	Hiermee verwijdert u een order voor de huidige gebruiker met de opgegeven id, als de order de status 'nieuw' heeft en de huidige gebruiker over de juiste accountbevoegdheden beschikt.
Een bronbestand verzenden	Voegt een bestand toe aan een order, waarbij de bestandsnaam en het mime-type worden opgehaald uit de metagegevens van het bestand. Als er geen order-id wordt opgegeven, wordt automatisch een nieuwe order gemaakt. De brontaal moet een van de taalcodes zijn die zijn verkregen uit /info/talen. Targetlangs kunnen één taalcode of verschillende taalcodes zijn in een door komma's gescheiden lijst. Codering is optioneel en wordt standaard ingesteld op UTF-8 als deze niet is opgegeven. ClientRef is een optionele waarde die zinvol is voor de API-gebruiker die doorgaans wordt gebruikt voor inkoopordernummers, maar kan worden gebruikt voor relevante informatie; indien opgegeven wanneer het bestand wordt geladen, wordt het in alle toekomstige aanroepen over dit bestand geretourneerd. Als een bestandsnaam wordt opgegeven waarmee de naam van een ander bestand in deze volgorde wordt gedupliceerd, wordt het systeem uniek door extra tekens toe te voegen (d.w.z. "documentation.docx" kan worden "documentation-2.docx"). De metagegevens van het geretourneerde bestand bevatten zowel de oorspronkelijk opgegeven bestandsnaam als de mogelijk gewijzigde naam die Acclaro gebruikt. De grootte van afzonderlijke bestanden is beperkt tot maximaal 100 MB. De API is bestandneutraal, omdat er geen beperkingen voor bestandstypen zijn. XLIFF-bestanden zijn een algemene industriestandaard voor vertalingen en worden volledig ondersteund. In voortgangsorders kunnen nieuwe extra bestanden aan deze bestanden toevoegen zolang de bron- en doeltalen overeenkomen met de bestanden van de oorspronkelijke bestelling. Voor continue programmatische orders wordt aanbevolen dat de /orders/{orderid}/bestanden worden gebruikt om orders samen te stellen met bronbestanden voordat ze worden verzonden via de aanroep SubmitOrder, omdat dit het meest efficiënte pad is voor Acclaro-vertaalservices om orders met meerdere bestanden te ontvangen en vervolgens volgende vertaalbestanden te retourneren. Als clients specifieke map- en bestandsstructuren voor hun bronbestanden willen onderhouden, kunnen ze zip-bestanden uploaden die worden geretourneerd met vertalingen in de gewenste map en bestandsstructuren binnen zip-bestanden van de doellevering.
Een callback toevoegen voor orderreeksupdates	Vraag of Acclaro de opgegeven URL aanroept wanneer de ordertekenreeks op een willekeurige manier wordt gewijzigd. De callback bevat een string_id queryparameter, die kan worden gebruikt om tekenreeksdetails op te halen.
Een callback toevoegen voor orderupdates	Vraag of Acclaro de opgegeven URL aanroept wanneer de order op welke manier dan ook verandert. Als uw code alleen betrekking heeft op bepaalde wijzigingen, zoals de status die 'voltooid' wordt, moet u de ordergegevens ophalen en daar op controleren.
Een callback verwijderen die is toegevoegd aan bestelling	Vraag of Acclaro de opgegeven URL niet meer aanroept wanneer de order op welke manier dan ook verandert.
Een callback verwijderen die is toegevoegd aan het bestand	Vraag of Acclaro de opgegeven URL niet meer aanroept wanneer het bestand op welke manier dan ook verandert.
Een callback verwijderen die is toegevoegd aan het bestand	Vraag of Acclaro het opgegeven adres niet meer per e-mail verzendt wanneer het bestand op welke manier dan ook verandert.
Een callback voor bestandsupdates toevoegen	Vraag of Acclaro de opgegeven URL aanroept wanneer het bestand op welke manier dan ook wordt gewijzigd.
Een e-mailbericht aanvragen bij bestandswijzigingen	Vraag acclaro een e-mailbericht naar het opgegeven adres te verzenden wanneer het bestand op welke manier dan ook verandert. Zie de bezorgingsopties in de portal Mijn acclaro voor klantvriendelijke e-mailberichten. Dit e-mailbericht is een eenvoudig bericht dat is gericht op ontwikkelaars.
Een e-mailbericht aanvragen bij orderwijzigingen	Vraag acclaro een e-mailbericht naar het opgegeven adres te verzenden wanneer de bestelling op een willekeurige manier verandert. Zie de bezorgingsopties in de portal Mijn acclaro voor klantvriendelijke e-mailberichten. Dit e-mailbericht is een eenvoudig bericht dat is gericht op ontwikkelaars.
Een offerte goedkeuren	Dit kan alleen worden uitgevoerd op een order met de status Goedkeuring nodig. Hiermee wordt de orderstatus onmiddellijk bijgewerkt naar 'in voorbereiding' en wordt de projectmanager geïnstrueerd om aan de slag te gaan met de bestelling. De klant stemt ermee in om te betalen voor het uitgevoerde werk. De orderstatus wordt gewijzigd in 'wordt uitgevoerd' zodra het werk begint. Eventuele aanvullende opmerkingen voor de bestelling kunnen worden toegevoegd met de offertegoedkeuring.
Een offerte weigeren	Dit kan alleen worden uitgevoerd op een order met de status 'heeft approva nodig'. Wijs de offerte voor deze bestelling af. De orderstatus wordt teruggezet naar 'offerte ophalen'. De projectmanager ziet de opmerkingen en geeft een herzien offerte aan of annuleert de bestelling. Het wordt ook aanbevolen dat de klant contact op neemt met de projectmanager om de volgende stappen te bespreken.
Een offertedocument ophalen	Dit wordt naar verwachting uitgevoerd op een order met de status 'goedkeuring nodig', maar zal slagen in een bestelling die is uitgevoerd via het offerteproces. Retourneert de offerte als PDF-, Word-bestand of RTF-bestand. De header Van het inhoudstype van het antwoord geeft het bestandstype aan. Dit is een van de weinige bewerkingen die geen JSON-gegevens retourneren, in plaats daarvan rechtstreeks de bestandsinhoud retourneren. Als er een fout optreedt tijdens het verwerken van de aanvraag, zijn de JSON-gegevens van het antwoord, dus het type antwoord moet altijd worden gecontroleerd.
Een opmerking in de bestelling bewerken	Werk een opmerking bij over de bestelling.
Een opmerking toevoegen aan volgorde	Hiermee voegt u een opmerking toe aan een bestelling. Er worden nieuwe opmerkingen toegevoegd. Als een bestelling ooit moet worden geannuleerd nadat deze is verzonden, kan 'ORDER ANNULEREN' als opmerking worden ingediend.
Een opmerking uit volgorde verwijderen	Hiermee verwijdert u een opmerking uit de volgorde.
Een opmerking voor een bestand toevoegen	Voegt een opmerking toe aan het bestand. Er worden nieuwe opmerkingen toegevoegd.
Een order beoordelen	Verzendt beoordelingsinformatie over voltooide orders. Classificatieschaal is 1-5, waarbij 1 slechte kwaliteit is en 5 uitstekende kwaliteit zijn.
Een order maken	Hiermee maakt u een order voor de huidige gebruiker met de opgegeven naam. * De status van de bestelling is 'nieuw'.
Een referentiebestand verzenden	Voegt een verwijzingsbestand toe aan een bestelling. Referentiebestanden zijn woordenlijsten, stijlhulplijnen of andere ondersteunende materialen voor de vertaler. De brontaal is optioneel en indien opgegeven moet een van de taalcodes zijn die zijn verkregen uit /info/talen. Targetlang is ook optioneel en indien opgegeven moet een van de taalcodes zijn die zijn verkregen uit /info/talen. Codering is optioneel en wordt standaard ingesteld op UTF-8 als deze niet is opgegeven. De bestandsnaam en het mime-type worden opgehaald uit de metagegevens van het bestand. Als er een bestandsnaam wordt opgegeven waarmee de naam van een ander bestand in deze volgorde wordt gedupliceerd, wordt het systeem uniek door extra tekens toe te voegen (d.w.z. "documentation.docx" kan "documentation2 .docx" worden"). De metagegevens van het geretourneerde bestand bevatten zowel de oorspronkelijk opgegeven bestandsnaam als de mogelijk gewijzigde naam die Acclaro gaat gebruiken. De grootte van afzonderlijke bestanden is beperkt tot maximaal 100 MB. In voortgangsorders kunnen nieuwe extra bestanden aan deze bestanden toevoegen zolang de bron- en doeltalen overeenkomen met de bestanden van de oorspronkelijke bestelling.
Een taal toevoegen aan bestelling	Voegt een extra doeltaal toe aan een order zonder nieuwe bronbestanden toe te voegen. De nieuwe doeltaal wordt toegepast op elk bronbestand dat eerder is verzonden. Er is geen API-aanroep om een ordertaal te verwijderen. Als taalverwijdering nodig is, neemt u contact op met uw projectmanager die deze functie met beheerderstoegang kan uitvoeren.
Een tag aan volgorde toevoegen	Voegt een tag of meerdere tags toe aan een order. Unieke tags die aan orders worden toegevoegd, moeten worden gescheiden door komma's. Tags kunnen worden gebruikt voor het groeperen van selecties van orders.
Een tag uit de volgorde verwijderen	Hiermee verwijdert u tags die zijn gekoppeld aan orders. Tags kunnen slechts één voor één worden verwijderd.
Offerte aanvragen	Dit kan alleen worden uitgevoerd op een order met de status 'nieuw'. Hiermee wordt de orderstatus onmiddellijk bijgewerkt naar 'offerte ophalen' en wordt de bijgewerkte record geretourneerd. De toegewezen projectmanager wordt de offerteaanvraag gestuurd. Wanneer een offerte wordt gegenereerd, wordt de orderstatus gewijzigd in 'goedkeuring vereist'. Op dat moment bevat de record die wordt geretourneerd van get order(/orders/{orderid} een 'offerteprijs' en kunnen zowel /orders/{orderid}/quote-document als /orders/{orderid}/quote-details worden gebruikt.
Offertedetails ophalen	Dit wordt naar verwachting uitgevoerd op een order met de status 'goedkeuring nodig', maar zal slagen in een bestelling die is uitgevoerd via het offerteproces. Retourneert de prijsopgavewaarde en regelitemgegevens.
Ondersteunde talen ophalen	Retourneert een lijst met ondersteunde talen.
Opmerkingen van een bestelling ophalen	Retourneert informatieopmerkingen.
Orderreeks ophalen op id	Haal een tekenreeks op voor een order, samen met de status en vertaalde waarden als voltooid of preview gereed is.
Orderreeksen ophalen	Haal alle tekenreeksen voor een order op, samen met hun status en vertaalde waarden als deze zijn voltooid.
Systeeminformatie ophalen	Retourneert een verscheidenheid aan nuttige systeeminformatie, waaronder versie van API-broncode die wordt gebruikt, service-eindpunt en laatste datum van databasesynchronisatie.
Taalparen ophalen	Retourneert een lijst met bron-/doelparen die kunnen worden gebruikt voor vertalingen.
Tekenreeksen toevoegen	Voeg tekenreeksen toe aan een tekenreeksvolgordetype.
Verzendt de bestelling voor voorbereiding	Hiermee wordt de orderstatus onmiddellijk bijgewerkt naar 'in voorbereiding', wordt de bijgewerkte record geretourneerd. De orderstatus wordt binnenkort gewijzigd in 'wordt uitgevoerd' zodra het Acclaro-systeem de ontvangst van alle ordergegevens en bestanden bevestigt.
Voorkomen dat een e-mailbericht orderwijzigingen ontvangt	Vraag of Acclaro het opgegeven adres niet meer per e-mail verzendt wanneer de bestelling op welke manier dan ook verandert.

Accountgegevens ophalen

Alle bestellingen ophalen

Alle ondersteunde ordertypen ophalen

Bestandsgegevens ophalen

Bron- en doeltaal toevoegen aan de volgorde

De bestandsgegevens van een bestelling ophalen

Een beoordelings-URL voor een bestand toevoegen

Een bestand beoordelen

Een bestand ophalen

Een bestand uit de order verwijderen

Een bestelling bewerken

Een bestelling ophalen

Een bestelling verwijderen

Een bronbestand verzenden

Een callback toevoegen voor orderreeksupdates

Een callback toevoegen voor orderupdates

Een callback verwijderen die is toegevoegd aan bestelling

Een callback verwijderen die is toegevoegd aan het bestand

Een callback verwijderen die is toegevoegd aan het bestand

Een callback voor bestandsupdates toevoegen

Een e-mailbericht aanvragen bij bestandswijzigingen

Een e-mailbericht aanvragen bij orderwijzigingen

Een offerte goedkeuren

Een offerte weigeren

Een offertedocument ophalen

Een opmerking in de bestelling bewerken

Een opmerking toevoegen aan volgorde

Een opmerking uit volgorde verwijderen

Een opmerking voor een bestand toevoegen

Een order beoordelen

Een order maken

Een referentiebestand verzenden

Een taal toevoegen aan bestelling

Een tag aan volgorde toevoegen

Een tag uit de volgorde verwijderen

Offerte aanvragen

Offertedetails ophalen

Ondersteunde talen ophalen

Opmerkingen van een bestelling ophalen

Orderreeks ophalen op id

Orderreeksen ophalen

Systeeminformatie ophalen

Taalparen ophalen

Tekenreeksen toevoegen

Verzendt de bestelling voor voorbereiding

Voorkomen dat een e-mailbericht orderwijzigingen ontvangt

Definities

touw

bestand