Endpoint pentru generarea automată a tagurilor SEO
Acest endpoint permite generarea automată a conținutului SEO (precum meta titlu, descriere și keywords) pentru produse sau pagini, pe baza datelor furnizate. Rezultatul este generat folosind AI și livrat în limba specificată.
URL endpoint
https://api.ovesio.com/v1/ai/generate-seo
Metodă
POST
Format date
application/json
Exemplu cerere JSON
{
"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"
]
}
}
]
}
Parametri cerere
Parametru | Tip | Obligatoriu | Descriere |
---|---|---|---|
workflow | integer | nu | Dacă nu este specificat, se folosește workflow-ul implicit. |
to | string | nu | Limba în care va fi generat rezultatul. Dacă nu este definită, va fi detectată automat. |
callback_url | string | nu | Adresa URL la care va fi trimis răspunsul cu rezultatul generat. |
data | array | da | Lista cu cererile pentru care se dorește generarea tagurilor SEO. |
Structura câmpului data
Câmp | Tip | Obligatoriu | Descriere |
---|---|---|---|
ref | string | nu | Referință unică pentru identificare ulterioară (ex: ID produs). |
content | object | da | Obiect ce conține informațiile descriptive pentru AI. |
Structura câmpului content
Câmp | Tip | Obligatoriu | Descriere |
---|---|---|---|
name | string | da | Numele produsului sau titlul paginii. |
categories | array | nu | Lista de categorii asociate. |
description | string | nu | Descriere generală. |
additional | array | nu | Listă cu detalii adiționale (ex: specificații tehnice). |
Răspunsuri posibile
Răspuns de succes (HTTP 200)
{
"success": true,
"data": [
{
"id": 789123,
"ref": "1234ABC"
}
]
}
Cererea a fost înregistrată și va fi procesată în fundal. Poți folosi id
pentru a verifica statusul.
Răspuns de eroare (HTTP 400)
{
"success": false,
"errors": []
}
În cazul unei erori, răspunsul include cheia success: false
și o listă de mesaje în errors
care explică problema.
Exemple de integrare
Poți consulta exemple de integrare disponibile pe pagina oficială de GitHub Ovesio.