Край на точката за автоматично генериране на SEO тагове
Тази крайна точка позволява автоматично генериране на SEO съдържание (като мета заглавие, описание и ключови думи) за продукти или страници, въз основа на предоставените данни. Резултатът се генерира с помощта на AI и се доставя на посочения език.
URL адрес на крайната точка
https://api.ovesio.com/v1/ai/generate-seo
Метод
POST
Формат на данните
{
"workflow": null,
"to": "en",
"callback_url": "https://example.com/callback-url",
"data": [
{
"ref": "1234ABC",
"content": {
"name": "Apple iPhone 15 Pro Max",
"categories": ["Smartphones", "Apple", "Electronics"],
"description": "High-end smartphone with advanced camera and performance",
"additional": [
"Color: Silver",
"Storage: 256GB",
"Chip: A17 Pro"
]
}
}
]
}
Параметри на заявката
Параметър | Тип | Задължителен | Описание |
---|---|---|---|
workflow | integer | Не | Ако не е посочен, се използва работният поток по подразбиране. |
to | string | Не | Езикът, на който ще бъде генериран резултатът. Ако не е дефиниран, той ще бъде автоматично открит. |
callback_url | string | Не | URL адресът, до който ще бъде изпратен отговорът с генерирания резултат. |
date | array | Да | Списък със заявки, за които искате да генерирате SEO тагове. |
data
структура на полето
Поле | Тип | Задължителен | Описание |
---|---|---|---|
ref | string | Не | Уникална референция за по-нататъшна идентификация (напр. ID на продукт). |
content | object | Да | Обект, съдържащ описателна информация за AI. |
content
структура на полето
Поле | Тип | Задължителен | Описание |
---|---|---|---|
name | string | Да | Име на продукта или заглавие на страницата. |
categories | array | Не | Списък на свързаните категории. |
description | string | Не | Общо описание. |
additional | array | Не | Списък на допълнителни детайли (напр. технически спецификации). |
Възможни отговори
Успешен отговор (HTTP 200)
{
"success": true,
"data": [
{
"id": 789123,
"ref": "1234ABC"
}
]
}
Заявката е регистрирана и ще бъде обработена във фонов режим. Можете да използвате id
, за да проверите състоянието.
Отговор за грешка (HTTP 400)
{
"success": false,
"errors": []
}
В случай на грешка, отговорът включва ключа success: false
и списък със съобщения в errors
, обясняващи проблема.
Примери за интеграция
Можете да разгледате примери за интеграция, достъпни на официалната страница на Ovesio в GitHub .