Mein Acclaro (Vorschau)

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung	Class	Regions
Copilot Studio	Premium	Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:      - US Government (GCC)      - US Government (GCC High)      - China Cloud betrieben von 21Vianet      - US Department of Defense (DoD)
Logik-Apps	Norm	Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:      – Azure Government-Regionen      - Azure China-Regionen      - US Department of Defense (DoD)
Power Apps	Premium	Alle Power Apps-Regionen mit Ausnahme der folgenden:      - US Government (GCC)      - US Government (GCC High)      - China Cloud betrieben von 21Vianet      - US Department of Defense (DoD)
Power Automate	Premium	Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:      - US Government (GCC)      - US Government (GCC High)      - China Cloud betrieben von 21Vianet      - US Department of Defense (DoD)

Kontakt
Name	Mein Acclaro-Support
URL	https://www.acclaro.com/support/
Email	support@acclaro.com

Connectormetadaten
Herausgeber	Acclaro Inc.
Webseite	https://www.acclaro.com/
Datenschutzrichtlinie	https://www.acclaro.com/privacy-policy/
Kategorien	Zusammenarbeit; Inhalt und Dateien

Die Acclaro-Webdienst-API ist eine erweiterbare Gruppe von RESTful-Schnittstellen, mit denen Kunden und Partner Übersetzungsaktivitäten automatisch mit Acclaro verwalten können, z. B. Dateiübertragungen, Auftragserstellung, Qualitätsbewertungen und Statusberichte. Mit der verwendeten API können Quellinhalte, die sich in kommerziellen oder benutzerdefinierten entwickelten Content Management-Systemen befinden, programmgesteuert zur Übersetzung gesendet und anschließend empfangen und veröffentlicht werden. Alle Fragen oder Feedback zur Acclaro-API können an diese weitergeleitet support@acclaro.comwerden.

Voraussetzungen

Sie müssen einen Benutzernamen und ein Kennwort für "My Acclaro" erhalten. Um die Anmeldeinformationen anzufordern, wenden Sie sich bitte an den Kontakt support@acclaro.com oder gehen Sie hier.

Melden Sie sich nach der Einrichtung beim Portal an, und rufen Sie Ihren API-Schlüssel (ein Bearertoken) ab.

So erhalten Sie Anmeldeinformationen

Token generieren

Die Acclaro-API verwendet JSON-Webtoken (javascript object notation) für die Authentifizierung. Um gültige API-Token zu generieren, können Acclaro-Kunden die folgenden Schritte ausführen:

Wenden Sie sich direkt an Ihren Acclaro-Vertriebs- oder Geschäftsentwicklungsmitarbeiter mit Ihrer Anforderung für ein API-Token oder senden Sie eine E-Mail-Anforderung an portal@acclaro.com

Nachdem Ihre Anforderung genehmigt wurde, werden Sie Anmeldeinformationen für das Kundenportal "Mein Acclaro" bereitgestellt, wo Sie auf die Funktion "Webtoken generieren" von Ihrer Kontoeinstellungenseite aus zugreifen können. Wenn Sie Ihre API-Integration mit der My Acclaro (Sandbox)-API entwickeln und testen möchten, kann Ihr Sandkastenwebtoken mit der Sandkastenendpunkt-URL verwendet werden, ist aber nicht mit Produktionsendpunkten austauschbar.

Nach dem Generieren eines Webtokens wird eine Zeichenfolge von ca. 100 Zeichen angezeigt, die hervorgehoben und in eine lokale Zwischenablage kopiert werden kann.

Präsentieren von Token mit Anforderungen

Jede API-Anforderung muss ein gültiges Token darstellen. Dies wird im HTTP-Header "Authorization" mit dem Schema "Bearer" platziert.

Tokensperrung

Wenn es jemals zu Bedenken kommt, dass ein Token kompromittiert wurde, entweder durch digitalen Diebstahl oder durch versehentliche öffentliche Gefährdung, können Token widerrufen und auf der Seite "Einstellungen" des Kundenportals "Mein Acclaro" eindeutig erneut generiert werden.

Details zur Tokenimplementierung

Das Token ist ein RFC 7519-kompatibles JSON-Webtoken mit:

Header

• alg: HS256
• typ: JWT

Nutzlast

• sub: acclaro-username
• iat: Zeitstempel

Signatur - HMACSHA256 Signatur der ersten beiden Abschnitte

Der Zeitstempel des Problems wird in der Sperrliste verwendet und stellt sicher, dass jedes Token eindeutig ist. Die einzige unterstützte Verschlüsselungsmethode ist HS256. Alle Versuche, andere Verschlüsselungsmethoden wie NONE zu verwenden, schlagen fehl.

Erste Schritte mit Ihrem Connector

Dienst-URL-Endpunkte

Die Acclaro-API ist eine RESTful-Schnittstelle, die sich unter:

• Produktion: https://my.acclaro.com/api/v2
• Sandkasten: https://apisandbox.acclaro.com/api/v2

Argumente für API-Funktionen werden als Standardwebparameter übergeben, die urlcodiert sein können, wenn auf die Funktion mit einem GET zugegriffen wird, z. B.: https://api.acclaro.com/api/v2/orders?status=new

Argumente können auch in einen POST-Textkörper codiert werden, wenn sie mehrteilige/Formulardaten verwenden, in der Regel, wenn eine zu übersetzende Datei gesendet wird.

Rückgabewerte sind JSON-codiert in der HTTP-Antwort. Jeder zurückgegebene Datensatz enthält einen Felderfolg, der festgelegt true wird, wenn der Aufruf erfolgreich ist oder false ein Fehler auftritt. Bei Einem Fehler gibt es zwei zusätzliche Felder im Datensatz: errorCode ist eine ganze Zahl mit Werten, wie weiter unten in diesem Dokument gezeigt, und errorMessage ist eine Textzeichenfolge, die den Fehler erklärt. Bei Erfolg haben viele Aufrufe eine Felddaten, die auf zurückgegebene Daten verweist.

Beachten Sie, dass die beiden Aufrufe /orders/{orderid}/quote-document und die Dateidaten in der Antwort anstelle /orders/{orderid}/files/{fileid} von JSON-Daten zurückgegeben werden. Sie können zwischen einer Fehlerantwort von JSON-Daten oder einer erfolgreichen Antwort von Dateidaten unterscheiden, indem Sie den MIME-Typ überprüfen oder die Daten beginnen "success":.

Interaktive Testkonsole

Im Portal "Mein Acclaro" gibt es eine interaktive Testkonsole, auf die hier zugegriffen werden kann.

Mit dieser Konsole können Entwickler die API-Funktionalität ausprobieren und die Ausgabe ihrer Aufrufe anzeigen. Es ist hilfreich für schnelle Tests von API-Beispielworkflows, die das Erstellen von Aufträgen, das Anfügen von Dateien und das Übermitteln von Übersetzungen umfassen.

Zusammenfassungen zu Bestell- und Dateistatus

Bestellungen können die folgenden Status aufweisen:

• neu – Reihenfolge wird vom API-Benutzer erstellt.
• Angebot abrufen – Zitat wird von Acclaro generiert
• erfordert Genehmigung – Angebot steht für die Kundenüberprüfung zur Verfügung
• in Vorbereitung – Bestellung wurde an Acclaro übermittelt und Arbeit wurde begonnen
• in Bearbeitung – Bestellung wurde von Acclaro empfangen
• in Überprüfung – Erste Übersetzungen wurden von Acclaro übermittelt und warten auf Kundenfeedback, bevor endgültige Übersetzungen übermittelt werden oder Kundenfeedback bereitgestellt wurde und Acclaro endgültige Übersetzungen für die Zustellung vorbereitet.
• vollständig – alle endgültig übersetzten Dateien in einer Bestellung sind bereit für die API-Benutzerannahme
• abgebrochen – Bestellung und alle zugehörigen Dateien wurden von Acclaro auf Anforderung des API-Benutzers abgebrochen.

Quelldateien können die folgenden Status aufweisen:

• new – Datei wurde an eine Bestellung angefügt, die noch nicht übermittelt wurde
• Angebot abrufen – Zitat wird von Acclaro generiert
• in Bearbeitung – Datei wurde von Acclaro als Teil einer Bestellung empfangen
• Vorschau – eine in Bearbeitungsversion der übersetzten Datei ist bereit für die API-Benutzerannahme; Editoren und Korrekturleser können Feedback für weitere Verbesserungen bei der Dateiübersetzung überprüfen und freigeben.
• vollständig – übersetzte Datei ist bereit für die API-Benutzerannahme
• abgebrochen – Datei wurde von Acclaro auf Anforderung des API-Benutzers abgebrochen.

Zieldateien können den folgenden Status haben:

• vollständig – übersetzte Datei ist bereit für die API-Benutzerannahme

Rückrufe

Ein API-Benutzer kann den Empfang von Rückrufen anfordern, wenn sich die Daten ändern. Verwenden Sie den Anruf POST /orders/{orderid}/files/{fileid}/callback, um benachrichtigt zu werden, wenn eine Datei geändert wird, oder POST /orders/{orderid}/callback, um benachrichtigt zu werden, wenn sich eine Bestellung ändert. Änderungen, die einen Rückruf auslösen können, umfassen das Bearbeiten der Attribute einer Bestellung, das Senden einer Bestellung, das Hinzufügen eines Kommentars zu einer Bestellung, eine Statusänderung zu einer Bestellung, eine fertige Version einer Datei, das Hinzufügen eines Kommentars zu einer Datei oder das Ändern des Status einer Datei.

Jeder dieser API-Aufrufe enthält eine URL als Argument. Acclaro führt einen HTTP GET-Vorgang für die angegebene URL aus, wenn sich das angegebene Objekt ändert. Wenn Ihre Anwendung eine bestimmte ID-Nummer übergeben werden muss, um diesen Rückruf ordnungsgemäß zu interpretieren, geben Sie ihn bitte in Ihre URL ein, d. h. https://www.company.com/admin/plugins/acclaro/filecallback.php?oid=12345.

Acclaro batchet die Verteiler von Rückrufen, sodass zwischen dem Ändern des Objekts und der Kundenbenachrichtigung eine Verzögerung von mehreren Minuten auftreten kann. Aus Sicherheitsgründen wird empfohlen, dass Ihre Anwendung beim Empfangen eines Rückrufs die Datenbank überprüfen sollte, um festzustellen, ob auf ein gültiges Objekt verwiesen wurde, und dann den aktuellen Status dieses Objekts aus Acclaro mit GET /orders/{orderid}/files-info oder GET order/{orderid}abrufen. Auf diese Weise verursachen ungültige oder zusätzliche Rückrufe keine Probleme.

Ihr Skript, das den Rückruf empfängt, sollte in der Serie 200 einen erfolgreichen HTTP-Antwortcode zurückgeben. Wenn ein anderer Antwortcode zurückgegeben wird, wird davon ausgegangen, dass Sie den Rückruf nicht verarbeiten konnten, und wiederholen Sie ihn einige Minuten später erneut. Wenn Sie weiterhin erfolglose Antworten zurückgeben, versuchen wir es mehrmals, bevor Sie aufgeben. Wenn Sie keine Rückrufe mehr erhalten möchten, können Sie DELETE /orders/{orderid}/files/{fileid}/callback oder DELETE /orders/{orderid}/callback verwenden.

Mit der Rückruffunktion der Acclaro-API können Integrationspartner automatisierte Übersetzungsworkflows erstellen, die abgeschlossene Übersetzungen identifizieren und abrufen, sobald sie verfügbar sind. Mit der Leistungsfähigkeit von Rückrufen gibt es auch einige Risiken und die Codierung bewährter Methoden, die befolgt werden sollten, um eine optimale Effizienz sowohl für die Sende- als auch die Empfangssysteme sicherzustellen. Beispielsweise könnten alle Versuche, Bestellungen oder Dateien als Reaktion auf Rückrufe zu ändern, die darauf hindeuten, dass Änderungen aufgetreten sind, Runaway-Schleifen erstellen. Wenn Sie Fragen zu Rückrufen haben oder Eine Peer-Review-Unterstützung für Ihren Integrationscode wünschen, senden Sie Bitte Ihre Fragen und relevanten Codeausschnitte an portal@acclaro.com ihren Acclaro-Kundenmitarbeiter oder wenden Sie sich an den Kundenbetreuer von Acclaro.

E-Mail-Benachrichtigungen

Ähnlich wie Rückrufe unterstützt die API auch E-Mail-Benachrichtigungen in ähnlicher Weise mit den folgenden Aufrufen: POST /orders/{orderid}/files/{fileid}/email, POST /orders/{orderid}/callback, DELETE /orders/{orderid}/files/{fileid}/email und DELETE /orders/{orderid}/email. Die gleichen Aktionen, die einen Webrückruf auslösen würden, lösen auch diese E-Mails aus, die gesendet werden sollen.

Die E-Mail-Benachrichtigungen sollen von einer Person und nicht von einem Programm gelesen werden, folgen aber einem konsistenten Formatierungsstil und enthalten Links zum Webportal "Mein Acclaro". Diese E-Mails richten sich an Entwickler, können aber für Kollegen ohne Entwickler freigegeben werden, wenn sie daran interessiert sind, Benachrichtigungen zu erhalten, wenn sich relevante Bestell- und Dateistatus ändern. Weitere kundenfreundliche E-Mails finden Sie in den Übermittlungsoptionen im Portal "My Acclaro", oder verwenden Sie einen Webrückruf, um ein Skript zum Senden Ihrer freundlichen E-Mails aufzurufen.

Verfallszeiten

Das Fälligkeitsdatum in der Acclaro-API wird im ISO8601 Format angegeben. Wenn Sie beispielsweise "2016-09-22" verwenden, wird die aktuelle Tageszeit am 22. September ausgewählt. Wenn Sie "2016-09-22T11:22" verwenden, wählen Sie am 11:22 Uhr an diesem Datum in der Standardzeitzone für das Portalbenutzerkonto aus, dessen Webtoken für die Authentifizierung verwendet wird. Zur Angabe der vollständigen Zeitzone könnte ein Format wie "2016-09-22T11:22:00-06:00" verwendet werden, das 6 Stunden vor GMT (USA Central Time) angibt.

Datensynchronisierung

Die Acclaro-Übersetzungsverwaltungsplattform synchronisiert ihre Daten mit der Acclaro-API täglich regelmäßig. Wenn Sie die Funktionen der API in Ihrer Anwendung nutzen, kann es hilfreich sein, Zeitpuffer zu berücksichtigen, um die Genauigkeit der Datenberichterstattung sicherzustellen. Es kann z. B. 15 Minuten oder mehr dauern, bis der Status einer neu übermittelten Bestellung "in Bearbeitung" angezeigt wird. Wenn die API nach einer Stunde den Status meldet, der nicht den Erwartungen entspricht, wenden Sie sich an den Kontakt portal@acclaro.com , um das Problem zu melden.

Fehlercodes

Wenn eine API-Funktion nicht normal abgeschlossen wird, hat der zurückgegebene Datensatz Erfolg = 0, und errorCode wird auf einen der folgenden Werte festgelegt. Darüber hinaus verfügt errorMessage über eine Textzeichenfolge, die möglicherweise spezifischer zu dem aufgetretenen Problem ist.

• Fehlende Autorisierung – in der Anforderung wurde kein Webtoken gefunden.
• Ungültige Autorisierung – ein Webtoken wurde bereitgestellt, aber keine kryptografischen Prüfungen bestanden oder bezieht sich auf ein Konto ohne ordnungsgemäße Berechtigungen.
• Falsche Argumente – Sie konnten kein erforderliches Argument für den API-Aufruf angeben oder zusätzliche unerwartete Argumente übergeben.
• Datenbankfehler – Beim Verarbeiten des API-Aufrufs ist ein Datenbankfehler aufgetreten. Obwohl das System wahrscheinlich bereits die Systemadministratoren von Acclaro benachrichtigt hat, teilen Sie uns diesen Fehler bitte mit, wenn dieser Fehler wiederholt angezeigt wird.
• Berechtigung verweigert – Sie haben versucht, eine Aktion für ein Objekt auszuführen, auf das Sie keinen Zugriff haben.
• Datei vorhanden – Sie haben versucht, eine Datei mit einem Namen zu senden, der mit einer anderen Datei in der Reihenfolge in Konflikt liegt.
• Plunet-Kommunikationsfehler – Die API-Ebene konnte nicht mit dem internen Verwaltungssystem von Acclaro kommunizieren. Obwohl das System wahrscheinlich bereits die Systemadministratoren von Acclaro benachrichtigt hat, teilen Sie uns diesen Fehler bitte mit, wenn dieser Fehler wiederholt angezeigt wird.
• Keine solche Bestellung - Sie haben versucht, einen Anruf für eine Bestellung auszuführen, die nicht vorhanden ist.
• Löschen nicht möglich – Sie haben versucht, eine Bestellung oder Datei nach dem Start der Arbeit zu löschen. Wenden Sie sich an Ihren Acclaro-Projektmanager, um eine Kündigung der laufenden Arbeit anzufordern.
• Aktualisierung nicht möglich – Sie haben versucht, eine Bestellung oder Datei zu ändern, nachdem die Arbeit gestartet wurde. Wenden Sie sich an Ihren Acclaro-Projektmanager, um eine Kündigung der laufenden Arbeit anzufordern.
• Ungültige Sprache – Sie haben eine Quell- oder Zielsprache angegeben, die von Acclaro nicht unterstützt wird.
• Keine solche Datei - Sie haben versucht, einen Aufruf für eine Datei auszuführen, die nicht vorhanden ist.
• Ungültiges Datum – wir konnten das angegebene Datum/die angegebene Uhrzeit nicht analysieren.
• Kein solcher Rückruf - der angegebene Rückruf konnte nicht gefunden werden.
• Ungültige Lieferung – ein nicht unterstützter Lieferwert wurde angegeben.
• Keine Simulation – die Simulations-API-Aufrufe sind nicht aktiviert
• Zu groß – die übermittelte Datei ist zu groß, um verarbeitet zu werden.

Bekannte Probleme und Einschränkungen

• Die maximale Anzahl von Ergebnissen pro Seite beträgt 50, es wird empfohlen, diese Abfragen zu paginieren, die erwartet werden, dass mehr als 50 Ergebnisse zurückgegeben werden.
• Die für jede IP zulässige maximale Anzahl von Anforderungen pro Minute beträgt 180; wenden Sie sich an den Support, wenn dies zu einer Einschränkung für Sie führt.

Häufige Fehler und Abhilfemaßnahmen

Erstellen sie eine Bestellung und übermitteln Sie sie nicht:

Wenn eine Bestellung erstellt wird, bleibt die Bestellung geöffnet, falls der Benutzer weitere Elemente hinzufügen möchte oder mehr Zeit benötigt, um die Bestellung abzuschließen. Sobald die Bestellung abgeschlossen ist, muss der Benutzer die Bestellung zur Übersetzung "übermitteln".

Es ist üblich, diesen Schritt zu verpassen, wenn die API manuell durch Befehle oder manuelle Schritte ausgeführt wird.

Acclaro führt standardmäßig keine Maßnahmen für eine Bestellung aus, die noch nicht übermittelt wurde. Falls Sie die Bestellung nicht über die API oder die Benutzeroberfläche aus irgendeinem Grund übermitteln können, wenden Sie sich bitte an Ihren zugewiesenen Programm-Manager oder das Supportteam unter: support@acclaro.com

Datumsformat

Die API funktioniert mit ISO8601 Datumsformat, z. B. "2022-01-21T16:24:00-05:00", aber Datumsangaben werden als Zeichenfolgen in der JSON-Antwort ausgegeben. Um das Format von Zeichenfolge in Datum zu konvertieren, können Sie diese Formel formatDateTime({anyMyAcclaroDateField},'g')verwenden. Felder, die Datumsangaben enthalten, sind created, modified, due_date, . requested_due_date

Wenn Sie ein Fälligkeitsdatum von einem anderen Tool festlegen möchten, z. B. MS Forms, müssen Sie es in ISO8601 formatieren, indem Sie dieselbe oben gezeigte Formel verwenden.

Häufig gestellte Fragen

1. Stellt Acclaro eine Stagingumgebung zum Testen der API bereit?

Acclaro stellt eine Sandkasten-API-Umgebung bereit, an die Sie API-Anforderungen stellen können. Um auf diese Umgebung zuzugreifen, können Sie den Endpunkt in "apisandbox.acclaro.com" ändern und ein Bearertoken für diese Umgebung entsprechend abrufen. Wenn Sie zum Produktionsendpunkt zurückkehren möchten, müssen Sie zu "my.acclaro.com" wechseln.

2. Berechnet Acclaro Gebühren für die Nutzung des My Acclaro-Portals?

Nein, Acclaro gebühren für die Dienste, die über das Portal My Acclaro angefordert werden, aber die Nutzung des Portals und seiner API ist für alle Acclaro-Kunden kostenlos.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe	Parameter zum Erstellen einer Verbindung.	Alle Regionen	Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name	Typ	Description	Erforderlich
API-Schlüssel	securestring	Der API-Schlüssel für diese API	Richtig

Drosselungsgrenzwerte

Name	Aufrufe	Verlängerungszeitraum
API-Aufrufe pro Verbindung	100	60 Sekunden

Aktionen

Ablehnen eines Anführungszeichens	Dies kann nur für eine Bestellung mit dem Status "needs approva" ausgeführt werden. Lehnen Sie das Angebot für diese Bestellung ab. Der Bestellstatus wechselt zurück zu "Angebot abrufen". Der Projektmanager sieht die Kommentare und gibt entweder ein überarbeitetes Angebot aus oder bricht die Bestellung ab. Es wird auch empfohlen, dass der Kunde seinen Projektmanager kontaktiert, um die nächsten Schritte zu besprechen.
Abrufen aller Bestellungen	Gibt alle Bestellungen zurück, die dem aktuellen Benutzer zugewiesen sind, als Array von Order-Datensätzen. Beachten Sie, dass ältere abgeschlossene Bestellungen möglicherweise archiviert und aus dem aktiven System entfernt werden. Kann mithilfe des Status gefiltert werden.
Abrufen aller unterstützten Bestelltypen	Gibt alle Für das Konto verfügbaren Bestelltypen als Array von Bestelltypen zurück, jeder Bestelltyp bestehend aus einem Namen und einem Flag "Standard", das null oder eins ist, und gibt an, welcher Bestelltyp festgelegt wird, wenn keine angegeben wird.
Abrufen der Dateiinformationen einer Bestellung	Gibt Informationen zu allen Dateien in der Reihenfolge zurück.
Abrufen der Kommentare einer Bestellung	Gibt Informationskommentare zurück.
Abrufen einer Datei	Gibt den Inhalt einer zuvor gesendeten Datei zurück. Dies ist eine der wenigen Vorgänge, die keine JSON-Daten zurückgeben, sondern die Dateiinhalte direkt zurückgeben. Wenn beim Verarbeiten der Anforderung ein Fehler auftritt, sind die Antwort JSON-Daten, sodass der Typ der Antwort immer überprüft werden sollte.
Abrufen eines Anführungszeichendokuments	Dies wird erwartet, dass sie für eine Bestellung mit dem Status "Erfordert Genehmigung" ausgeführt wird, aber bei einer Bestellung erfolgreich ist, die sich im Angebotsprozess befunden hat. Gibt das Anführungszeichen als PDF-, Word- oder RTF-Datei zurück. Der Inhaltstypheader der Antwort gibt den Dateityp an. Dies ist eine der wenigen Vorgänge, die keine JSON-Daten zurückgeben, sondern die Dateiinhalte direkt zurückgeben. Wenn beim Verarbeiten der Anforderung ein Fehler auftritt, sind die Antwort JSON-Daten, sodass der Typ der Antwort immer überprüft werden sollte.
Abrufen unterstützter Sprachen	Gibt eine Liste der unterstützten Sprachen zurück.
Abrufen von Angebotsdetails	Dies wird erwartet, dass sie für eine Bestellung mit dem Status "Erfordert Genehmigung" ausgeführt wird, aber bei einer Bestellung erfolgreich ist, die sich im Angebotsprozess befunden hat. Gibt den Anführungszeichenwert und die Details der Position zurück.
Abrufen von Bestellzeichenfolgen	Rufen Sie alle Zeichenfolgen für eine Reihenfolge zusammen mit ihren Status und übersetzten Werten ab, wenn sie abgeschlossen sind.
Abrufen von Kontoinformationen	Gibt Profilinformationen zum verwendeten API-Benutzerkonto zurück.
Abrufen von Sprachpaaren	Gibt eine Liste von Quell-/Zielpaaren zurück, die für Übersetzungen verwendet werden können.
Abrufen von Systeminformationen	Gibt eine Vielzahl hilfreicher Systeminformationen zurück, einschließlich der verwendeten Version des API-Quellcodes, des Dienstendpunkts und des letzten Datums der Datenbanksynchronisierung.
Anfordern einer E-Mail an Dateiänderungen	Fordern Sie an, dass Acclaro eine E-Mail-Nachricht an die angegebene Adresse sendet, wenn sich die Datei in irgendeiner Weise ändert. Informationen zu kundenfreundlichen E-Mail-Nachrichten finden Sie in den Übermittlungsoptionen im Portal "Mein Acclaro". Diese E-Mail ist eine einfache Nachricht, die auf Entwickler ausgerichtet ist.
Anfordern einer E-Mail zu Bestelländerungen	Fordern Sie an, dass Acclaro eine E-Mail-Nachricht an die angegebene Adresse sendet, wenn sich die Bestellung in irgendeiner Weise ändert. Informationen zu kundenfreundlichen E-Mail-Nachrichten finden Sie in den Übermittlungsoptionen im Portal "Mein Acclaro". Diese E-Mail ist eine einfache Nachricht, die auf Entwickler ausgerichtet ist.
Anfordern eines Angebots	Dies kann nur für eine Bestellung mit dem Status "neu" ausgeführt werden. Aktualisiert sofort den Bestellstatus auf "Angebot abrufen" und gibt den aktualisierten Datensatz zurück. Der zugewiesene Projektmanager wird die Angebotsanfrage gesendet. Wenn ein Angebot generiert wird, ändert sich der Bestellstatus in "Erfordert Genehmigung". Zu diesem Zeitpunkt enthält der von get order(/orders/{orderid} zurückgegebene Datensatz einen "Quoteprice" und sowohl /orders/{orderid}/quote-document und /orders/{orderid}/quote-details können verwendet werden.
Bearbeiten einer Bestellung	Aktualisiert eine Reihenfolge, gibt den neuen Datensatz zurück. Nachdem eine Bestellung erstellt wurde und der Status "neu" lautet, kann die Funktion nur zum Ändern von Namens- und Übermittlungsattributen verwendet werden. Argumente sind identisch mit der beschreibung in create order(/orders). Obwohl Fälligkeitsdatum, Übermittlung, Estwordcount und Typ optional sind, sollten Sie darauf achten, die vorherigen Werte dieser Werte zu übermitteln, wenn Sie sie nicht ändern möchten, andernfalls werden sie auf Standardwerte zurückgesetzt.
Bearbeiten eines Kommentars in der Reihenfolge	Aktualisieren Sie einen Kommentar zu der Bestellung.
Beenden einer E-Mail beim Empfang von Bestelländerungen	Fordern Sie an, dass Acclaro die angegebene Adresse nicht mehr per E-Mail senden kann, wenn sich die Bestellung in irgendeiner Weise ändert.
Bestellung abrufen	Gibt Bestellinformationen basierend auf der angegebenen ID zurück.
Bestellzeichenfolge nach ID abrufen	Rufen Sie eine Zeichenfolge für eine Bestellung zusammen mit Status und übersetzten Werten ab, wenn sie abgeschlossen oder in der Vorschau bereit sind.
Bewerten einer Bestellung	Übermittelt Bewertungsinformationen zu abgeschlossenen Aufträgen. Die Bewertungsskala ist 1-5, wobei 1 schlechte Qualität ist und 5 ausgezeichnete Qualität ist.
Bewerten einer Datei	Sendet Bewertungsinformationen zu Dateien. Die Bewertungsskala ist 1-5, wobei 1 schlechte Qualität ist und 5 perfekte Qualität ist. Überprüfungstextzeichenfolgen sind optional und können eingeschlossen werden, um die Begründung für die Bewertung zu erläutern, z. B. identifizierte Fehler oder Bereiche von Übersetzungsverbesserungsklassifizierungen.
Dateiinformationen anzeigen	Ruft Informationen zur angegebenen Datei ab.
Entfernen eines Kommentars aus der Reihenfolge	Entfernt einen Kommentar aus der Reihenfolge.
Erstellt einen Auftrag.	Erstellt eine Reihenfolge für den aktuellen Benutzer mit dem angegebenen Namen. * Der Status der Bestellung lautet "neu".
Genehmigen eines Angebots	Dies kann nur für eine Bestellung mit dem Status "Genehmigung erforderlich" durchgeführt werden. Aktualisiert sofort den Auftragsstatus auf "In Vorbereitung" und weist den Projektmanager an, mit der Bestellung zu beginnen. Der Kunde stimmt zu, für die geleistete Arbeit zu bezahlen. Der Auftragsstatus wird nach Beginn der Arbeit in "in Bearbeitung" geändert. Alle zusätzlichen Kommentare für die Bestellung können mit der Angebotsgenehmigung hinzugefügt werden.
Hinzufügen der Quell- und Zielsprache zur Reihenfolge	Für Bestellungen mit 0 Quelldateien zum Zeitpunkt der Übermittlung kann dieser Aufruf verwendet werden, um dem System mitzuteilen, welche Sprachen für diese Bestellung erforderlich sind. Kann nur für neue Bestellungen verwendet werden, die nicht übermittelt wurden oder keine Angebote erhalten haben. Anforderungen bereits bekannter Sprachen werden ignoriert.
Hinzufügen einer Kategorie zur Reihenfolge	Fügt einer Reihenfolge ein Tag oder mehrere Tags hinzu. Eindeutige Tags, die bestellungen hinzugefügt werden, sollten durch Kommas getrennt werden. Tags können zum Gruppieren von Bestellungen verwendet werden.
Hinzufügen einer Prüf-URL für eine Datei	Fügt eine URL zu einer Datei hinzu, sodass auf sie in der Kontextüberprüfung im Web verwiesen werden kann. Dies setzt voraus, dass die URL öffentlich verfügbar ist oder der Übersetzer über private Zugriffsanmeldeinformationen zum Anzeigen des Inhalts verfügt. Bei Quelldateien kann diese URL übersetzern dabei helfen, den anfänglichen Kontext und die Layouteinschränkungen des Inhalts zu verstehen. Bei Zieldateien kann diese URL Übersetzer, Editoren und Tester mit Überprüfungsworkflows unterstützen, um sicherzustellen, dass übersetzte Inhalte auf den Zielwebseiten erwartungsgemäß angezeigt werden.
Hinzufügen einer Sprache zur Reihenfolge	Fügt eine zusätzliche Zielsprache zu einer Reihenfolge hinzu, ohne neue Quelldateien hinzuzufügen. Die neue Zielsprache wird auf jede zuvor übermittelte Quelldatei angewendet. Es gibt keinen API-Aufruf zum Löschen einer Bestellsprache. Wenn eine Sprachlöschung erforderlich ist, wenden Sie sich an Ihren Projektmanager, der diese Funktion mit Administratorzugriff ausführen kann.
Hinzufügen eines Kommentars für eine Datei	Fügt der Datei einen Kommentar hinzu. Neue Kommentare werden angefügt.
Hinzufügen eines Kommentars zur Reihenfolge	Fügt einer Bestellung einen Kommentar hinzu. Neue Kommentare werden angefügt. Wenn eine Bestellung jemals nach der Übermittlung storniert werden muss, kann "CANCEL ORDER" als Kommentar übermittelt werden.
Hinzufügen eines Rückrufs für Bestellupdates	Fordern Sie an, dass Acclaro die angegebene URL aufruft, wenn sich die Reihenfolge in irgendeiner Weise ändert. Wenn Ihr Code nur bestimmte Änderungen betrifft, z. B. den Status "abgeschlossen", müssen Sie die Bestellinformationen abrufen und danach suchen.
Hinzufügen eines Rückrufs für Bestellzeichenfolgenaktualisierungen	Fordern Sie an, dass Acclaro die angegebene URL aufruft, wenn sich die Reihenfolgenzeichenfolge in irgendeiner Weise ändert. Der Rückruf enthält einen string_id Abfrageparameter, der zum Abrufen von Zeichenfolgendetails verwendet werden kann.
Hinzufügen eines Rückrufs für Dateiupdates	Fordern Sie an, dass Acclaro die angegebene URL aufruft, wenn sich die Datei in irgendeiner Weise ändert.
Hinzufügen von Zeichenfolgen	Fügen Sie Zeichenfolgen zu einem Zeichenfolgenreihenfolgetyp hinzu.
Löschen einer Bestellung	Löscht eine Bestellung für den aktuellen Benutzer mit der angegebenen ID, wenn die Bestellung "neu" ist und der aktuelle Benutzer über die entsprechenden Kontoberechtigungen verfügt.
Löschen einer Datei aus der Reihenfolge	Löscht die angegebene Datei aus der Bestellung, bevor eine Bestellung übermittelt wird. Wenn eine Quelldatei jemals abgebrochen werden muss, nachdem sie als Teil einer Bestellung übermittelt wurde, kann 'CANCEL FILE' als Kommentar in /orders/{orderid}/files/{fileid}/comment übermittelt werden. Außerdem bitten wir Sie, sich separat an Ihren Acclaro-Projektmanager mit der Anforderung zum Abbrechen der Quelldatei zu wenden.
Löschen eines Rückrufs, der der Bestellung hinzugefügt wurde	Fordern Sie an, dass Acclaro die angegebene URL nicht mehr aufruft, wenn sich die Reihenfolge in irgendeiner Weise ändert.
Löschen eines Rückrufs, der der Datei hinzugefügt wurde	Fordern Sie an, dass Acclaro die angegebene URL nicht mehr aufruft, wenn sich die Datei in irgendeiner Weise ändert.
Löschen eines Rückrufs, der der Datei hinzugefügt wurde	Fordern Sie an, dass Acclaro die angegebene Adresse nicht mehr per E-Mail senden kann, wenn sich die Datei in irgendeiner Weise ändert.
Löschen eines Tags aus der Reihenfolge	Löscht Tags, die Bestellungen zugeordnet sind. Tags können jeweils nur einzeln gelöscht werden.
Senden einer Quelldatei	Fügt eine Datei zu einer Reihenfolge hinzu, wobei der Dateiname und der MIME-Typ aus den Dateimetadaten übernommen werden. Wenn keine Bestell-ID angegeben wird, wird automatisch eine neue Bestellung erstellt. Das Sourcelang sollte einer der Von /info/languages abgerufenen Sprachcodes sein. Targetlangs können ein einzelner Sprachcode oder mehrere Sprachcodes in einer durch Trennzeichen getrennten Liste sein. Die Codierung ist optional und wird standardmäßig auf "UTF-8" festgelegt, falls nicht angegeben. ClientRef ist ein optionaler Wert, der für den API-Benutzer in der Regel für Bestellnummern verwendet wird, aber für alle relevanten Informationen verwendet werden kann; wenn beim Laden der Datei angegeben wird, wird sie in allen zukünftigen Aufrufen zu dieser Datei zurückgegeben. Wenn ein Dateiname angegeben wird, der den Namen einer anderen Datei in dieser Reihenfolge dupliziert, macht es das System durch Hinzufügen zusätzlicher Zeichen eindeutig (d. h. "documentation.docx" kann "documentation-2.docxwerden "). Zurückgegebene Dateimetadaten enthalten sowohl den ursprünglich angegebenen Dateinamen als auch den möglicherweise geänderten Namen, den Acclaro verwendet. Einzelne Dateigröße ist auf maximal 100 MB begrenzt. Die API ist dateiunabhängig, da keine Dateitypbeschränkungen vorhanden sind. XLIFF-Dateien sind ein gängiger Standard für die Übersetzungsindustrie und werden vollständig unterstützt. In Bearbeitungsaufträgen können neue zusätzliche Dateien hinzugefügt werden, solange die Quell- und Zielsprachen den Dateien der ursprünglichen Reihenfolge entsprechen. Für fortlaufende programmgesteuerte Bestellungen wird empfohlen, dass die /orders/{orderid}/files verwendet werden, um Bestellungen mit Quelldateien zu erstellen, bevor sie über den SubmitOrder-Aufruf übermittelt werden, da dies der effizienteste Pfad für Acclaro-Übersetzungsdienste ist, um Bestellungen mit mehreren Dateien zu empfangen und anschließend nachfolgende Übersetzungsdateien zurückzugeben. Wenn Clients bestimmte Ordner- und Dateistrukturen für ihre Quelldateien beibehalten möchten, können sie ZIP-Dateien hochladen, die mit Übersetzungen in den gewünschten Ordnern und Dateistrukturen innerhalb der Zip-Dateien für die Zielübermittlung zurückgegeben werden.
Senden einer Referenzdatei	Fügt einer Bestellung eine Referenzdatei hinzu. Referenzdateien sind Glossare, Formatvorlagen oder andere Unterstützende Materialien für den Übersetzer. Das Sourcelang ist optional, und falls angegeben, sollte einer der von /info/languages abgerufenen Sprachcodes sein. Targetlang ist ebenfalls optional, und falls angegeben, sollte einer der sprachcodes sein, die von /info/languages abgerufen wurden. Die Codierung ist optional und wird standardmäßig auf "UTF-8" festgelegt, falls nicht angegeben. Der Dateiname und mime-Typ stammen aus den Dateimetadaten. Wenn ein Dateiname angegeben wird, der den Namen einer anderen Datei in dieser Reihenfolge dupliziert, macht es das System durch Hinzufügen zusätzlicher Zeichen eindeutig (d. h. "documentation.docx" kann zu "documentation2 .docx"). Zurückgegebene Dateimetadaten enthalten sowohl den ursprünglich angegebenen Dateinamen als auch den möglicherweise geänderten Namen, den Acclaro verwendet. Einzelne Dateigröße ist auf maximal 100 MB begrenzt. In Bearbeitungsaufträgen können neue zusätzliche Dateien hinzugefügt werden, solange die Quell- und Zielsprachen den Dateien der ursprünglichen Reihenfolge entsprechen.
Übermittelt den Auftrag zur Vorbereitung.	Aktualisiert sofort den Bestellstatus auf "in Vorbereitung", gibt den aktualisierten Datensatz zurück. Der Bestellstatus wird bald in "in Bearbeitung" geändert, sobald das Acclaro-System den Empfang aller Bestelldetails und Dateien bestätigt.

Ablehnen eines Anführungszeichens

Abrufen aller Bestellungen

Abrufen aller unterstützten Bestelltypen

Abrufen der Dateiinformationen einer Bestellung

Abrufen der Kommentare einer Bestellung

Abrufen einer Datei

Abrufen eines Anführungszeichendokuments

Abrufen unterstützter Sprachen

Abrufen von Angebotsdetails

Abrufen von Bestellzeichenfolgen

Abrufen von Kontoinformationen

Abrufen von Sprachpaaren

Abrufen von Systeminformationen

Anfordern einer E-Mail an Dateiänderungen

Anfordern einer E-Mail zu Bestelländerungen

Anfordern eines Angebots

Bearbeiten einer Bestellung

Bearbeiten eines Kommentars in der Reihenfolge

Beenden einer E-Mail beim Empfang von Bestelländerungen

Bestellung abrufen

Bestellzeichenfolge nach ID abrufen

Bewerten einer Bestellung

Bewerten einer Datei

Dateiinformationen anzeigen

Entfernen eines Kommentars aus der Reihenfolge

Erstellt einen Auftrag.

Genehmigen eines Angebots

Hinzufügen der Quell- und Zielsprache zur Reihenfolge

Hinzufügen einer Kategorie zur Reihenfolge

Hinzufügen einer Prüf-URL für eine Datei

Hinzufügen einer Sprache zur Reihenfolge

Hinzufügen eines Kommentars für eine Datei

Hinzufügen eines Kommentars zur Reihenfolge

Hinzufügen eines Rückrufs für Bestellupdates

Hinzufügen eines Rückrufs für Bestellzeichenfolgenaktualisierungen

Hinzufügen eines Rückrufs für Dateiupdates

Hinzufügen von Zeichenfolgen

Löschen einer Bestellung

Löschen einer Datei aus der Reihenfolge

Löschen eines Rückrufs, der der Bestellung hinzugefügt wurde

Löschen eines Rückrufs, der der Datei hinzugefügt wurde

Löschen eines Rückrufs, der der Datei hinzugefügt wurde

Löschen eines Tags aus der Reihenfolge

Senden einer Quelldatei

Senden einer Referenzdatei

Übermittelt den Auftrag zur Vorbereitung.

Definitionen

Schnur

file