Poppela למפתחים ולסוכני AI
העבירו אלינו בקשה לרהיט. קבלו מחיר וקישור, ואחרי אישור הלקוח השלימו הזמנה עם מספר למעקב. הצוות שלנו מטפל בהזמנה.
מחיר וקישור — בלי התקנה
https://studio.poppela.com/api/v1/q?item=oak%20bench&w=120&d=40&h=45&m=oak&lang=enקריאת GET ציבורית יוצרת טיוטה ומחזירה priced, order_link, payments ו־next_step. אין צורך בכניסה. השתמשו במחיר ובקישור שהוחזרו. אם priced הוא false, אותו קישור מאפשר לבקש תמחור ידני.
כאשר payments הוא off, מאשרים את המפרט והמחיר ומבצעים הזמנה. שם וטלפון נדרשים; מייל, כתובת והדמיה לא חובה. הצוות מתאם תשלום, ייצור ומשלוח. פריט ללא מחיר נשאר בקשה לתמחור.
להמשיך בדפדפן
- פתחו את order_link כפי שהוחזר, כולל החלק שאחרי #. הוא מאפשר גישה לטיוטה; שמרו עליו כקישור פרטי.
- הדף פותח את העיצוב באותו דפדפן. קראו GET projects/{projectId}/quick לקבלת revisionId, priceMinor והמפרט הנוכחי. המחיר בתשובה זו הוא באגורות; ב־/q הוא בשקלים.
- לפריט ללא מחיר בלבד, אחרי אישור הלקוח שלחו POST projects/{projectId}/quick/inquiry עם contact, expectedRevisionId ו־expectedPriceMinor. שמרו את עוגיית הדפדפן ואת כותרת Origin של האתר. שגיאת 409 INQUIRY_CHANGED דורשת רענון ובדיקת הפרטים שהשתנו לפני ניסיון נוסף.
פנייה שנקלטה מחזירה status=received, inquiryId ו־charged=false. זו בקשה לחזרה מהצוות. אין לדווח שתשלום או ייצור התחילו.
כלים בדפדפן, כשיש תמיכה: poppela_get_price, poppela_order_status, poppela_customer_link, poppela_get_order_offer, poppela_place_order ו־poppela_send_inquiry. אפשר להשתמש גם בטופס הגלוי הרגיל.
השלמת הזמנה
קבלו order-offer לעיצוב והציגו ללקוח את המפרט, הסכום באגורות וזמן האספקה המשוער. אחרי אישור מפורש שלחו manual-order עם offerId, expectedTotalMinor, customerApproved=true ופרטי קשר. התשובה מכילה מספר הזמנה אמיתי, paymentStatus=pending וקישור trackingUrl פרטי. אחרי תקלה בחיבור, שלחו את אותה בקשה לקבלת אותה הזמנה.
ORDER_CHANGED או QUOTE_EXPIRED דורשים הצעה חדשה ואישור מחודש. שמרו את קישור המעקב במלואו כולל החלק שאחרי #; הוא מאפשר צפייה בלבד ועובד במכשיר אחר.
MCP
https://studio.poppela.com/mcp — Streamable HTTP
כלי העיצוב המרוחקים הם make_it_real, get_design, change_piece, draw_piece, get_order_offer, place_order ו־get_order. הם מחזירים מפתח עיצוב וקישור להמשך. תיעוד זה אינו מספק OAuth ציבורי או מפתחות bearer לסביבת האתר.
נקודות קצה
https://studio.poppela.com/api/v1 · OpenAPI 3.1
| שיטה | נתיב | פעולה |
|---|---|---|
| POST | /designs/{designId}/order-offer | Get exact total, immutable specification, offerId and expiry to approve; unpriced pieces require manual pricing. |
| POST | /designs/{designId}/manual-order | Place a real numbered order after customer approval. Team handles payment and fulfillment; no charge. Retry identical input for the same order. |
| GET | /orders/{orderId}/receipt | Read the owned order and its private read-only tracking URL. |
| POST | /orders/{orderId}/track | Read-only order tracking with the secret receipt token from the URL fragment. No cookie required; does not transfer ownership. |
| GET | /catalog | Search the inspiration catalogue by plain words in Hebrew or English. Returns pieces with category, typical material and size; no prices. |
| GET | /q | Create a furniture draft with price and a customer continuation link; no sign-in required. |
| POST | /design-links/open | Open the secret key from order_link in the browser session; returns designId and firstPiece. |
| GET | /projects/{projectId} | Read the current project and revision for picture upload. |
| POST | /projects/{projectId}/references | Upload up to 5 MiB PNG/JPEG; always needs human review |
| GET | /projects/{projectId}/quick | Read current spec, revisionId, priceMinor (ILS minor units or null), picture and payments mode. |
| POST | /projects/{projectId}/quick/picture | Use the uploaded reference and refresh its quote. A failed model check does not prevent a manual inquiry. |
| POST | /projects/{projectId}/quick/draw | Generate a picture or measured fallback. Optional for a manual inquiry. |
| POST | /projects/{projectId}/quick/text | Save pasted context, apply explicit dimensions and refresh the quote. |
| POST | /projects/{projectId}/quick/inquiry | Submit buying interest for manual team follow-up; no payment, address, account or finished picture required. |
| POST | /continue/link | Create a guest continuation link for another browser. Treat the returned URL as private. |