Sari la conținut

Încărcare meniu

POST
/api/v3/menu/upload
curl --request POST \
--url https://prod.store-management.glovo.alb.app.onlineservice.io/api/v3/menu/upload \
--header 'Authorization: <Authorization>' \
--header 'Content-Type: application/json' \
--data '{ "store_id": "example", "store_environment": "example", "partner_name": "example", "super_category": { "name": "example", "position": 1, "image_url": "example", "display_super_category": true, "categories": [ { "name": "example", "position": 1, "image_url": "example", "sections": [ { "name": "example", "position": 1, "products": [ { "id": "example", "name": "example", "price": "example", "imageUrl": "example", "extraImageUrls": [ "example" ], "description": "example", "available": true, "attribute_groups": [ { "id": "example", "name": "example", "min": 1, "max": 1, "collapse": true, "attributes": [ { "id": "example", "name": "example", "available": true, "selected_by_default": false, "price": null } ], "multiple_selection": true } ] } ] } ] } ] }, "super_categories": [ { "name": "example", "position": 1, "image_url": "example", "display_super_category": true, "categories": [ { "name": "example", "position": 1, "image_url": "example", "sections": [ { "name": "example", "position": 1, "products": [ { "id": "example", "name": "example", "price": "example", "imageUrl": "example", "extraImageUrls": [ "example" ], "description": "example", "available": true, "attribute_groups": [ { "id": "example", "name": "example", "min": 1, "max": 1, "collapse": true, "attributes": [ { "id": "example", "name": "example", "available": true, "selected_by_default": false, "price": null } ], "multiple_selection": true } ] } ] } ] } ] } ] }'

Acest endpoint API permite utilizatorilor să încarce sau să actualizeze întregul meniu al unui magazin în Glovo. Procesul este asincron, ceea ce înseamnă că endpoint-ul returnează un transaction_id care poate fi utilizat pentru a urmări progresul procesului de actualizare a meniului folosind endpoint-ul Verify menu upload.

Rețineți că există un număr maxim de cinci actualizări ale meniului permise pe zi pe adresa fiecărui magazin. Dacă acest limită este atinsă, endpoint-ul va returna un cod de stare 429, indicând că s-au făcut prea multe cereri. Pentru actualizări mici ale produselor și atributele, se recomandă utilizarea endpoint-urilor individuale sau bulk.

În cazul în care sistemul Glovo întâmpină o eroare la actualizarea meniului, nu se vor face modificări pentru a evita inconsistentele. the event that the Glovo system encounters an error while updating the menu, no changes will be made to avoid inconsistencies.

Media typeapplication/json

The model for menu update request

object
store_id

The unique identifier of the store

string
store_environment

The store environment. Use ‘prod’

string
partner_name

The name of the partner

string
super_category

O “super-categorie” este cel mai înalt nivel de categorizare din meniul Glovo.

object
name

The name of the super category

string
position

The position of the super category in the menu

integer format: int32
image_url

The URL of the image associated with the super category. Must use HTTPS schema

string
display_super_category

Whether or not the super category should be displayed

boolean
categories

The list of categories associated with the super category

Array<object>

O categorie este un nivel secundar de organizare în meniul Glovo și este obligatoriu să aveți cel puțin o colecție în meniul dvs. O colecție este formată din secțiuni și trebuie să aibă cel puțin o secțiune pentru a conține alte elemente. Exemple de colecții includ băuturi, burgeri, salate, deserturi și paste.

object
name

The name of the category

string
position

The position of the category in the menu

integer format: int32
image_url

The URL of the category image. Must use HTTPS schema

string
sections

The list of sections within the category

Array<object>

Model for a section component of the menu.

object
name

The name of the section.

string
position

The position of the section.

integer format: int32
products

List of products belonging to this section.

Array<object>

Un produs este un element fundamental al meniului Glovo, care reprezintă în mod obișnuit un element fizic disponibil într-un magazin. Cu toate acestea, magazinul are libertatea de a decide ce dorește să ofere ca produse. Fiecare produs este asociat cu o secțiune a meniului.

object
id

The ID of the product.

string
name

The name of the product.

string
price

The price of the product.

string
imageUrl

The URL of the main image of the product. Must use HTTPS schema.

string
extraImageUrls

A list of URLs of additional images of the product. Must use HTTPS schema.

Array<string>
description

The description of the product.

string
available

Whether the product is currently available.

boolean
Example
true
attribute_groups

A list of attribute groups of the product.

Array<object>

Grupurile de atribute permit gruparea personalizărilor similare în grupuri generice, fiecare dintre acestea putând avea un număr minim și maxim de opțiuni pentru client. De exemplu, grupurile de atribute pot fi folosite pentru a categorisi topping-urile, cum ar fi sosuri, inclusiv maioneza, muștar sau sos de roșii, sau băuturi, cum ar fi apă, cola sau lămâie.

object
id

The ID of the group

string
name

The name of the group

string
min

The minimum number of attributes that can be selected

integer format: int32
max

The maximum number of attributes that can be selected

integer format: int32
collapse

Whether the group should be collapsed or expanded by default

boolean
attributes

The list of attributes for this group

Array<object>

Produsele pot fi personalizate in diverse moduri, cum ar fi adaugarea de maioneza, includerea unei bauturi sau adaugarea de carne extra, iar fiecare dintre aceste personalizari este cunoscuta sub numele de atribut. Produsele nu sunt obligate sa aiba atribute, dar fiecare atribut poate avea un impact diferit asupra pretului. Grupurile de atribute sunt create pentru a grupa atribute similare impreuna.

object
id

The ID of the attribute

string
name

The name of the attribute

string
available

Whether the attribute is available

boolean
default: true
selected_by_default

Whether the attribute is selected by default

boolean
price

The price of the attribute

string
multiple_selection

Whether multiple attributes can be selected

boolean
super_categories

The list of super categories of the menu update

Array<object>

O “super-categorie” este cel mai înalt nivel de categorizare din meniul Glovo.

object
name

The name of the super category

string
position

The position of the super category in the menu

integer format: int32
image_url

The URL of the image associated with the super category. Must use HTTPS schema

string
display_super_category

Whether or not the super category should be displayed

boolean
categories

The list of categories associated with the super category

Array<object>

O categorie este un nivel secundar de organizare în meniul Glovo și este obligatoriu să aveți cel puțin o colecție în meniul dvs. O colecție este formată din secțiuni și trebuie să aibă cel puțin o secțiune pentru a conține alte elemente. Exemple de colecții includ băuturi, burgeri, salate, deserturi și paste.

object
name

The name of the category

string
position

The position of the category in the menu

integer format: int32
image_url

The URL of the category image. Must use HTTPS schema

string
sections

The list of sections within the category

Array<object>

Model for a section component of the menu.

object
name

The name of the section.

string
position

The position of the section.

integer format: int32
products

List of products belonging to this section.

Array<object>

Un produs este un element fundamental al meniului Glovo, care reprezintă în mod obișnuit un element fizic disponibil într-un magazin. Cu toate acestea, magazinul are libertatea de a decide ce dorește să ofere ca produse. Fiecare produs este asociat cu o secțiune a meniului.

object
id

The ID of the product.

string
name

The name of the product.

string
price

The price of the product.

string
imageUrl

The URL of the main image of the product. Must use HTTPS schema.

string
extraImageUrls

A list of URLs of additional images of the product. Must use HTTPS schema.

Array<string>
description

The description of the product.

string
available

Whether the product is currently available.

boolean
Example
true
attribute_groups

A list of attribute groups of the product.

Array<object>

Grupurile de atribute permit gruparea personalizărilor similare în grupuri generice, fiecare dintre acestea putând avea un număr minim și maxim de opțiuni pentru client. De exemplu, grupurile de atribute pot fi folosite pentru a categorisi topping-urile, cum ar fi sosuri, inclusiv maioneza, muștar sau sos de roșii, sau băuturi, cum ar fi apă, cola sau lămâie.

object
id

The ID of the group

string
name

The name of the group

string
min

The minimum number of attributes that can be selected

integer format: int32
max

The maximum number of attributes that can be selected

integer format: int32
collapse

Whether the group should be collapsed or expanded by default

boolean
attributes

The list of attributes for this group

Array<object>

Produsele pot fi personalizate in diverse moduri, cum ar fi adaugarea de maioneza, includerea unei bauturi sau adaugarea de carne extra, iar fiecare dintre aceste personalizari este cunoscuta sub numele de atribut. Produsele nu sunt obligate sa aiba atribute, dar fiecare atribut poate avea un impact diferit asupra pretului. Grupurile de atribute sunt create pentru a grupa atribute similare impreuna.

object
id

The ID of the attribute

string
name

The name of the attribute

string
available

Whether the attribute is available

boolean
default: true
selected_by_default

Whether the attribute is selected by default

boolean
price

The price of the attribute

string
multiple_selection

Whether multiple attributes can be selected

boolean

Rezultatul verificării de status

Media typeapplication/json
object
status
string
transaction_id
string
message
string
detail
string
Examplegenerated
{
"status": "example",
"transaction_id": "example",
"message": "example",
"detail": "example"
}

Eroare internă

Media typeapplication/json
string
Examplegenerated
example