واجهة برمجة التطبيقات لشركات الشحن الشريكة

POST /api/partner/sourcing HTTP/1.1
Host: kuaisourcing.com
Content-Type: application/json
x-api-key: ks_live_yourkeyhere1234567890abcdef

{
  "productName": "Bluetooth Earbuds Pro",
  "productImageUrl": "https://yourcdn.com/img.jpg",
  "productURL": "https://supplier-page.example/product/123",
  "category": "Electronics",
  "targetMarket": "Africa",
  "additionalNotes": "Need OEM packaging",

  "airFreight": true,
  "seaFreight": false,
  "byTrain": false,
  "expressDelivery": false,
  "normalDelivery": true,
  "domesticDelivery": "slow",
  "shippingResponsibility": "kuai",

  "destinations": [
    {
      "country": "Gabon",
      "city": "Libreville",
      "address": "1 Example Street",
      "quantity": 50,
      "variants": "[{\"color\":\"Black\",\"quantity\":30},{\"color\":\"White\",\"quantity\":20}]",
      "service": "DHL",
      "recipientName": "Jane Doe",
      "contactNumber": "+241 00 00 00 00"
    },
    {
      "country": "Tunisia",
      "city": "Tunis",
      "quantity": 30,
      "service": "Other ...",
      "customService": "Local forwarder name",
      "recipientName": "John Doe",
      "contactNumber": "+216 00 000 000",
      "isCompanyService": false
    }
  ]
}

{
  "success": true,
  "data": {
    "orderId": "9f5e2c3a-...",
    "customOrderId": "KS0000",
    "message": "Sourcing request submitted successfully"
  }
}

{
  "success": true,
  "data": {
    "id": "9f5e2c3a-...",
    "customOrderId": "KS0000",
    "productName": "Bluetooth Earbuds Pro",
    "status": "Unpaid",
    "formCreationDate": "2026-05-10T08:14:32",
    "lastUpdated": "2026-05-13T11:02:08",
    "realImages": [
      { "id": "...", "image": "https://files.example.com/uploads/real-1.jpg",  "addedAt": "2026-05-13T10:55:00" },
      { "id": "...", "image": "https://files.example.com/uploads/demo.mp4",   "addedAt": "2026-05-13T11:00:00" }
    ],
    "destinations": [
      {
        "id": "d4...",
        "country": "Gabon",
        "city": "Libreville",
        "quantity": 50,
        "service": { "name": "DHL", "recipientName": "Jane Doe" },
        "quotation": {
          "totalCost": 1840.00,
          "unitPrice": 35.00,
          "internationalShippingCost": 90.00,
          "deliveryCostInChina": 70.00,
          "extraFees": 0.00
        }
      }
    ]
  }
}

curl -X POST https://kuaisourcing.com/api-back/api/partner/uploads \
  -H "x-api-key: $KEY" \
  -F "file=@receipt.pdf" \
  -F "purpose=proof-of-payment"

# Response
{
  "success": true,
  "data": {
    "url": "https://files.example.com/uploads/receipt.pdf",
    "size": 27695,
    "contentType": "application/pdf"
  }
}

{
  "country": "Gabon",
  "url": "https://files.example.com/uploads/receipt.pdf",
  "paymentNote": "Bank transfer EUR to USD, reference KS0000"
}

{
  "success": true,
  "data": [
    { "id": "00000000-0000-4000-8000-000000000001", "name": "Example Freight Co", "countries": ["Morocco"] },
    { "id": "00000000-0000-4000-8000-000000000002", "name": "Sample Logistics",   "countries": ["Senegal", "Madagascar"] },
    { "id": "00000000-0000-4000-8000-000000000003", "name": "Demo Shipping Line", "countries": ["Spain"] }
  ]
}

HTTP 400 Bad Request
{
  "success": false,
  "data": null,
  "error": "destinations: At least one destination is required",
  "timestamp": "2026-05-18T11:42:03.581"
}