From 47dd849528d60a07e6c3e1933e5b4b6f99ea3b29 Mon Sep 17 00:00:00 2001
From: Lacky1234union <rogachevegorushka@yandex.ru>
Date: Mon, 12 Oct 2026 18:22:22 +0300
Subject: [PATCH] =?UTF-8?q?docs:=20=D1=80=D0=B5=D1=82=D1=80=D0=B0=D0=B8=20?=
 =?UTF-8?q?curl=20=D0=B4=D0=BB=D1=8F=20=D0=BD=D0=B5=D1=81=D1=82=D0=B0?=
 =?UTF-8?q?=D0=B1=D0=B8=D0=BB=D1=8C=D0=BD=D0=BE=D0=B3=D0=BE=20=D1=81=D0=BE?=
 =?UTF-8?q?=D0=B5=D0=B4=D0=B8=D0=BD=D0=B5=D0=BD=D0=B8=D1=8F=20=D1=81=20API?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Refs #1

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 docs/dev/SOURCECRAFT_API.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/dev/SOURCECRAFT_API.md b/docs/dev/SOURCECRAFT_API.md
index a3c29ed..000f826 100644
--- a/docs/dev/SOURCECRAFT_API.md
+++ b/docs/dev/SOURCECRAFT_API.md
@@ -8,6 +8,7 @@
 set -a; . ./.env; set +a                     # SOURCECRAFT_TOKEN
 R=https://api.sourcecraft.tech/repos/rogachevegorushka/tgit
 H="Authorization: Bearer $SOURCECRAFT_TOKEN"
+alias curl='curl --retry 4 --retry-all-errors --retry-delay 2'
 J="Content-Type: application/json"
 ```
 
@@ -15,6 +16,7 @@ J="Content-Type: application/json"
 
 ## Подводные камни
 
+- Соединение с `api.sourcecraft.tech` иногда рвётся (`curl: (35)`, пустой ответ) — отсюда `--retry`. Перед повторным POST проверить, не создалась ли сущность.
 - `color` у метки — hex **без** `#` (`"ff7f0e"`), иначе `400 ValidationError`.
 - Ответы-списки кладут элементы в разные ключи: `/issues` → `issues`, `/labels` репо → `items`, метки issue → `labels`.
 - Issue адресуется номером (`issues/1`), метка — slug'ом (`size/0.5` → `size-0-5`).