Couriero Backend Api (1.0.0)

Download OpenAPI specification:Download

The Couriro Backend API

Authentication

Bearer

Api token pleaced into the header to allow access to the api service Authorization Bearer api_token

Security Scheme Type Authorization

awb

Operations related to the AWB

/generate_awb

Generate AWBs, place shipment orders

Authorizations:
header Parameters
Authorization
required
string <Bearer>

Api token pleaced into the header to allow access to the api service Authorization Bearer api_token

Request Body schema: application/json
courier_id
integer

The selected courier

order_id
string

The order identifier

order_total
number

Order total value

order_total_currency_code
string

Order currency code (eg. RON, EUR, USD etc.)

object

The AWB details

Responses

Request samples

Content type
application/json
{
  • "courier_id": 0,
  • "order_id": "string",
  • "order_total": 0,
  • "order_total_currency_code": "string",
  • "awb_details": {
    }
}

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string",
  • "data": {
    }
}

/get_estimate_cost

Get cost estimation

Authorizations:
None
header Parameters
Authorization
required
string <Bearer>

Api token pleaced into the header to allow access to the api service Authorization Bearer api_token

Request Body schema: application/json
courier_id
integer

The selected courier

service
string

The selected service

destination_locality
string

The destination locality

destination_county
string

The destination county

envelopes
number

Number of envelopes

parcels
number

Number of parces

payment_of_shipment
string

Who pays for the shipment (sender / receiver)

length
string

Lenght

width
string

Width

height
string

Heigh

declared_value
string

Shipment delcared value

payment_for_reimbursment
string

Who pays for reimbursement

options
string

Aditonal options depending on the courier service

reimbursement
string

Reimbursement value

other_details
object

Other details that the courier accepts (properties that can be sent directly to the courier)

Responses

Request samples

Content type
application/json
{
  • "courier_id": 0,
  • "service": "string",
  • "destination_locality": "string",
  • "destination_county": "string",
  • "envelopes": 0,
  • "parcels": 0,
  • "payment_of_shipment": "string",
  • "length": "string",
  • "width": "string",
  • "height": "string",
  • "declared_value": "string",
  • "payment_for_reimbursment": "string",
  • "options": "string",
  • "reimbursement": "string",
  • "other_details": { }
}

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string",
  • "data": {
    }
}

/order_status

Get last AWB status

Authorizations:
None
header Parameters
Authorization
required
string <Bearer>

Api token pleaced into the header to allow access to the api service Authorization Bearer api_token

Request Body schema: application/json
courier_id
integer

The selected courier

awb
string

The awb number

Responses

Request samples

Content type
application/json
{
  • "courier_id": 0,
  • "awb": "string"
}

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string",
  • "data": {
    }
}

/delete_order

Delete the awb order

Authorizations:
None
header Parameters
Authorization
required
string <Bearer>

Api token pleaced into the header to allow access to the api service Authorization Bearer api_token

Request Body schema: application/json
courier_id
integer

The selected courier

awb
string

The awb number

Responses

Request samples

Content type
application/json
{
  • "courier_id": 0,
  • "awb": "string"
}

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string",
  • "data": "string"
}

/get_awb

Get the AWB label

Authorizations:
None
header Parameters
Authorization
required
string <Bearer>

Api token pleaced into the header to allow access to the api service Authorization Bearer api_token

Request Body schema: application/json
courier_id
integer

The selected courier

awb
string

The awb number

html
integer
Enum: 0 1

The html

Responses

Request samples

Content type
application/json
{
  • "courier_id": 0,
  • "awb": "string",
  • "html": 0
}

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string",
  • "data": {
    }
}

location_service

Operations related to location service

/get_localities

Get full list of localities

Authorizations:
None
header Parameters
Authorization
required
string <Bearer>

Api token pleaced into the header to allow access to the api service Authorization Bearer api_token

Request Body schema: application/json
api_key
string

The api key

api_secret
string

The api secret

courier_id
integer

The selected courier

Responses

Request samples

Content type
application/json
{
  • "api_key": "string",
  • "api_secret": "string",
  • "courier_id": 0
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "county": "string",
  • "city": "string",
  • "agency": "string",
  • "km": 0
}

/get_geolocations

Get the geolocation for postal code

Authorizations:
None
header Parameters
Authorization
required
string <Bearer>

Api token pleaced into the header to allow access to the api service Authorization Bearer api_token

Request Body schema: application/json
courier_id
integer

The selected courier

postal_code
string

The postal code

Responses

Request samples

Content type
application/json
{
  • "courier_id": 0,
  • "postal_code": "string"
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "county": "string",
  • "city": "string",
  • "street": "string",
  • "from": "string",
  • "to": "string",
  • "postal_code": "string",
  • "agency": "string"
}

/export_geolocations

Get all geolocations for importing using the platform plug

Authorizations:
None
header Parameters
Authorization
required
string <Bearer>

Api token pleaced into the header to allow access to the api service Authorization Bearer api_token

Request Body schema: application/json
courier_id
integer

The selected courier

Responses

Request samples

Content type
application/json
{
  • "courier_id": 0
}

Response samples

Content type
application/json
[
  • {
    }
]

courier

Courier information

/get_services

Get the services supported by the courier

Authorizations:
None
header Parameters
Authorization
required
string <Bearer>

Api token pleaced into the header to allow access to the api service Authorization Bearer api_token

Request Body schema: application/json
courier_id
integer

The selected courier

Responses

Request samples

Content type
application/json
{
  • "courier_id": 0
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string"
}

token

/generate_token

Generate token for the subscription

Authorizations:
None
Request Body schema: application/json
id
integer

The user id

subscription_id
integer

The subscription id

Responses

Request samples

Content type
application/json
{
  • "id": 0,
  • "subscription_id": 0
}

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string",
  • "data": {
    }
}

/validate_token

Validates token and registers the domain

Authorizations:
None
Request Body schema: application/json
token
string

The subscription token

Responses

Request samples

Content type
application/json
{
  • "token": "string"
}

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string",
  • "data": { }
}

/validate_domain

Checks if token is connected to domain

Authorizations:
None
Request Body schema: application/json
token
string

The subscription token

Responses

Request samples

Content type
application/json
{
  • "token": "string"
}

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string",
  • "data": { }
}

/disconnect_token

Disconnects domain from token

Authorizations:
None
Request Body schema: application/json
token
string

The subscription token

Responses

Request samples

Content type
application/json
{
  • "token": "string"
}

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string",
  • "data": { }
}