POST
/
integration
/
revision
/
{orderId}
curl -X POST "https://api-integration.ollang.com/integration/revision/60b8d6f1e1b9b1d8c6c0d8e1" \
  -H "X-Api-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "wrongSubtitle",
    "time": "02:15:30",
    "description": "The subtitle at this timestamp is incorrectly translated. Should be '\''Hello world'\'' instead of '\''Hello universe'\''."
  }'

{
  "id": "rev_60b8d6f1e1b9b1d8c6c0d8e1",
  "createdAt": "2024-01-17T10:30:00Z",
  "type": "wrongSubtitle",
  "time": "02:15:30",
  "description": "The subtitle at this timestamp is incorrectly translated. Should be 'Hello world' instead of 'Hello universe'."
}

Create a revision request for an existing order to report issues or request changes to the delivered content. This endpoint allows you to specify the type of issue and provide detailed feedback for correction.

curl -X POST "https://api-integration.ollang.com/integration/revision/60b8d6f1e1b9b1d8c6c0d8e1" \
  -H "X-Api-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "wrongSubtitle",
    "time": "02:15:30",
    "description": "The subtitle at this timestamp is incorrectly translated. Should be '\''Hello world'\'' instead of '\''Hello universe'\''."
  }'

​
Authorizations

This endpoint requires API key authentication. Include your API key in the request header:

  • Header name: X-Api-Key
  • Header value: Your API key from the Ollang dashboard
  • Format: X-Api-Key: your-api-key-here

You can obtain your API key from your Ollang dashboard.

​
Path Parameters

​
orderId
string
required

The unique identifier of the order for which you want to create a revision. This should be a completed or delivered order that you have access to.

​
Body Parameters

​
type
string
required

The type of revision needed. Available options: - missingSubtitle - Subtitle is missing at a specific time - wrongSubtitle - Subtitle content is incorrect - syncError - Subtitle timing is not synchronized with audio - formatError - Subtitle formatting issues - other - Other types of issues not covered above

​
time
string
required

Timestamp indicating where the issue occurs in the content. Format: “HH:MM:SS” (e.g., “02:15:30” for 2 hours, 15 minutes, 30 seconds).

​
description
string

Optional detailed description of the revision request. Provide specific information about what needs to be corrected, including the expected result.

​
Response

​
id
string

Unique identifier of the created revision request.

​
createdAt
string

Creation date and time of the revision request (ISO 8601 format).

​
type
string

The type of revision that was requested.

​
time
string

The timestamp where the issue occurs in the content.

​
description
string

The description provided for the revision request.

{
  "id": "rev_60b8d6f1e1b9b1d8c6c0d8e1",
  "createdAt": "2024-01-17T10:30:00Z",
  "type": "wrongSubtitle",
  "time": "02:15:30",
  "description": "The subtitle at this timestamp is incorrectly translated. Should be 'Hello world' instead of 'Hello universe'."
}