가져오기¶

POST /api/v1/tag/import

개요¶

전역 태그 템플릿을 일괄 가져옵니다. 이름 중복 검사, 건너뛰기 및 덮어쓰기를 지원합니다.

Body 요청 매개변수¶

매개변수 추가 설명¶

이 API는 전역 태그 템플릿을 별도로 가져오는 데 사용됩니다.

호출 흐름

1. tags 배열을 준비합니다. 각 요소는 하나의 태그 템플릿을 나타냅니다.
2. repeatTagNameOp를 통해 동일한 이름의 태그가 있을 때의 처리 전략을 지정합니다.
3. 전략이 check이고 동일한 이름의 태그가 존재하면 API는 repeat_name을 직접 반환하며 데이터베이스에 저장하지 않습니다.

repeatTagNameOp 설명

템플릿 필드

응답 설명

• 가져오기 실행 성공 시 successCount, failCount 반환
• 일부 객체가 실행 실패 시 응답에 추가로 failedNames 포함
• check 모드에서 중복 발견 시 repeat_name 반환

요청 예시¶

curl 'https://openapi.guance.com/api/v1/tag/import' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"repeatTagNameOp":"recover","tags":[{"name":"핵심 서비스","description":"핵심 서비스 태그","colour":"style_key3"}]}'

응답¶

{
    "code": 200,
    "content": {
        "successCount": 2,
        "failCount": 0
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-EXAMPLE"
}