Get job results

get
JOB RESULT

https://api.playment.io/v1/projects/:project_id/jobs/:job_id
This endpoint allows you to get the annotations created on a job.
Request
Response
Request
Path Parameters
job_id
required
string
ID of the job. You would have received this ID in the response when you created the job.
project_id
required
string
ID of the project where the job was created
Headers
x-api-key
required
string
API key for authentication
Response
200: OK
Job results successfully retrieved.
{
"data": {
"project_id": "905ea3ee-6f62-4bb7-8c31-471e486d9202",
"reference_id": "001",
"job_id": "3f3e8675-ca69-46d7-aa34-96f90fcbb732",
"batch_id": "468b6ae3-e98d-4d08-9427-b6e7a016054c",
"status": "completed",
"work_flow_id": "2aae1234-acac-1234-eeff-12a22a237bbc",
"result": "https://playment-data-uploads.s3.ap-south-1.amazonaws.com/sample-result.json"
},
"success": true
}

get
ATTACHMENT

https://api.playment.io/v1/attachments?url=:result_url
The result_url (data.result) returned by the GET Job result API is a private URL (Well, it's public till 15th July 2021, after which we'll enforce it to be private). You need to use this Attachment access API to securely fetch the results. Please refer to the Attachment Access API document for more detail.
Request
Response
Request
Path Parameters
result_url
required
string
Result URL returned by the GET job result API
Headers
x-api-key
required
string
API key for authentication
Response
200: OK
The API will redirect to a signed URL of the attachment

Result Object

{
"data": {
"annotations": {
"rectangles": [],
"polygons": [],
"lines": [],
"cuboids": [],
"landmarks": []
},
"image_url":"https://s3.aws.com/600x400/000/fff.jpg&text=Dummy+Image+1"
}
}

The rectangles list contains objects, where each object is an annotation. You can check the data structures for various annotation types below:

Rectangles
Polygons
Lines
Cuboids
Landmarks
Rectangles
"rectangles": [
{
"_id": "0e6d895e-2484-439a-b62b-d8a0afb3d190",
"label": "Chair".
"attributes": {
"Truncation": {
"value": "0% Truncated"
},
"Occlusion": {
"value": "0% Occluded"
}
}
"coordinates": [
{"x": 0.00398, "y": 0.00558},
{"x": 0.05404, "y": 0.00558},
{"x": 0.05404, "y": 0.09096},
{"x": 0.00398, "y": 0.09096}
]
}
]
Polygons
"polygons": [
{
"_id": "8f8897ad-e07b-4e55-9dbe-61f6b9df85c5",
"label": "Pedestrian Crossing",
"attributes": {
"Type": {
"value": "Dashed"
},
"Occlusion": {
"value": "0% - 25% Occluded"
},
"Truncation": {
"value": "0% Truncated"
}
}
"points": {
"p1": {"x": 0.286774, "y": 0.892502},
"p2": {"x": 0.385849, "y": 0.576888},
"p3": {"x": 0.426721, "y": 0.469081},
"p4": {"x": 0.288623, "y": 0.253878},
"p5": {"x": 0.148623, "y": 0.353878}
},
"edges": {
"e1": ["p1", "p2"],
"e2": ["p2", "p3"],
"e3": ["p3", "p4"],
"e4": ["p4", "p4"],
"e5": ["p5", "p1"]
}
}
]
Lines
"lines": [
{
"_id": "8f8897ad-e07b-4e55-9dbe-61f6b9df85c5",
"label": "Single SOlid Line",
"attributes": {
"Color": {
"value": "Yellow"
},
}
"points": {
"p1": {"x": 0.286774, "y": 0.892502},
"p2": {"x": 0.285849, "y": 0.876888},
"p3": {"x": 0.286774, "y": 0.869081},
"p4": {"x": 0.288623, "y": 0.853878}
}
}
]
Cuboids
"cuboids": [
{
"_id": "8f8897ad-e07b-4e55-9dbe-61f6b9df85c5",
"label": "Car",
"attributes" : {
"faces_visible": {
"value": ["right","back"]
},
"Type": {
"value": "Sedan"
}
},
"points": {
"p1": {"x": 0.17,"y": 0.58},
"p2": {"x": 0.26,"y": 0.58},
"p3": {"x": 0.26,"y": 0.49},
"p4": {"x": 0.17,"y": 0.49},
"p5": {"x": 0.24,"y": 0.51},
"p6": {"x": 0.35,"y": 0.52},
"p7": {"x": 0.35,"y": 0.36},
"p8": {"x": 0.25,"y": 0.37}
},
"front": {
"coordinates": ["p1","p2","p3","p4"]
},
"side": {
"coordinates": ["p2","p3","p5","p6"]
},
"back": {
"coordinates": ["p7","p8","p5","p6"]
}
}
]
Landmarks
"landmarks": [
{
"_id": "e7e3353f-2ffe-432a-a14f-9cb9a6f4b735",
"label": "Eye",
"attributes": {
"Type": {
"value": "Open"
},
}
"points": {
"p1": { "x": 0.17, "y": 0.58, "label": 1 },
"p2": { "x": 0.26, "y": 0.63, "label": 2 },
"p3": { "x": 0.27, "y": 0.63, "label": 3 },
"p4": { "x": 0.29, "y": 0.59, "label": 4 },
"p5": { "x": 0.25, "y": 0.46, "label": 5 },
"p6": { "x": 0.22, "y": 0.42, "label": 6 }
}
}
]

‚Äč