New translations attributes (#1203)

This commit is contained in:
Christian Schmidt 2023-12-10 19:44:53 +01:00 committed by GitHub
parent 94aa9f71a7
commit 0ca2155229
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 96 additions and 7 deletions

View File

@ -10,25 +10,81 @@ aliases: [
] ]
--- ---
## Example ## Examples
Translation of status with content warning and media
```json ```json
{ {
"content": "<p>Hola mundo</p>", "content": "<p>Hello world</p>",
"detected_source_language": "en", "spoiler_text": "Greatings ahead",
"media_attachments": [
{
"id": 22345792,
"description": "Status author waving at the camera"
}
],
"poll": null,
"detected_source_language": "es",
"provider": "DeepL.com" "provider": "DeepL.com"
} }
``` ```
Translation of status with poll:
```json
{
"content": "<p>Should I stay or should I go?</p>",
"spoiler_text": "",
"media_attachments": [],
"poll": [
{
"id": 34858,
"options": [
{
"title": "Stay"
},
{
"title": "Go"
}
]
}
],
"detected_source_language": "ja",
"provider": "DeepL.com"
}
```
## Attributes ## Attributes
### `content` {#content} ### `content` {#content}
**Description:** The translated text of the status.\ **Description:** HTML-encoded translated content of the status.\
**Type:** String (HTML)\ **Type:** String (HTML)\
**Version history:**\ **Version history:**\
4.0.0 - added 4.0.0 - added
### `spoiler_warning` {#spoiler_warning}
**Description:** The translated spoiler warning of the status.\
**Type:** String\
**Version history:**\
4.2.0 - added
### `poll` {#poll}
**Description:** The translated poll options of the status.\
**Type:** Array\
**Version history:**\
4.2.0 - added
### `media_attachments` {#media_attachments}
**Description:** The translated media descriptions of the status.\
**Type:** Array\
**Version history:**\
4.2.0 - added
### `detected_source_language` {#detected_source_language} ### `detected_source_language` {#detected_source_language}
**Description:** The language of the source text, as auto-detected by the machine translation provider.\ **Description:** The language of the source text, as auto-detected by the machine translation provider.\

View File

@ -558,12 +558,45 @@ Authorization
#### Response #### Response
##### 200: OK ##### 200: OK
Translating the first "Hello world" post from mastodon.social into Spanish Translating a status in Spanish with content warning and media into English
```json ```json
{ {
"content": "<p>Hola mundo</p>", "content": "<p>Hello world</p>",
"detected_source_language": "en", "spoiler_text": "Greatings ahead",
"media_attachments": [
{
"id": 22345792,
"description": "Status author waving at the camera"
}
],
"poll": null,
"detected_source_language": "es",
"provider": "DeepL.com"
}
```
Translating a status with poll into English
```json
{
"content": "<p>Should I stay or should I go?</p>",
"spoiler_text": null,
"media_attachments": [],
"poll": [
{
"id": 34858,
"options": [
{
"title": "Stay"
},
{
"title": "Go"
}
]
}
],
"detected_source_language": "ja",
"provider": "DeepL.com" "provider": "DeepL.com"
} }
``` ```