رفتن به محتوای اصلی

پیکربندی Webhooks

تمام پست های ایجاد شده از طریق Predis.ai API چرخه حیات دارند و حالت های مختلفی را می گیرند. حالت های احتمالی که یک پست می تواند بگیرد این است inProgress, completed و error. هنگامی که درخواستی برای ایجاد یک پست ارسال می شود، inProgress دولت در خود پاسخ اطلاع داده می شود. دو ایالت باقی مانده - completed و error از طریق وب هوک های پیکربندی شده توسط شما مطلع خواهد شد.

یک URL Webhook را تنظیم کنید

مراحل زیر را دنبال کنید تا آدرس وب هوک خود را در قسمت راه اندازی کنید API داشبورد:

  • ورود به Predis.ai نرم افزار
  • به Pricing & Account -> Rest بروید API برای باز کردن API داشبورد
  • آدرس وب هوک خود را اضافه کنید. مطمئن شوید که URL webhook یک URL عمومی است.

بارگذاری وب هوک

اگر پست به a رسیده باشد completed or error در این حالت، یک وب هوک با محموله حاوی پارامترهای زیر ارسال می شود:

completed بار دولتی

{
"status": "completed",
"caption": "...",
"post_id": "...",
"generated_media": [{"url": "..."}],
"brand_id": "..."
}

error بار دولتی

{
"status": "error",
"post_id": "..."
}
احتیاط

حتی اگر پاسخ ناموفقی از سرورهای شما دریافت کنیم، وب‌هوک را دقیقاً یک بار برای هر پست ارسال می‌کنیم. در صورتی که سرورهای شما نتوانند رویداد webhook را مدیریت کنند، می توانید داده های تمام پست های تولید شده خود را دریافت کنید. در مورد آن بیشتر بخوانید اینجا کلیک نمایید

آزمایش بر روی محیط محلی

استفاده از لوکال هاست به طور مستقیم برای دریافت حالت های هوک امکان پذیر نیست زیرا URL وب هوک باید یک URL عمومی باشد. شما می توانید با ایجاد یک تونل به سرور محلی خود با استفاده از ابزارهایی مانند ngrok. هنگام تنظیم URL وب هوک خود در داشبورد، از نقطه پایانی URL تولید شده توسط این ابزارها در URL webhook استفاده کنید.

منابع اضافی