التجربة الجافة ووضع الاختبار

ينفّذ POST /v1/posts?dry_run=true فحوص نشر حقيقي: قواعد كل شبكة، والحساب المتصل، والوسائط، والتاريخ، وباقتك. ولا يخزّن شيئًا ولا يرسل شيئًا.

جاهز

عندما ستقبل كل شبكة المنشور، يكون الجواب 200 مع status: "ready" ومعه، لكل هدف، الحساب الذي سينشر.

مرفوض

وإلا يكون الجواب 422 post_refused، مع تفصيل لكل سبب. يسمّي كل تفصيل شبكته وcode الخاص به، ويقول ما يجب إصلاحه.

{
  "error": {
    "code": "post_refused",
    "message": "The post would not be published: x: the text is too long (300 characters, at most 280)",
    "details": [
      {
        "platform": "x",
        "code": "caption_too_long",
        "max": 280,
        "actual": 300,
        "message": "x: the text is too long (300 characters, at most 280)"
      }
    ],
    "docUrl": "https://www.sofia-post.com/developers/errors#post_refused"
  }
}

كل الأسباب مسرودة في الأخطاء.

وضع الاختبار

التطبيق المنشأ بوضع الاختبار (رموز sofia_test_at_…) يقرأ مساحة عملك الحقيقية لكنه لا يكتب فيها أبدًا: تُحاكى منشوراته وتُحكم بالقواعد نفسها، وأي كتابة حقيقية تُجاب بـ 403 live_mode_required. المفاتيح والعملاء المنشأون في الإعدادات › API هم في الوضع الحي؛ استخدم التجربة الجافة للتحقق دون نشر.