Inleiding

Biedt RESTful API's voor documentvertaling, ondersteunt geautomatiseerd beheer van vertalingstaken, op glossarium gebaseerde terminologieconsistentie, en query's voor ondersteunde formaten, talen en modellen, waardoor het eenvoudig is om naadloze vertaalworkflows op te bouwen en gebruikersaccounts te beheren.

Aan de slag

Om te beginnen moet u een aanvraag indienen om ontwikkelaar te worden.Aanmelden als ontwikkelaar

Eenmaal goedgekeurd kunt u meerdere API-sleutels aanmaken en de juiste API-sleutel in elke API-aanvraag opnemen zoals vereist.

Verkrijg uw API-sleutel

Snelle toegang

Base URL

https://shangyiai.com/api

Authenticatiemethode

Authorization: [yourSecretKey]

JSON-verzoek

Behalve de bestandsupload-interface gebruiken interfaces standaard POST JSON-verzoeken, Content-Type is application/json.

Bestand uploaden

Het aanmaken van een documentvertaaltaak gebruikt multipart/form-data, waarbij het file-veld het te vertalen bestand ontvangt.

Algemene foutrespons

Bij een mislukte aanvraag retourneert de interface JSON, waarbij het error-veld een vaste Engelse foutmelding bevat. Het wordt aanbevolen om fouten eerst te behandelen op basis van HTTP status code, waarbij het error-veld wordt gebruikt voor weergave of logregistratie.

{
  "error": "Invalid API key."
}

Fout statuscode regels

Alle v1 API foutresponses behouden dezelfde structuur, verwerk deze volgens de onderstaande HTTP status code regels.

400 Bad Request: Missing required parameters, invalid parameter formats or enum values, missing file upload, upload save failure, or task processing failure.
401 Unauthorized: Missing API key or invalid API key.
402 Payment Required: Insufficient credits balance for preview, full translation, or text translation.
404 Not Found: The task or glossary does not exist, has been deleted, does not belong to the current API account, or was not created through the API.
409 Conflict: The current task status does not allow the requested operation.
500 Internal Server Error: Unexpected server exception. The response error is fixed as "Internal server error.".

Aanbevolen integratieprocedure

1. Taak aanmaken

Upload bestand en maak een vertaaltaak aan, retourneert taskId.

2. Voortgang opvragen

Controleer regelmatig de taakstatus totdat deze Completed, Terminated of Cancelled is.

3. Resultaat ophalen

Download het vertaalde bestand, of lees de originele tekst en vertaling JSON.

4. Taken beheren

Betaal naar gebruik voor volledige tekstvertaling, taken herstarten, tekst herzien of taken verwijderen.

Bronnen

Ontwikkelaarsgemeenschap

Als u vragen heeft, kunt u hulp krijgen in de ontwikkelaarsgemeenschap.