Како функционира Batch API?
Крајната точка на Batch API, како што е документирано тука, им овозможува на корисниците да поднесуваат барања за асинхрона сериска обработка. Ќе ги обработиме овие барања во рок од 24 часа. Деталите за секое барање ќе се читаат од претходно поставена датотека, а одговорите ќе се запишуваат во излезна датотека. Можете да го проверите batch-објектот за ажурирања на статусот и резултати.
Која е цената за Batch API?
Секој модел ќе се нуди со 50% попуст на трошокот во споредба со синхроните API-ја. Еве повеќе информации за цените на нашите API-ја.
Кои модели можам да ги обработувам сериски?
Batch API е широко достапен кај повеќето наши модели, но не кај сите. Погледнете ја референтната документација за моделите за да се уверите дека моделот што го користите го поддржува Batch API.
Што се случува ако API не го заврши моето барање во ветениот рок?
Настојуваме да ги обработиме сите барања во рок од 24 часа. Ако истече рокот на пакетот (односно, ако не може да се заврши во временскиот рок утврден со SLA), преостанатата работа се откажува, а веќе завршената работа се враќа. На програмерите ќе им се наплати за целата завршена работа.
Кое е ограничувањето за бројот на барања што можам да ги обработувам сериски?
API-јата за вгнездувања имаат ограничување од 1 милион барања во редица истовремено.
За сите други API-ја, нема ограничување на бројот на барања што можете да ги обработувате сериски; сепак, секое ниво на користење има поврзано batch-ограничување на брзината. Вашето batch-ограничување на брзината го вклучува максималниот број влезни токени што ги имате ставено во редица во даден момент. Можете да ги најдете вашите ограничувања на брзината тука.
Може ли да го променам времето потребно за да добијам одговор од Batch API?
Нашиот тековно наведен временски прозорец е 24 часа. Во моментов не можеме да го промениме овој временски период.
Дали Batch API поддржува стриминг?
Не, стримингот не е поддржан на Batch API. Batch-барањата враќаат резултати преку излезни датотеки, а не преку стримувани одговори.
Дали Batch API поддржува слики?
Да, сликите се поддржани на Batch API.
Добив порака за грешка „The URL provided for this request does not prefix-match the batch endpoint“. Што треба да направам?
Ако ја добиете оваа грешка, тоа значи дека вашата URL-адреса е неправилно форматирана за крајната точка на Batch API. Погледнете ја нашата документација тука за да се уверите дека правилно ја повикувате крајната точка.
Дали користењето на Batch API се пресметува кон моите други ограничувања на брзината?
Ограничувањата на брзината за Batch API се целосно одделни од постојните ограничувања.
Што се случува ако пакетот се откаже?
Ако пакетот се откаже рачно, ќе бидат вратени сите веќе завршени резултати. На програмерите ќе им се наплати за целата завршена работа.
Што се случува ако истече рокот на пакетот?
Ако истече рокот на пакетот (односно, ако не може да се заврши во временскиот рок утврден со SLA), преостанатата работа се откажува, а веќе завршената работа се враќа. На програмерите ќе им се наплати за целата завршена работа.
Кои статуси можам да ги очекувам кај сериските задачи?
Сериската задача може да има кој било од следниве статуси: Валидација, Неуспешно, Во тек, Финализирање, Завршено, Истечено, Откажување и Откажано. Ако програмски ги проверувате вредностите на статусот во API, користете ги литералите со мали букви: validating, failed, in_progress, finalizing, completed, expired, cancelling и cancelled.
Валидација: Валидацијата на поставената датотека е во тек пред да започне сериската обработка.
Неуспешно: Датотеката не го помина процесот на валидација.
Во тек: Датотеката беше успешно валидирана и серискиот процес е во тек.
Финализирање: Сериската задача е завршена и резултатите се подготвуваат.
Завршено: Сериската задача е завршена и резултатите се подготвени.
Истечено: Сериската обработка не можеше да се заврши во временскиот прозорец на SLA.
Откажување: Започнато е откажувањето на сериската задача.
Откажано: Сериската задача беше откажана.
Како можам да проверам кои сериски задачи веќе сум ги создал?
Можете да добиете список на сите ваши сериски задачи со API-повикот наведен тука.
Дали нула задржување на податоци е поддржано на оваа крајна точка?
Ако за вашата организација е овозможено нула задржување на податоци, имајте предвид дека нула задржување на податоци не важи за Batch API. Организациите со ZDR можат да создаваат сериски задачи, но batch-влезните датотеки, излезите, грешките и посредните артефакти се задржуваат според конфигурираните политики за задржување на Batch, File Service и Sediment.