Τεκμηρίωση B2B

B2B API – αυτοματοποιημένη ανάκτηση πληροφοριών παραγγελιών και προϊόντων

Το REST API μας είναι διαθέσιμο σε κάθε πελάτη με λογαριασμό πελάτη και επιτρέπει την αυτοματοποιημένη ανάκτηση πληροφοριών παραγγελιών και προϊόντων και την ενσωμάτωσή τους σε δικά σας συστήματα.

vpn_key Άνοιγμα πρόσβασης API στον λογαριασμό Σελίδα επιχειρηματικών πελατών

Πιστοποίηση

Όλα τα αιτήματα API απαιτούν ένα έγκυρο API-Key, το οποίο αποστέλλεται στο HTTP-Header. Η πρόσβαση API είναι συνδεδεμένη με τον λογαριασμό πελάτη σας και είναι κατ' αρχήν διαθέσιμη σε λογαριασμούς πελατών.

info Δεν χρειάζεστε ξεχωριστή αίτηση B2B: Συνδεθείτε με τον λογαριασμό πελάτη σας, ανοίξτε το tab API και δημιουργήστε εκεί το API-Key σας. Προς την πρόσβαση API →

Μορφή Header

HTTP Request Header

X-API-Key: YOUR_API_KEY_HERE
Content-Type: application/json
Accept: application/json

Παράδειγμα με cURL

cURL

curl -X GET "https://artumos.com/api/v1/orders" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -H "Accept: application/json"

Base URL

Όλα τα endpoints είναι σχετικά με το ακόλουθο Base URL:

Base URL

https://artumos.com/api/v1

Όλες οι απαντήσεις επιστρέφονται ως JSON επιστρέφονται (Content-Type: application/json).

Rate Limits

Plan	Αιτήματα / λεπτό	Αιτήματα / ημέρα
Λογαριασμός πελάτη	60	5.000
Διευρυμένο όριο	κατόπιν αιτήματος	κατόπιν αιτήματος

Σε περίπτωση υπέρβασης επιστρέφεται HTTP 429 Too Many Requests επιστρέφεται. Το Header Retry-After περιέχει τον χρόνο αναμονής σε δευτερόλεπτα.

Κωδικοί σφαλμάτων

HTTP-Code	Σημασία
`200 OK`	Το αίτημα ήταν επιτυχές
`400 Bad Request`	Μη έγκυρες παράμετροι
`401 Unauthorized`	Ελλιπές ή μη έγκυρο API-Key
`403 Forbidden`	Καμία εξουσιοδότηση για αυτόν τον πόρο
`404 Not Found`	Ο πόρος δεν βρέθηκε
`429 Too Many Requests`	Υπέρβαση Rate Limit
`500 Internal Server Error`	Σφάλμα διακομιστή – παρακαλούμε επικοινωνήστε με την υποστήριξη

Μορφή Response σφάλματος

JSON

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key."
  }
}

Endpoint: Παραγγελίες

GET /api/v1/orders Όλες οι παραγγελίες του λογαριασμού

Parameter	Τύπος	Περιγραφή
`page`	integer	Σελίδα (προεπιλογή: 1)
`per_page`	integer	Καταχωρίσεις ανά σελίδα (max. 100)
`status`	string	`paid` \| `pending` \| `all`

Beispiel-Response

{
  "success": true,
  "data": {
    "orders": [
      {
        "id": "ORD-12345",
        "status": "paid",
        "total": 49.99,
        "currency": "EUR",
        "created_at": "2026-01-15T10:30:00Z",
        "items_count": 2
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 20,
      "total": 42
    }
  }
}

GET /api/v1/orders/{order_id} Ανάκτηση μεμονωμένης παραγγελίας

Endpoint: Πληροφορίες προϊόντων και παραγγελιών

GET /api/v1/orders/{order_id}/codes Όλες οι πληροφορίες προϊόντων μιας παραγγελίας

Beispiel-Response

{
  "success": true,
  "data": {
    "order_id": "ORD-12345",
    "codes": [
      {
        "id": "CODE-789",
        "product_name": "Beispielprodukt vom Marktplatz",
        "product_sku": "ART-PRODUCT-001",
        "product_info": "Hinweise laut Verkäuferangaben",
        "delivery_url": "https://...",
        "delivered_at": "2026-01-15T10:31:00Z",
        "status": "active"
      }
    ]
  }
}

GET /api/v1/codes/{code_id} Ανάκτηση μεμονωμένης πληροφορίας προϊόντος

warning Οι πληροφορίες προϊόντων και παραγγελιών επιτρέπεται να χρησιμοποιούνται μόνο στο πλαίσιο της εκάστοτε παραγγελίας και των στοιχείων πωλητή. Η καταχρηστική διαβίβαση μπορεί να παραβιάζει τους όρους χρήσης.

Endpoint: Προϊόντα

GET /api/v1/products Ανάκτηση καταλόγου προϊόντων

Parameter	Τύπος	Περιγραφή
`category`	string	Φιλτράρισμα κατά slug κατηγορίας
`in_stock`	boolean	Μόνο διαθέσιμα προϊόντα
`page`	integer	Σελίδα

Beispiel-Response

{
  "success": true,
  "data": {
    "products": [
      {
        "id": 42,
        "sku": "ART-PRODUCT-001",
        "name": "Beispielprodukt vom Marktplatz",
        "price": 49.99,
        "currency": "EUR",
        "in_stock": true,
        "category": "handmade"
      }
    ]
  }
}

Webhooks

Τα Webhooks επιτρέπουν τη λήψη ειδοποιήσεων σε πραγματικό χρόνο όταν παρέχονται παραγγελίες ή codes. Τα Webhook-URLs μπορούν να καταχωριστούν στον λογαριασμό πελάτη.

Διαθέσιμα Events

Event	Περιγραφή
`order.paid`	Η παραγγελία πληρώθηκε
`codes.delivered`	Τα codes παρασχέθηκαν
`order.refunded`	Η παραγγελία επιστράφηκε

Webhook Payload

POST – Το Webhook-Endpoint σας

{
  "event": "codes.delivered",
  "timestamp": "2026-01-15T10:31:05Z",
  "data": {
    "order_id": "ORD-12345",
    "codes_count": 2
  },
  "signature": "sha256=..."
}

Επαληθεύστε την υπογραφή με το Webhook-Secret σας: HMAC-SHA256(payload, webhook_secret)

Συχνές ερωτήσεις

Ποιος μπορεί να χρησιμοποιήσει το B2B API;

Κάθε πελάτης με λογαριασμό πελάτη μπορεί να χρησιμοποιήσει την πρόσβαση API. Συνδεθείτε στον λογαριασμό πελάτη σας και χρησιμοποιήστε το αντίστοιχο API-Key για πιστοποιημένα αιτήματα.

Ποια μορφή έχουν οι απαντήσεις;

Όλες οι απαντήσεις επιστρέφονται ως JSON. Το Root-Object περιέχει πάντα success: true/false καθώς και είτε data είτε error.

Μπορώ να κάνω παραγγελίες μέσω API;

Στην πρώτη έκδοση, το API εξυπηρετεί την ανάκτηση παραγγελιών, πληροφοριών παραγγελιών και προϊόντων. Τα endpoints εγγραφής παραγγελιών θα ενεργοποιηθούν ξεχωριστά μόλις είναι διαθέσιμα.

Υπάρχει περιβάλλον Sandbox;

Ναι. Το Sandbox μπορεί να ενεργοποιηθεί στον λογαριασμό πελάτη στο tab „Πρόσβαση API“ και είναι συνδεδεμένο απευθείας με το εκάστοτε API-Key.