ΣύνδεσηΕγγραφή

Enterprise API

Versioned REST API για συγχρονισμό ERP. Αυθεντικοποιηθείτε με Authorization: Bearer gcn_live_… ή gcn_test_…. Δημιουργήστε κλειδιά στον πίνακα ελέγχου της επιχείρησής σας.

Νέοι εδώ; Ξεκινήστε με την λίστα ελέγχου ένταξης συνεργατών.

Βασική διεύθυνση URL

/api/v1

Μηχανικά αναγνώσιμη OpenAPI: /api/v1/openapi

Συλλογή Postman: Λήψη / εισαγωγή

Βασικά endpoints

  • GET /me — οργανισμός + πεδία
  • GET|POST /listings, /listings/bulk
  • GET|POST /inventory, /inventory/bulk (syncMode: upsert|replace)
  • /freight, /freight/bulk · /depots, /depots/bulk · /storage, /storage/bulk · /manufacturers, /manufacturers/bulk · /ports, /ports/bulk
  • /inquiries, /inquiries/{id}/reply
  • /organization, /webhooks, /bulk/{jobId}

Πεδία

Νέα κλειδιά λαμβάνουν όλα τα πεδία. Λεπτομερής περιορισμός είναι διαθέσιμος μέσω του μοντέλου δεδομένων.

  • listings:read
  • listings:write
  • inventory:read
  • inventory:write
  • freight:read
  • freight:write
  • depots:read
  • depots:write
  • storage:read
  • storage:write
  • manufacturers:read
  • manufacturers:write
  • ports:read
  • ports:write
  • inquiries:read
  • inquiries:write
  • org:read
  • org:write
  • webhooks:manage
  • bulk:write

Γρήγορη εκκίνηση συνεργάτη

Βήμα-βήμα παραδείγματα curl για συγχρονισμό καταλόγου (όλα τα modules), ερωτήσεις και webhooks:

docs/api-partner-guide.md

Δοκιμή ετοιμότητας: /api/v1/ready

Σημειώσεις

  • Μη επαληθευμένοι οργανισμοί: οι δημιουργίες παραμένουν PENDING μέχρι να εγκριθούν από τον διαχειριστή.
  • Επαληθευμένοι οργανισμοί: Το API δημιουργεί/ενημερώνει αυτόματα δημοσιεύσεις ως ACTIVE.
  • Χρησιμοποιήστε externalId + Idempotency-Key για ασφαλή επαναλήψεις ERP.
  • Μαζικά μέγιστο 200 αντικείμενα/αίτηση; Τα webhooks επαναλαμβάνονται έως 3 φορές με backoff.
  • Τα webhooks είναι υπογεγραμμένα με HMAC (x-gcn-signature, x-gcn-timestamp).

Έλεγχος…