# Atlas API v2.1 (черновик)

**URL:** `https://api.atlas.internal/v2` (пока только staging)  
**Формат:** JSON  
**Токен:** Bearer, выдаём руками

## Resources

### Shipments

#### `GET /shipments`

Список отправлений с фильтрацией.

**Query params:**

| Param | Type | Description |
|-------|------|-------------|
| `status` | enum | `pending`, `in_transit`, `delivered` |
| `from` | date | Начало периода |
| `to` | date | Конец периода |
| `page` | int | Номер страницы |

**Response:**

```json
{
  "data": [
    {
      "id": "shp_001",
      "origin": "Moscow",
      "destination": "Berlin",
      "status": "in_transit",
      "eta": "2026-06-22T14:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "total": 847
  }
}
```

#### `POST /shipments`

Создание отправления.

**Body:**

```json
{
  "origin": "Moscow",
  "destination": "Berlin",
  "weight_kg": 1250,
  "cargo_type": "electronics"
}
```

### Analytics

#### `GET /analytics/throughput`

Пропускная способность по хабам.

**Response:**

```json
{
  "hubs": [
    {"name": "Warsaw", "throughput_tpd": 340},
    {"name": "Prague", "throughput_tpd": 210}
  ],
  "period": "2026-06"
}
```

## Error format

```json
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "weight_kg must be positive",
    "field": "weight_kg"
  }
}
```

## Rate limits

100 req/min per client_id.