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