marketplace
POST /v1/marketplace/listings/{listing_id}/enquiries
Ask a seller a question before buying.
אימות
שלח מפתח API כטוקן Bearer. נקודת קצה זו אינה מציינת הרשאת ספציפית במפרט, לכן הקצה למפתח שלך את המינימום הנדרש ובדוק את התגובה במקום להניח הנחות.
המקום שבו מזהה הארגון שלך נכנס
נקודת קצה זו מקבלת את org_id כפרמטר שאילתת חיפוש. השאר אותו ריק והקריאה תכסה את כל תת-עץ הדיירות שלך; שלח אותו כדי לצמצם את הקריאה לארגון אחד.
מזהה הארגון שלך נמצא במסוף מפתחות ה-API בלוח הבקרה שלך, לצד המפתח עצמו. זהו אותו מזהה בכל קריאה שאתה מבצע.
נסה זאת
החלף כל דבר בסוגריים זוויתיים בערכים משלך, ואת מציין מיקום המפתח במפתח מלוח הבקרה שלך.
curl -X POST https://api.zinndigital.com/v1/marketplace/listings/{listing_id}/enquiries \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "body": <string> }'מחובר? קונסולת ה-API בלוח הבקרה שלך מזינה את מזהה הארגון האמיתי שלך ואת המפתח שלך, ומריצה את הבקשה מול ה-API הפיזי כך שתוכל לראות את התגובה בפועל. פתח נקודת קצה זו במסוף ה-API
פרטים
docs/133 D26. **Attachments are refused here entirely**: an attachment bypasses text scanning, we have no OCR, and on the one surface where nobody has paid there are therefore no files. Saying so is honest; scanning an image we cannot read would not be.
פרמטרים
| שם | סוג | נדרש | מה זה |
|---|---|---|---|
listing_id (path) | string | כן | — |
org_id (query) | string | לא | Which of your organizations the enquiry is from. Optional when you belong to exactly one; **required (422) when you belong to more than one**, because the platform will not gues… |
גוף הבקשה
| שם | סוג | נדרש | מה זה |
|---|---|---|---|
body | string | כן | — |
locale | string | לא | — |
attachments | object[] | לא | Refused entirely on a pre-sales thread: an attachment bypasses text scanning and we have no OCR, so on the one surface where nobody has paid there are no files. |
תשובה
| שם | סוג | נדרש | מה זה |
|---|---|---|---|
id | string | כן | — |
body | string | כן | What the reader sees — the masked form where the policy masked it. The original is always kept in the order record and is what a dispute reads; it is not in this payload, becaus… |
mine | boolean | כן | — |
from_staff | boolean | לא | — |
source_locale | string | לא | BCP-47. Participants write in their own language; a message is translated FOR THE READER and the original is always shown, never replaced. |
masked | boolean | לא | — |
policy_notice | string | לא | A message KEY, rendered in every locale by the client. Set only for the SENDER of a masked message — telling the recipient "they tried to give you an email address" would be an… |
held | boolean | לא | Only on the send response. The one case where reporting "sent" would be a lie. |
created_at | string | כן | — |
שגיאות שנקודה קצה זו עשויה להחזיר
401 · 404 · 422