/api/v1/scope/catalogue/runsСтартиране на проверката на каталога
Стартира нова проверка на целия каталог спрямо актуалните правила. Изпълнението се поставя на опашка веднага и се изпълнява асинхронно; отговорът е 202 с runId за проследяване. Каталогът се обновява и автоматично всяка нощ.
Изисква Growth или по-висок план. Idempotency-Key се зачита: използвайте повторно същия ключ в рамките на 24 часа, за да получите оригиналното изпълнение. 409 run_in_progress когато изпълнение вече е в опашка. 429 run_cooldown с retryAfter ако изпълнение е приключило по-малко от 10 минути преди.
Хедъри
- Authorizationзадължително
string
Bearer <token>— илиtp_API ключ (Developer → API Keys; най-просто, за server-to-server), или OAuth 2.0 access token (Developer → OAuth Apps; за приложения, авторизирани от потребител, scoped и отзоваеми). Страницата Authentication съдържа пълния OAuth поток и списъка със scopes.e.g. Bearer tp_REDACTED_xxxxxxxxxxxx
- Idempotency-Key
string
UUID v4 за логическа заявка за изпълнение. Повторна употреба в рамките на 24 часа връща същото изпълнение.
Заявка
curl -sS -X POST https://app.tracepass.eu/api/v1/scope/catalogue/runs \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
-H "Idempotency-Key: 7b4f1e2c-9a3d-4e5b-8c1a-2d3e4f5a6b7c"Отговор
{ "runId": "6acbb533c5553f06d833479e", "status": "queued" }