API دبیر کلود

                        curl -X POST {{BASE}}/articles \
                        -H "Authorization: Bearer dbc_YOUR_TOKEN" \
                        -H "Content-Type: application/json" \
                        -d '{"title":"گاندولا چیست و چه کاربردی دارد؟","keyword":"گاندولا","with_images":true}'

                        curl {{BASE}}/articles/42 -H "Authorization: Bearer dbc_YOUR_TOKEN"
                    

Authorization: Bearer dbc_YOUR_TOKEN
Accept: application/json

                        {
                        "message": "The title field is required.",
                        "errors": { "title": ["The title field is required."] }
                        }
                    

                        {
                        "success": true,
                        "project_id": 7,
                        "api_token": "dbc_…",
                        "webhook_secret": "whsec_…"
                        }
                    

                        {
                        "type": "article",
                        "title": "راهنمای کامل خرید قفسه‌ی فروشگاهی",
                        "keyword": "قفسه فروشگاهی",
                        "tone": "professional",
                        "word_count": 1500,
                        "with_images": true,
                        "image_style": "product_photo",
                        "image_size": "1536x1024",
                        "publish_at": "2026-10-25T09:00:00+03:30"
                        }
                    

                        {
                        "data": {
                        "id": 42,
                        "type": "article",
                        "status": "done",
                        "title": "…",
                        "keyword": "…",
                        "source_url": null,
                        "error": null,
                        "tokens": 2913,
                        "generated_at": "2026-10-19T08:21:00+00:00",
                        "publish_at": null,
                        "delivered_at": "2026-10-19T08:21:05+00:00",
                        "remote_post_id": "131",
                        "remote_url": "https://example.com/blog/…",
                        "created_at": "…",
                        "article": {
                        "content": "<h2>…</h2>… (with visible FAQ)",
                        "content_without_faq": "… (if your theme renders faq itself)",
                        "css": "… (rich output only)",
                        "html": "<style>…</style> + content — ready to paste",
                        "output_mode": "rich",
                        "faq_schema": "<script type=\"application/ld+json\">…</script>",
                        "meta_description": "…",
                        "slug": "…",
                        "category": "…",
                        "faq": [{ "question": "…", "answer": "…" }],
                        "featured_image": { "url": "https://…/media/…webp", "alt": "…" },
                        "images": [{ "url": "…", "alt": "…" }]
                        }
                        }
                        }
                    

                        { "success": true, "usage": { "total": 24, "done": 15, "review": 3, "pending": 2, "failed": 4,
                        "tokens": 70210, "tokens_this_month": 21900 } }
                    

                        { "success": true, "titles": ["…", "…", "…"] }
                    

                        POST /your-webhook
                        Content-Type: application/json
                        X-Dabir-Event: article.completed
                        X-Dabir-Timestamp: 1760862000
                        X-Dabir-Signature: sha256=5f1c…

                        {"event":"article.completed","data":{ …article object… }}
                    

                        $secret = getenv('DABIR_WEBHOOK_SECRET');
                        $body   = file_get_contents('php://input');
                        $ts     = $_SERVER['HTTP_X_DABIR_TIMESTAMP'] ?? '';
                        $sig    = $_SERVER['HTTP_X_DABIR_SIGNATURE'] ?? '';

                        $expected = 'sha256=' . hash_hmac('sha256', $ts . '.' . $body, $secret);
                        if (!ctype_digit($ts) || abs(time() - (int)$ts) > 300 || !hash_equals($expected, $sig)) {
                        http_response_code(401);
                        exit;
                        }

                        $payload = json_decode($body, true);
                        if ($payload['event'] === 'article.completed') {
                        $article = $payload['data']['article'];
                        // save $payload['data']['title'], $article['content'], $article['meta_description'] …
                        }
                        http_response_code(200);
                    

                        import crypto from 'node:crypto';

                        // use the RAW body (express.raw({ type: 'application/json' }))
                        function verify(rawBody, ts, sig, secret) {
                        const expected = 'sha256=' + crypto.createHmac('sha256',
                        secret).update(`${ts}.${rawBody}`).digest('hex');
                        const fresh = Math.abs(Date.now() / 1000 - Number(ts)) <= 300;
                        return fresh && sig.length === expected.length &&
                        crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected));
                        }