Order methods¶

Order (GET)¶

Summary :

Retrieves a group of jobs that were previously submitted together by their order id.

URL :

http://api.gengo.com/v2/translate/order/{order_id}

Authentication :

Required

Parameters :

• api_key (required) - Your API key
• api_sig (required) - Your API signature
• ts (required) - Current Unix epoch time as an integer

Example call

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

#!/usr/bin/python
# -*- coding: utf-8 -*-

from gengo import Gengo


gengo = Gengo(
    public_key='your_public_key',
    private_key='your_private_key',
    sandbox=False,
    debug=False)

print(gengo.getTranslationOrderJobs(id=232))

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

{
  "opstat": "ok",
  "response": {
    "order": {
      "jobs_queued": 0,
      "jobs_reviewable": [

      ],
      "jobs_available": [
        "243646",
        "243647",
        "243645"
      ],
      "jobs_pending": [

      ],
      "jobs_approved": [

      ],
      "jobs_revising": [

      ],
      "jobs_cancelled": [

      ],
      "jobs_held": [

      ],
      "order_id": "232",
      "total_credits": "0.30",
      "total_units": 6,
      "total_jobs": "3",
      "currency": "USD"
    }
  }
}

Order (DELETE)¶

Summary :

Cancels all available jobs in an order. Please keep in mind that this will not cancel jobs that are in another status (e.g. pending, reviewable, etc.).

URL :

http://api.gengo.com/v2/translate/order/{id}

Authentication :

Required

Parameters :

• api_key (required) - Your API key
• api_sig (required) - Your API signature
• ts (required) - Current Unix epoch time as an integer

Example call

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

#!/usr/bin/python
# -*- coding: utf-8 -*-

from gengo import Gengo


gengo = Gengo(
    public_key='your_public_key',
    private_key='your_private_key',
    sandbox=False,
    debug=False)

gengo.deleteTranslationOrder(id=42)

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

{
  "opstat": "ok",
  "response": {
    "order": {
      "jobs_queued": 0,
      "jobs_reviewable": [
          "243648"
      ],
      "jobs_available": [

      ],
      "jobs_cancelled": [
          "243646",
          "243647",
          "243645"
      ],
      "jobs_pending": [

      ],
      "jobs_approved": [

      ],
      "order_id": "232",
      "total_credits": "0.80",
      "total_units": 10,
      "total_jobs": "4",
      "jobs_revising": [

      ],
      "currency": "USD"
    }
  }
}

Comments (GET)¶

Summary :

Retrieves the comment thread for an order.

URL :

http://api.gengo.com/v2/translate/order/{id}/comments

Authentication :

Required

Parameters :

• api_key (required) - Your API key
• api_sig (required) - Your API signature
• ts (required) - Current Unix epoch time as an integer

Data arguments :

• id (required) - Order ID

Note : Possible values for “author” are “customer” or “translator”.

Example call

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

#!/usr/bin/python
# -*- coding: utf-8 -*-

from gengo import Gengo


gengo = Gengo(
    public_key='your_public_key',
    private_key='your_private_key',
    sandbox=False,
    debug=False)

print(gengo.getOrderComments(id=42))

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

{
  "opstat": "ok",
  "response": {
    "thread": [
      {
        "body": "....",
        "author": "translator",
        "ctime": 1266322028
      },
      {
        "body": "....",
        "author": "customer",
        "ctime": 1266324432
      }
    ]
  }
}

Comment (POST)¶

Summary :

Submits a new comment to the order’s comment thread.

URL :

http://api.gengo.com/v2/translate/order/{id}/comment

Authentication :

Required

Parameters :

• api_key (required) - Your API key
• api_sig (required) - Your API signature
• ts (required) - Current Unix epoch time as an integer

Data arguments :

• id (required) - Order ID
• body (required) - The comment body

Example call

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

#!/usr/bin/python
# -*- coding: utf-8 -*-

from gengo import Gengo


gengo = Gengo(
    public_key='your_public_key',
    private_key='your_private_key',
    sandbox=False,
    debug=False)

gengo.postOrderComment(
    id=42,
    comment={
        'body': 'I love lamp!'
    }
)

Response

1
2
3
4
5
6

{
  "opstat": "ok",
  "response": {

  }
}