For the complete documentation index, see llms.txt. This page is also available as Markdown.

Orders

Order operations

Get Orders List

get

Returns a list of physical orders for the current user with pagination

Autorizaciones
Api-KeystringRequerido

API key for authentication.

Parámetros de consulta
lastOrderIdstringOpcional

ID of the last order for cursor pagination

limitinteger · máx: 50Opcional

Number of records per page (maximum 50)

Default: 50
pageintegerOpcional

Page number

Default: 1
Respuestas
200

Successful response

application/json
get/physical/orders
GET /api/v1/physical/orders HTTP/1.1
Host: tribute.tg
Api-Key: YOUR_API_KEY
Accept: */*
{
  "rows": [
    {
      "id": 12345,
      "status": "pending",
      "created": "2024-01-15T10:30:00Z",
      "fullName": "John Doe",
      "email": "john@example.com",
      "phone": "+1234567890",
      "telegramID": 123456789,
      "address": {
        "countryIso2": "US",
        "countryIso3": "USA"
      },
      "locality": "New York",
      "fullAddress": "USA, New York, 5th Avenue, 123, Apt 45",
      "customerNote": "Please call before delivery",
      "items": [
        {
          "id": 567,
          "price": 150,
          "quantity": 2,
          "currency": "usd",
          "name": "T-shirt with print",
          "attributes": {
            "size": "L",
            "color": "Black"
          }
        }
      ],
      "deliveryCost": 25.5,
      "currency": "usd"
    }
  ],
  "meta": {
    "total": 125,
    "offset": 1,
    "limit": 50
  }
}

Get Order Details

get

Returns detailed information about a specific order

Autorizaciones
Api-KeystringRequerido

API key for authentication.

Parámetros de ruta
idintegerRequerido

Order ID

Respuestas
200

Successful response

application/json
idintegerRequerido

Unique order identifier

Example: 12345
statusstring · enumRequerido

Order status

Example: pendingValores posibles:
createdstring · date-timeRequerido

Order creation date and time

Example: 2024-01-15T10:30:00Z
fullNamestringRequerido

Recipient full name

Example: John Doe
emailstring · emailRequerido

Recipient email

Example: john@example.com
phonestringRequerido

Recipient phone

Example: +1234567890
telegramIDinteger · int64Requerido

Buyer's Telegram ID

Example: 123456789
localitystringRequerido

City

Example: New York
fullAddressstringRequerido

Full delivery address

Example: USA, New York, 5th Avenue, 123, Apt 45
customerNotestringRequerido

Customer note

Example: Please call before delivery
deliveryCostnumber · floatRequerido

Delivery cost

Example: 25.5
currencystringRequerido

Order currency

Example: usd
get/physical/orders/{id}
GET /api/v1/physical/orders/{id} HTTP/1.1
Host: tribute.tg
Api-Key: YOUR_API_KEY
Accept: */*
{
  "id": 12345,
  "status": "pending",
  "created": "2024-01-15T10:30:00Z",
  "fullName": "John Doe",
  "email": "john@example.com",
  "phone": "+1234567890",
  "telegramID": 123456789,
  "address": {
    "countryIso2": "US",
    "countryIso3": "USA"
  },
  "locality": "New York",
  "fullAddress": "USA, New York, 5th Avenue, 123, Apt 45",
  "customerNote": "Please call before delivery",
  "items": [
    {
      "id": 567,
      "price": 150,
      "quantity": 2,
      "currency": "usd",
      "name": "T-shirt with print",
      "attributes": {
        "size": "L",
        "color": "Black"
      }
    }
  ],
  "deliveryCost": 25.5,
  "currency": "usd"
}

Última actualización