API | Yaplet HU

Áttekintés

A Trigger API bármilyen URL-t vagy nyers szöveget kész közösségi posztokká alakít. Az AI közösségi posztolás beolvassa a forrást, platformra hangolt szövegeket ír, legenerálja a képet, és a posztot vagy a jóváhagyási sorodba teszi (alapértelmezés), vagy automatikusan közzéteszi. Tipikus használat: hívd meg a CMS-edből, amikor blogcikket publikálsz.

Hitelesítés

API-kulcs szükségesMinden kérésben add meg a Y-API-Key fejlécet. A kulcsot a Beállítások > API alatt hozhatod létre vagy cserélheted — ugyanaz a kulcs működik minden Yaplet API-hoz.

Végpont

POST `https://yaplet.com/api/social-posting/trigger`

JSON-törzset fogad, és 202 Accepted választ ad — a generálás aszinkron fut, és jellemzően ~2 percen belül elkészül.

Kérésmezők

Kötelező (az egyik)

Mező	Típus	Leírás
`url`	`string`	Az oldal, amiről a poszt szól. Szerveroldalon olvassuk be.
`content`	`string`	Nyers szöveg, amiről a poszt szól (legfeljebb 40 000 karakter).

Opcionális

Mező	Típus	Alapértelmezés	Leírás
`brand_id`	`string`	A szervezet egyetlen márkája	Csak akkor kötelező, ha a szervezetednek több márkája van.
`platforms`	`string[]`	Mindkettő	`"FACEBOOK"`, `"INSTAGRAM"`.
`page_ids`	`string[]`	A márka összes oldala	A márka csatlakoztatott oldalainak egy részhalmazára posztol.
`mode`	`string`	`"approval"`	Az `"approval"` a jóváhagyási sorba teszi a posztot; az `"auto"` a generálás után azonnal közzéteszi.
`scheduled_at`	`ISO date`	—	Csak auto módban: ekkor jelenjen meg az azonnali helyett (legfeljebb 1 évre előre).
`generate_image`	`boolean`	`true`	INSTAGRAM célzásakor `true` kell maradjon, hacsak nem adsz `image_url`-t. Kölcsönösen kizárja az `image_url`-t.
`image_url`	`string`	—	Hozd a saját képed (nyilvános https URL) — letöltjük, igazítjuk és áttároljuk, mint egy feltöltést.
`first_comment`	`boolean`	`false`	Az AI platformonkénti első kommentet ír, amely minden poszt megjelenése után azonnal kikerül. Puha: a sikertelen komment sosem blokkolja a posztot.
`include_source_link`	`boolean`	`true`	`first_comment: true` mellett URL-forrású posztnál a Facebook-komment viszi a forráslinket (az egyetlen kattintható hely). Az Instagram link nélkül marad.
`watermark_id`	`string`	Márka-alapértelmezés	Vízjel a könyvtáradból, a generált képre bélyegezve.
`length`	`string`	Márka-alapértelmezés	`"short"`, `"medium"` vagy `"long"`.
`angle`	`string`	—	Kész megközelítés: `tip`, `faq`, `use_case`, `feature`, `myth_bust`, `behind_the_scenes` vagy `audience_question`.
`instructions`	`string`	—	Posztonkénti irányítás az AI-nak (legfeljebb 4 000 karakter).
`name`	`string`	Generált	A posztlistádban látható belső név.

Kódpéldák

const response = await fetch("https://yaplet.com/api/social-posting/trigger", {
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        "Y-API-Key": "YOUR_API_KEY",
    },
    body: JSON.stringify({
        url: "https://your-blog.com/new-feature",
        platforms: ["FACEBOOK", "INSTAGRAM"],
        mode: "approval",
        first_comment: true,
        instructions: "Friendly tone, no emojis.",
    }),
});

const result = await response.json();
console.log(result); // { id, status: "PENDING_GENERATION", mode, targets }

curl -X POST https://yaplet.com/api/social-posting/trigger \
  -H "Content-Type: application/json" \
  -H "Y-API-Key: YOUR_API_KEY" \
  -d '{
  "url": "https://your-blog.com/new-feature",
  "platforms": ["FACEBOOK", "INSTAGRAM"],
  "mode": "approval",
  "first_comment": true,
  "instructions": "Friendly tone, no emojis."
}'

<?php

$ch = curl_init("https://yaplet.com/api/social-posting/trigger");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Y-API-Key: YOUR_API_KEY",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "url" => "https://your-blog.com/new-feature",
    "platforms" => ["FACEBOOK", "INSTAGRAM"],
    "mode" => "approval",
    "first_comment" => true,
    "instructions" => "Friendly tone, no emojis.",
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response; // { "id": ..., "status": "PENDING_GENERATION", ... }
?>

import requests

response = requests.post(
    "https://yaplet.com/api/social-posting/trigger",
    headers={
        "Content-Type": "application/json",
        "Y-API-Key": "YOUR_API_KEY",
    },
    json={
        "url": "https://your-blog.com/new-feature",
        "platforms": ["FACEBOOK", "INSTAGRAM"],
        "mode": "approval",
        "first_comment": True,
        "instructions": "Friendly tone, no emojis.",
    },
)

print(response.json())  # { "id": ..., "status": "PENDING_GENERATION", ... }

Válasz

Státusz: 202 Accepted

{
    "id": "9f4c1e6a-...",
    "status": "PENDING_GENERATION",
    "mode": "approval",
    "targets": 2
}

Hogyan lesz élő a triggerelt posztból?

Meghívod a triggert

A poszt szinkron módon validálódik — a hibás beállítás (nincs csatlakoztatott oldal, nincs összekapcsolt Instagram) azonnal a hívást buktatja el, nem később.

A generáló feldolgozó felveszi

~2 percen belül beolvassa a forrást, megírja a szövegeket, hashtageket, alt szöveget és első kommenteket, valamint legenerálja vagy áttárolja a képet.

Jóváhagyás vagy auto

Approval módban a kész piszkozat az AI közösségi posztolás > Jóváhagyási sor oldalon jelenik meg (a jóváhagyók alkalmazáson belüli értesítést kapnak). Auto módban amint elkészül, közzé is teszi — vagy a scheduled_at időpontban.

Minden platform önállóan publikál

A Facebook- és Instagram-célok oldalanként sikerülnek vagy hiúsulnak meg — az opcionális első komment mindegyik megjelenése után azonnal kikerül.

Hibák

Státusz	Jelentése
`401`	Hiányzó vagy érvénytelen `Y-API-Key`.
`403`	Az AI közösségi posztolás nem érhető el a csomagodban.
`400`	Validációs hiba — az üzenet megmondja, melyik mező.
`404`	Egy hivatkozott erőforrás (márka, oldal, vízjel) nem található.
`422`	Nincs csatlakoztatott Facebook-oldal (vagy összekapcsolt Instagram-fiók), ahová posztolni lehetne.
`429`	Túl sok poszt vár már generálásra (legfeljebb 20), vagy túl sok kérés rövid idő alatt — próbáld újra, ha lefutottak.

Számlázás

Ugyanúgy számláz, mint a szerkesztőA szöveggenerálás és a képek puhán számláznak — először az előre feltöltött egyenleg, majd a csomagod kredit-mérője. A sikertelen generálás soha nem tesz közzé semmit, és soha nem kerül felszámításra; a poszt Sikertelen státusszal, az okkal együtt jelenik meg a listádban.