Endpoint do automatycznego generowania tagów SEO
Ten endpoint umożliwia automatyczne generowanie treści SEO (takich jak meta tytuł, opis i słowa kluczowe) dla produktów lub stron, bazując na dostarczonych danych. Wynik jest generowany przy użyciu AI i dostarczany w określonym języku.
URL endpointu
https://api.ovesio.com/v1/ai/generate-seo
Metoda
POST
Format danych
{
"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"
]
}
}
]
}
Parametry żądania
| Parametr | Typ | obowiązkowy | Opis |
|---|---|---|---|
| workflow | integer | nie | Jeśli nie określono, używany jest domyślny workflow. |
| to | thong | nie | Język, w którym zostanie wygenerowany wynik. Jeśli nie zdefiniowano, zostanie automatycznie wykryty. |
| callback_url | thong | nie | URL, na który zostanie wysłana odpowiedź z wygenerowanym wynikiem. |
| date | array | Tak | Lista żądań, dla których chcesz wygenerować tagi SEO. |
struktura pola data
| Pole | Typ | obowiązkowy | Opis |
|---|---|---|---|
| ref | thong | nie | Unikalny identyfikator do dalszej identyfikacji (np. ID produktu). |
| content | object | Tak | Obiekt zawierający opisowe informacje dla AI. |
struktura pola content
| Pole | Typ | obowiązkowy | Opis |
|---|---|---|---|
| name | thong | Tak | Nazwa produktu lub tytuł strony. |
| categories | array | nie | Lista powiązanych kategorii. |
| description | thong | nie | Ogólny opis. |
| additional | array | nie | Lista dodatkowych szczegółów (np. specyfikacje techniczne). |
Możliwe odpowiedzi
Udana odpowiedź (HTTP 200)
{
"success": true,
"data": [
{
"id": 789123,
"ref": "1234ABC"
}
]
}
Żądanie zostało zarejestrowane i będzie przetwarzane w tle. Możesz użyć id, aby sprawdzić status.
Odpowiedź błędu (HTTP 400)
{
"success": false,
"errors": []
}
W przypadku błędu odpowiedź zawiera klucz success: false oraz listę komunikatów w errors, wyjaśniających problem.
Przykłady integracji
Możesz sprawdzić przykłady integracji dostępne na oficjalnej stronie Ovesio na GitHubie .