add i18n to call via API

README.md

@@ -50,7 +50,7 @@ npm run download
 Test locale
 
 ```bash
-npm run start -- --locale ru
+npm start -- --locale ru
 ```
 
 Check more details here https://docusaurus.io/docs/3.4.0/i18n/crowdin

i18n/en/docusaurus-plugin-content-docs/current.json

@@ -14,5 +14,25 @@
   "sidebar.tutorialSidebar.category.Tutorial - Extras": {
     "message": "Tutorial - Extras",
     "description": "The label for category Tutorial - Extras in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Pipeline Basics": {
+    "message": "Pipeline Basics",
+    "description": "The label for category Pipeline Basics in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Pipeline Basics.link.generated-index.description": {
+    "message": "5 minutes to learn the most important Docusaurus concepts.",
+    "description": "The generated-index page description for category Pipeline Basics in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Advanced development": {
+    "message": "Advanced development",
+    "description": "The label for category Advanced development in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Deploy pipelines & API": {
+    "message": "Deploy pipelines & API",
+    "description": "The label for category Deploy pipelines & API in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Deploy pipelines & API.link.generated-index.description": {
+    "message": "Simply deploy your pipelines & call via API.",
+    "description": "The generated-index page description for category Deploy pipelines & API in sidebar tutorialSidebar"
   }
 }

i18n/ru/docusaurus-plugin-content-docs/current/deploy-pipelines/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Публикация конвейеров и API",
+  "position": 4,
+  "link": {
+    "type": "generated-index",
+    "description": "Публикуйте свои конвейеры и вызывайте их через API за секунды."
+  }
+}

i18n/ru/docusaurus-plugin-content-docs/current/deploy-pipelines/call-via-api.md

@@ -0,0 +1,111 @@
+---
+sidebar_position: 1
+---
+
+# Запуск конвейеров и API
+
+После публикации ваши конвейеры можно вызывать с помощью запросов POST/GET.
+
+:::tip Подсказка
+
+Если вы развернули Piper на своем собственном сервере, замените **piper.my** на свое доменное имя.
+
+:::
+
+## Запустить конвейер
+
+```bash
+curl --location --request POST 'https://piper.my/api/pipeline-slug/launch' \
+--header 'content-type: application/json' \
+--header 'api-token: [YOUR_API_KEY_HERE]' \
+--data '{
+  "inputs": {
+    name: "Bob Marley",
+    age: 36,
+    died: true
+  }
+}'
+```
+
+:::tip Важно
+
+Тип входных данных может быть только: `boolean` | `number` | `string` 
+
+:::
+
+Некоторые конвейеры принимают JSON в качестве входных данных.
+
+В этом случае JSON все равно необходимо сериализовать в строку.
+
+```json
+{
+  "inputs": {
+    "props": "{ \"name\": \"Bob Marley\", \"age\": 36 }"
+  }
+}
+```
+
+### Изображения и медиафайлы
+
+Существует два способа отправки изображений и других медиафайлов, таких как видео или аудио:
+1. JSON Base64: `data:image/jpeg;base64,...`
+2. Загрузка как артефакта.
+
+#### JSON Base64
+
+```bash
+curl --location --request POST 'https://piper.my/api/pipeline-slug/launch' \
+--header 'content-type: application/json' \
+--header 'api-token: [YOUR_API_KEY_HERE]' \
+--data '{
+  "inputs": {
+    image: "data:image/jpeg;base64,..."
+  }
+}'
+```
+
+:::danger Ограничения
+
+Для обеспечения стабильности и производительности JSON ограничен 2048 КБ.
+Большие медиафайлы загружайте как артефакты.
+
+:::
+
+#### Загрузка артефакта
+
+Piper имеет собственное временное хранилище для обработки больших медиафайлов.
+
+```bash
+curl --location --request POST 'https://piper.my/api/artefacts' \
+--header 'api-token: [YOUR_API_KEY_HERE]' \
+-F "file=@/path/to/your/file.jpg"
+```
+
+После загрузки вы получите URL-адрес для доступа к файлу.
+
+:::danger Ограничения
+
+Ваш файл будет автоматически удален примерно через 48 часов.
+
+:::
+
+## Статус конвейера
+
+```bash
+curl --location --request GET 'https://piper.my/api/launches/[LAUNCH_ID]/state' \
+--header 'api-token: [YOUR_API_KEY_HERE]'
+```
+
+В зависимости от типа конвейера мы рекомендуем проводить опрос каждые 2–5 секунд.
+
+Поскольку выходные данные в конвейере устанавливаются асинхронно, вам необходимо дождаться всех ожидаемых выходных данных.
+
+:::tip Вопрос
+
+> Поддерживаете ли вы вебхуки или потоковые события?
+
+**Это произойдет совсем скоро!**
+
+Пожалуйста, [проголосуйте](https://github.com/my-piper/piper/issues/17), чтобы выразить свою поддержку.
+
+:::

package.json

@@ -4,7 +4,7 @@
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
-    "start": "docusaurus start",
+    "start": "docusaurus start --port 4000",
     "build": "docusaurus build",
     "swizzle": "docusaurus swizzle",
     "deploy": "docusaurus deploy",