API மூலம் வெளியிடுதல் எந்த வலைத்தளத்திலும்.

/ கண்ணோட்டம்

இது எப்படி வேலை செய்கிறது

ஒரு keyword-க்கான கட்டுரையை Orova எழுதி முடித்ததும், நீங்கள் பதிவுசெய்த endpoint URL-க்கு ஒரே ஒரு HTTP POST request அனுப்புகிறது. Request body JSON ஆகும், முழுக் கட்டுரையும் அதில் இருக்கும். உங்கள் endpoint உங்கள் பக்கத்தில் பதிவை உருவாக்கி, கட்டுரையின் இறுதிப் பொது URL-உடன் பதிலளிக்கிறது. WordPress பதிவைப் போலவே, Orova அந்த URL-ஐ வெளியிடப்பட்ட இணைப்பாகச் சேமிக்கிறது. WordPress அல்லாத தளத்தில் கைவேலையின்றி வெளியிட விரும்பும்போது, அல்லது பதிவுகள் எப்படிச் சேமிக்கப்படுகின்றன என்பதில் முழுக் கட்டுப்பாடு வேண்டும்போது இதைப் பயன்படுத்துங்கள்.

/ அமைப்பு

அமைத்தல் — ஆறு படிகள்

• 1

  உங்கள் project-இல் “API மூலம் இணை” என்பதை இயக்குங்கள். உங்கள் project-ஐத் திறவுங்கள் (Projects → உங்கள் project → Connections). WordPress அட்டைக்கு அருகில் API மூலம் இணை அட்டை உள்ளது. உங்கள் endpoint-இன் URL-ஐ அங்கே உள்ளிடுங்கள். Secret key புலம் விருப்பத்தேர்வு: காலியாக விட்டால் Orova ஒன்றை உருவாக்கும், அல்லது உங்கள் தளம் ஏற்கெனவே பயன்படுத்தும் key-ஐ ஒட்டலாம். சேமித்ததும், key ஒரு நகலெடு பொத்தானுடன் அட்டையில் காட்டப்படும். ஒரு project ஒரே இலக்குக்கு மட்டுமே வெளியிடும் — API மூலம் இணைத்தால் WordPress பொத்தான் பூட்டப்படும், அதேபோல் மறுதலையாகவும்.

• 2

  POST ஏற்கும் endpoint-ஐ உருவாக்குங்கள். உங்கள் தளம் அல்லது சர்வரில், JSON body கொண்ட HTTP POST-க்குக் காத்திருக்கும் ஒரு route-ஐ உருவாக்குங்கள். Project Connections திரையில் நீங்கள் ஒட்டும் URL இதுவே. முடிக்கும் ஒவ்வொரு கட்டுரைக்கும் Orova அதை ஒருமுறை அழைக்கிறது.

• 3

  ஒவ்வொரு request-இலும் Bearer token-ஐச் சரிபாருங்கள். Orova-விலிருந்து வரும் ஒவ்வொரு request-உம் “Bearer <secret>” வடிவில் Authorization header-ஐக் கொண்டிருக்கும், உங்கள் project-இல் காட்டப்படும் அதே secret key-உடன். அதை நீங்கள் சேமித்த நகலுடன் ஒப்பிட்டு, பொருந்தாத எதையும் நிராகரியுங்கள் — வேறு யாரும் உங்கள் தளத்தில் பதிவிடுவதைத் தடுப்பது இதுதான்.

• 4

  Payload-இலிருந்து கட்டுரையை உருவாக்குங்கள். JSON body-ஐப் படித்து உங்கள் CMS அல்லது database-இல் ஒரு பதிவை உருவாக்குங்கள்: கட்டுரைக்கு title, slug மற்றும் content_html, meta description-ஆக excerpt, cover படமாக featured_image_url, metadata-ஆக keyword / lang / published_at பயன்படுத்துங்கள்.

• 5

  கட்டுரையின் நேரடி URL-ஐத் திருப்பி அனுப்புங்கள். HTTP 200 அல்லது 201 மற்றும் { "url": "https://yoursite.com/the-new-article" } என்ற JSON body-உடன் பதிலளியுங்கள். Orova அந்த URL-ஐக் கட்டுரையின் வெளியிடப்பட்ட இணைப்பாகச் சேமிக்கிறது. 2xx அல்லாத நிலையைத் திருப்பினால், அல்லது url புலத்தைத் தவிர்த்தால், Orova வெளியீடு தோல்வியடைந்ததாகக் கருதும்.

• 6

  Optimize engine-இன் புதுப்பிப்பு request-களைக் கையாளுங்கள். Body-இல் action = "update" இருந்தால், target_url (அல்லது slug) மூலம் ஏற்கெனவே உள்ள பதிவைக் கண்டறிந்து, அதன் title, content_html மற்றும் excerpt-ஐ அதே இடத்தில் மேலெழுதுங்கள் — URL-ஐ மாற்ற வேண்டாம். அதே பதிவைச் சுட்டும் { "url": ... } உடன் 200 பதிலளியுங்கள். இதை இன்னும் கையாளாத endpoint-களில் Orova optimization தோல்வியடைந்ததாக மட்டுமே தெரிவிக்கும்; புதிய கட்டுரை வெளியீடு முன்புபோலவே வேலை செய்யும்.

/ ஒப்பந்தம்

Orova அனுப்பும் request

முடிக்கப்பட்ட ஒவ்வொரு கட்டுரையும் இப்படி வடிவமைக்கப்பட்ட ஒரு request-ஆக வரும்:

POST <your endpoint URL>

Headers:
  Content-Type: application/json
  Authorization: Bearer <secret>     # the secret key shown in Project -> Connections
  User-Agent: Orova-SEO

Body (JSON):
  {
    "title": "...",                  # article headline
    "slug": "...",                   # URL-friendly identifier
    "content_html": "...",           # full article HTML
    "excerpt": "...",                # meta description
    "featured_image_url": "..." | null,
    "keyword": "...",                # target keyword
    "lang": "en",                    # ISO language code
    "published_at": "2026-05-17T09:00:00.482913",  # ISO 8601, UTC, no offset suffix
    "status": "draft"                # optional: "draft" keeps it unpublished
  }
  # Optional fields are left out of the body when empty — never sent as null.

/ குறிப்புதவி

Payload புலங்கள்

வெளியீட்டு (புதிய கட்டுரை) request-இன் புலங்கள். நீக்குதல் மற்றும் புதுப்பித்தல் request-கள் அதே endpoint-ஐக் கீழே அவற்றின் சொந்தப் பிரிவுகளில் காட்டப்பட்டுள்ள சிறிய body-களுடன் பயன்படுத்துகின்றன.

அனுப்ப எதுவும் இல்லாதபோது விருப்பத்தேர்வுப் புலங்கள் body-இலிருந்து முழுமையாக விடப்படும் — Orova ஒருபோதும் null அனுப்பாது, எனவே அவற்றை எச்சரிக்கையாகப் படியுங்கள். status-உம் விருப்பத்தேர்வே: "draft" கட்டுரையை வரைவாக உருவாக்கும், "publish" அல்லது status இல்லையென்றால் உடனே வெளியிடும்.

/ ஒப்பந்தம்

நீங்கள் திருப்பி அனுப்ப வேண்டிய response

பதிவை உருவாக்கியதும், HTTP 200 அல்லது 201 நிலையுடனும் இந்த JSON body-உடனும் பதிலளியுங்கள்:

HTTP 200 (or 201)
Content-Type: application/json

{
  "url": "https://yoursite.com/published-article"
}

Orova அந்த url-ஐக் கட்டுரையின் வெளியிடப்பட்ட இணைப்பாகச் சேமிக்கிறது. உங்கள் endpoint 2xx அல்லாத நிலையையோ, url புலம் கொண்ட JSON object அல்லாத body-யையோ திருப்பினால், Orova வெளியீடு தோல்வியடைந்ததாகக் கருதி, நீங்கள் மீண்டும் முயலும்படி கட்டுரையைக் குறிக்கும். 60 வினாடிகளுக்குள் பதிலளியுங்கள் — அதன் பிறகு Orova request-ஐ நிறுத்திவிடும் (இது வெளியீடு, புதுப்பித்தல், நீக்குதல் அனைத்திற்கும் பொருந்தும்).

/ எடுத்துக்காட்டு

குறியீட்டு எடுத்துக்காட்டு

Express உடன் Node.js-இல் ஒரு குறைந்தபட்ச receiving endpoint. அதே படிகள் — token-ஐச் சரிபார்த்தல், action (update / delete) அடிப்படையில் கிளைபிரித்தல், பதிவை உருவாக்குதல் அல்லது மாற்றுதல், URL-ஐத் திருப்புதல் — எந்த மொழி அல்லது framework-க்கும் பொருந்தும்.

// Node.js / Express — a minimal receiving endpoint
import express from "express";

const app = express();
app.use(express.json({ limit: "5mb" }));

// The secret Orova generated for this project.
const OROVA_SECRET = process.env.OROVA_SECRET;

app.post("/orova/publish", async (req, res) => {
  // 1. Verify the Bearer token.
  const auth = req.get("authorization") || "";
  if (auth !== "Bearer " + OROVA_SECRET) {
    return res.status(401).json({ error: "unauthorized" });
  }

  // 2. Required: list your articles (duplicate check, internal links). action = "list".
  if (req.body.action === "list") {
    const posts = await listPosts(req.body.limit || 500); // newest first, 500 max
    // each post: { id, title, slug, link, date, modified, status, author, excerpt? }
    return res.status(200).json({ ok: true, posts });
  }

  // 3. Required: read one article in full (used when optimizing it). action = "get".
  if (req.body.action === "get") {
    const post = await findPost(req.body.id, req.body.target_url, req.body.slug);
    if (!post) return res.status(404).json({ ok: false, err: "not_found" });
    return res.status(200).json({ ok: true, post });
  }

  // 4. Visual Editor: store an image, answer with its absolute URL.
  if (req.body.action === "upload_image") {
    const { filename, mime, data_base64 } = req.body;
    if (!String(mime || "").startsWith("image/")) {
      return res.status(422).json({ error: "image files only" });
    }
    const bytes = Buffer.from(data_base64, "base64");
    if (bytes.length > 15 * 1024 * 1024) {
      return res.status(413).json({ error: "image too large" });
    }
    return res.status(200).json({ ok: true, url: await saveImage(filename, bytes) });
  }

  // 5. Delete requests: body carries action = "delete".
  if (req.body.action === "delete") {
    const removed = await deletePostByUrl(req.body.url, req.body.slug);
    if (!removed) return res.status(404).json({ deleted: true }); // already gone
    return res.status(200).json({ deleted: true });
  }

  // 6. Update requests: action = "update". Optional fields may be absent.
  if (req.body.action === "update") {
    const updated = await updatePost(req.body.id, req.body.target_url, {
      title: req.body.title,
      html: req.body.content_html,
      metaDescription: req.body.excerpt,
      coverImage: req.body.featured_image_url,  // optional
      status: req.body.status,                  // optional: "publish" | "draft"
    });
    if (!updated) return res.status(404).json({ error: "post not found" });
    return res.status(200).json({ url: updated.url });
  }

  // 7. New article: read the payload Orova sent.
  const {
    title, slug, content_html, excerpt,
    featured_image_url, keyword, lang, published_at, status,
  } = req.body;

  // 8. Create the article in your own CMS or database.
  const post = await createPost({
    title,
    slug,
    html: content_html,
    metaDescription: excerpt,
    coverImage: featured_image_url,
    keyword,
    lang,
    publishedAt: published_at,
    draft: status === "draft",   // status is optional; absent means publish now
  });

  // 9. Return 200/201 with the live URL.
  return res.status(201).json({
    url: "https://yoursite.com/" + post.slug,
  });
});

app.listen(3000);

/ ஒப்பந்தம் — புதுப்பித்தல்

கட்டுரைகளைப் புதுப்பித்தல் (Optimize)

Orova-வின் Optimize engine ஏற்கெனவே நேரலையில் உள்ள கட்டுரைகளை மீண்டும் எழுதுகிறது — புதுப்பிக்கப்பட்ட தகவல்கள், சிறந்த தலைப்புகள், இணைக்கப்பட்ட உள்ளடக்கம் — பின்னர் ஏற்கெனவே உள்ள பதிவை அதே இடத்தில், URL-ஐ மாற்றாமல் மேலெழுதுகிறது. Request அதே endpoint URL-க்கு, அதே Bearer token உடன் POST ஆகச் செல்கிறது:

POST <your endpoint URL>

Headers:
  Content-Type: application/json
  Authorization: Bearer <secret>
  User-Agent: Orova-SEO

Body (JSON):
  {
    "action": "update",          # always the literal string "update"
    "id": 123,                   # optional: post id, match on this first
    "target_url": "...",         # public URL of the post to overwrite (match next)
    "title": "...",              # new headline
    "slug": "...",               # slug fallback for matching, may be empty
    "content_html": "...",       # full new article body as HTML
    "excerpt": "...",            # new meta description
    "featured_image_url": "...", # optional: new cover image
    "status": "publish"          # optional: "publish" or "draft"
  }
  # Optional fields are left out of the body when empty — never sent as null.

target_url மூலம் பதிவைக் கண்டறியுங்கள் (இல்லையெனில் slug), அதன் title, body மற்றும் meta description-ஐ மாற்றி, URL-ஐ அப்படியே வைத்து, { "url": "<same post URL>" } உடன் 200 பதிலளியுங்கள். 2xx அல்லாத நிலை அல்லது url இல்லாத body இருந்தால் Orova அந்த optimization-ஐத் தோல்வியடைந்ததாகக் குறிக்கும் (அது ஒருபோதும் நகல் பதிவை உருவாக்காது). இதை இன்னும் செயல்படுத்தாத endpoint-கள் புதிய கட்டுரைகளை மாற்றமின்றி வெளியிட்டுக்கொண்டே இருக்கும் — Optimize திரையைப் பயன்படுத்தும்போது மட்டுமே update-ஐச் செயல்படுத்த வேண்டும்.

ஆகஸ்ட் 29 முதல் update body-இல் id (target_url-க்கு முன் இதைப் பொருத்துங்கள்), புதிய cover படத்திற்கு featured_image_url, "publish" அல்லது "draft" கொண்ட status ஆகியவையும் இருக்கலாம். மூன்றும் விருப்பத்தேர்வே; காலியாக இருந்தால் body-இலிருந்து நீக்கப்படும், ஒருபோதும் null ஆக அனுப்பப்படாது.

/ ஒப்பந்தம் — Visual Editor

கட்டுரைகளைப் படித்தல் (கட்டாயம்)

உங்கள் தளத்தில் ஏற்கெனவே உள்ள கட்டுரைகளை Orova படிக்க வேண்டும் — நகல் தலைப்புகளைத் தவிர்க்க, உள் இணைப்புகளைச் சேர்க்க, பழைய பதிவுகளை optimize செய்ய. அதே endpoint URL-இல், அதே Bearer token உடன் மேலும் இரண்டு action-களைச் சேருங்கள்: list உங்கள் கட்டுரைகளைத் தருகிறது, get அவற்றில் ஒன்றை முழுமையாகத் தருகிறது.

POST <your endpoint URL>     # same endpoint, same Bearer secret

Body (JSON):
  {
    "action": "list",            # always the literal string "list"
    "limit": 500                 # newest article first, 500 maximum
  }

Response — HTTP 200:
  {
    "ok": true,
    "posts": [
      {
        "id": 123,               # your own post id, reused by "get" and "update"
        "title": "...",
        "slug": "...",
        "link": "https://yoursite.com/the-article",
        "date": "2026-08-29",    # published date, YYYY-MM-DD
        "modified": "2026-08-29",
        "status": "publish",     # "publish" or "draft"
        "author": "...",
        "excerpt": "..."         # optional: short summary, 300 characters max
      }
    ]
  }
  # Required: Orova reads this list to avoid duplicate topics,
  # add internal links and analyze the whole site.

POST <your endpoint URL>

Body (JSON):
  {
    "action": "get",             # always the literal string "get"
    "id": 123,                   # match on this first
    "target_url": "...",         # then the public URL
    "slug": "..."                # then the slug
  }

Response — HTTP 200:
  {
    "ok": true,
    "post": {
      "id": 123,
      "title": "...",
      "slug": "...",
      "link": "https://yoursite.com/the-article",
      "content_html": "...",     # full article body as HTML
      "excerpt": "...",
      "featured_image_url": "...",
      "status": "publish"        # "publish" or "draft"
    }
  }

No such post — HTTP 404:
  { "ok": false, "err": "not_found" }

limit அதிகபட்சம் 500, புதிய கட்டுரை முதலில் வரும். get-க்கு, Orova id, target_url மற்றும் slug-ஐ ஒன்றாக அனுப்புகிறது — நீங்கள் அடையாளம் காணும் எதனுடனும், அந்த வரிசையில், பொருத்துங்கள். எதுவும் பொருந்தவில்லையென்றால், { "ok": false, "err": "not_found" } உடன் 404 பதிலளியுங்கள். list-இல் excerpt விருப்பத்தேர்வு (அதிகபட்சம் 300 எழுத்துகள்). கட்டாயம்: எந்தக் கட்டுரைகள் ஏற்கெனவே உள்ளன என அறிய (நகல்களைத் தவிர்க்க, உள் இணைப்புகளைச் சேர்க்க, முழுத் தளத்தையும் பகுப்பாய்வு செய்ய) Orova list-ஐ அழைக்கிறது, ஒரு கட்டுரையை optimize செய்யும்போது அதைப் படிக்க get-ஐ அழைக்கிறது. உங்கள் தளம் இந்த இரண்டு action-களுக்கும் பதிலளிக்காவிட்டால், புதிய கட்டுரைகளுக்கு உள் இணைப்புகள் கிடைக்காது, பழைய கட்டுரைகளை optimize செய்ய முடியாது.

/ ஒப்பந்தம் — Visual Editor

படங்களைப் பதிவேற்றுதல் (Visual Editor)

Visual Editor-இல் ஒரு படத்தை இடும்போது, Orova அதை அதே endpoint URL-க்கு JSON body-க்குள் base64 ஆக அனுப்புகிறது — multipart இல்லை, பாதுகாக்க வேண்டிய இரண்டாவது URL இல்லை.

POST <your endpoint URL>

Body (JSON):
  {
    "action": "upload_image",    # always the literal string "upload_image"
    "filename": "cover.png",     # original file name, extension included
    "mime": "image/png",         # image/* only
    "data_base64": "iVBORw0KGgo..."   # file bytes, base64, 15 MB maximum
  }

Response — HTTP 200 (or 201):
  {
    "ok": true,
    "url": "https://yoursite.com/uploads/cover.png"   # absolute URL
  }

image/* மட்டும் ஏற்று, 15 MB-க்கு மேற்பட்ட எதையும் நிராகரியுங்கள். கோப்பைச் சேமித்து, படத்தின் முழுமையான (absolute) URL-உடன் பதிலளியுங்கள்: relative பாதை, கட்டுரை வேறு இடத்தில் காட்டப்படும்போதே அதை உடைத்துவிடும். இந்த action Visual Editor-க்கு மட்டுமே தேவை.

/ ஒப்பந்தம் — நீக்குதல்

கட்டுரைகளை நீக்குதல்

பயனர் Orova-வுக்குள் (Write அல்லது Reports திரையிலிருந்து) வெளியிடப்பட்ட கட்டுரையை நீக்கும்போது, Orova உங்கள் தளத்தையும் அதை நீக்கச் சொல்கிறது. Request அதே endpoint URL-க்கு, அதே Bearer token உடன் POST ஆகச் செல்கிறது — ஒரே வேறுபாடு body மட்டுமே:

POST <your endpoint URL>

Headers:
  Content-Type: application/json
  Authorization: Bearer <secret>
  User-Agent: Orova-SEO

Body (JSON):
  {
    "action": "delete",          # always the literal string "delete"
    "url": "...",                # public URL of the article to remove (match on this first)
    "slug": "...",               # slug fallback, may be empty
    "keyword": "..."             # the article's target keyword, for your logs
  }

url மூலம் பதிவைக் கண்டறிந்து (இல்லையெனில் slug), அதை நீக்குங்கள் அல்லது வெளியீட்டை நிறுத்துங்கள், பின்னர் { "deleted": true } உடன் 200 பதிலளியுங்கள் — வெறும் 204-உம் வேலை செய்யும். பதிவு இனி இல்லையென்றால், 404 பதிலளியுங்கள், Orova அதை ஏற்கெனவே நீக்கப்பட்டதாகக் கருதும். { "deleted": false } திருப்பினால் பதிவு நீக்கப்படவில்லை என Orova-வுக்குச் சொல்கிறது. வழக்கமான வெளியீட்டு request-களில் action புலம் ஒருபோதும் இருக்காது, எனவே ஏற்கெனவே உள்ள endpoint-கள் மாற்றமின்றி வேலை செய்யும் — delete-ஐச் செயல்படுத்துவது விருப்பத்தேர்வு, ஆனால் பரிந்துரைக்கப்படுகிறது.

/ பாதுகாப்பு

பாதுகாப்புக் குறிப்புகள்

• எப்போதும் Bearer token-ஐச் சரிபாருங்கள். உங்கள் endpoint ஒரு பொது URL — யார் வேண்டுமானாலும் அழைக்கலாம். Request உண்மையில் Orova-விலிருந்து வந்தது என நிரூபிப்பது Authorization header மட்டுமே, எனவே நீங்கள் சேமித்த secret-உடன் token துல்லியமாகப் பொருந்தாத ஒவ்வொரு request-ஐயும் நிராகரியுங்கள்.
• Endpoint-ஐ HTTPS மூலம் இயக்குங்கள். Secret ஒரு header-இல் பயணிக்கிறது. HTTPS அதைப் பயணத்தின்போது படிக்கப்படாமல் காக்கிறது.
• Secret-ஐ உங்கள் குறியீட்டுக்கு வெளியே வையுங்கள். அதை environment variable அல்லது secrets manager-இல் சேமியுங்கள்; commit செய்யும் கோப்பில் நேரடியாக எழுதாதீர்கள். எப்போதாவது வெளிப்பட்டால், திட்டம் → இணைப்புகள் என்பதிலிருந்து புதியதை உருவாக்குங்கள்.
• content_html-ஐ உள்ளடக்கமாகக் கருதுங்கள், நம்பகமான markup ஆக அல்ல. உங்கள் CMS-இல் உள்ள மற்ற எந்தக் கட்டுரை உள்ளடக்கத்தையும் போலவே கவனமாகச் சேமித்துக் காட்டுங்கள்.

/ நிறைவாக

ஒப்பந்தம் இவ்வளவுதான்

Endpoint இயங்கி, உங்கள் திட்டத்தில் பதிவு செய்யப்பட்டதும், Orova உங்கள் தளத்தில் தானாக வெளியிடும் — WordPress பயனர்களுக்குச் செய்வது போலவே. முடிக்கும் ஒவ்வொரு கட்டுரையும் உங்கள் சர்வருக்கு வந்து ஒரு பதிவாக மாறும், அதன் பொது URL அறிக்கைகள் மற்றும் பகுப்பாய்வுக்குத் திரும்பி வரும், எனவே அதன் செயல்திறனைக் கண்காணிக்கலாம்.