Courier tracking links

The method returns courier tracking links.

Request

GET

b2b.taxi.yandex.net/b2b/cargo/integration/v2/claims/tracking-links

Service URL

Query parameters

Name

Description

claim_id*

Type: string

Claim ID received at the claim creation stage

Min length: 32

Max length: 64

Responses

200 OK

Courier tracking links

Body

application/json
{
    "route_points": [
        {
            "id": 1,
            "type": "source",
            "visit_order": 1,
            "sharing_link": "string"
        }
    ]
}

Name

Description

route_points*

Type: PointWithSharingLink[]

Route points with tracking links

Name

Description

id*

Type: integer<int64>

Integer point ID (int64)

Example: 1

type*

Type: PointType

Point type:

  • source: the point of departure where the courier picks up the item
  • destination: destination points where the courier delivers the items
  • return: item return point (added automatically and matches the point of departure by default, but a different point can also be selected)

Example: source

Enum: source, destination, return

visit_order*

Type: integer<int64>

The order in which the points are visited (numbering starts with 1) (int64)

Example: 1

sharing_link

Type: string

Route tracking link. Available
only for destination points

PointType

Point type:

  • source: the point of departure where the courier picks up the item
  • destination: destination points where the courier delivers the items
  • return: item return point (added automatically and matches the point of departure by default, but a different point can also be selected)

Type

Description

PointType

Example: source

Enum: source, destination, return

404 Not Found

Claim not found

Body

application/json
{
    "code": "not_found",
    "message": "Claim not found"
}

Name

Description

code*

Type: string

Error code

Example: not_found

Enum: not_found

message*

Type: string

Error description

Example: Claim not found

409 Conflict

Inactive claim or no courier tracking links

Body

application/json
{
    "code": "inappropriate_status",
    "message": "Invalid action regarding the claim"
}

Name

Description

code*

Type: string

Error code

Example: inappropriate_status

Enum: unknown_tracking_links, inappropriate_status

message*

Type: string

The person understood the error message

Example: Invalid action regarding the claim

429 Too Many Requests

Too many requests

Body

application/json
{
    "code": "too_many_requests",
    "message": "Too many requests"
}

Name

Description

code*

Type: string

Error code

Example: too_many_requests

Enum: too_many_requests

message*

Type: string

Error description

Example: Too many requests