Χτίστε με το Pico

Γρήγορη εκκίνηση

1. 1
   Ξεκινήστε το API

   Τρέξτε το API στο http://localhost:8000 και κάντε seed με php artisan migrate --seed.

2. 2
   Ανοίξτε το sandbox

   Χρησιμοποιήστε το sandbox ή καλέστε απευθείας τα widget endpoints.

3. 3
   Συνδεθείτε ως έμπορος

   Dashboard στο http://localhost:3000 με owner@pico.test / password.

Η δημόσια ροή του widget χρησιμοποιεί τρεις κλήσεις:

# 1. Fetch widget configuration (public, no auth)
curl http://localhost:8000/api/v1/widget/config/pw_sandbox_demo_widget_001

# 2. Start a shopper session
curl -X POST http://localhost:8000/api/v1/widget/sessions \
  -H "Content-Type: application/json" \
  -d '{"public_widget_id":"pw_sandbox_demo_widget_001","locale":"en"}'

# 3. Send a message
curl -X POST http://localhost:8000/api/v1/widget/sessions/<session_id>/messages \
  -H "Content-Type: application/json" \
  -d '{"message":"Waterproof hiking boots under 150"}'

Ενσωμάτωση widget

<script type="module" src="https://cdn.example.com/pico-widget.js"
  data-public-widget-id="pw_sandbox_demo_widget_001"
  data-api-url="http://localhost:8000/api/v1"></script>

Το widget αποδίδεται σε Shadow DOM ώστε τα στυλ του site να μην το σπάνε. Το add-to-cart εμφανίζεται μόνο όταν το συνδεδεμένο κατάστημα δηλώνει το capability add_to_cart.

Οδηγός sandbox

Το sandbox είναι ξεκάθαρα μη παραγωγικό περιβάλλον με mock κατάστημα και δείγματα outdoor προϊόντων.

• Ανώνυμα: εισάγετε το demo widget ID pw_sandbox_demo_widget_001 και συνομιλήστε.
• Συνδεδεμένοι: το sandbox φορτώνει το δικό σας sandbox κατάστημα μέσω GET /sandbox/config.
• Κάθε αίτημα και απάντηση εμφανίζεται ως JSON ώστε να βλέπετε ακριβώς τι επιστρέφει το API.
• Τίποτα εδώ δεν αγγίζει πραγματικές παραγγελίες, πληρωμές ή καταλόγους παραγωγής.

Μορφή σφαλμάτων

Κάθε σφάλμα χρησιμοποιεί HTTP status και το ίδιο JSON body. Καταγράφετε πάντα το request_id όταν αναφέρετε πρόβλημα.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The request could not be validated.",
    "details": { "message": ["The message field is required."] },
    "request_id": "req_01HXYZ..."
  }
}

details Το details μπορεί να περιέχει σφάλματα πεδίων και ποτέ δεν περιέχει μυστικά ή stack traces.

Οδηγοί ενσωμάτωσης

Συνδέστε το Pico με την πλατφόρμα commerce σας. Οι οδηγοί καλύπτουν διαπιστευτήρια, sync και storefront embed.