Support
API를 통한 공급업체 서비스와 SMM 패널 카테고리 매핑

API를 통해 공급업체 서비스를 SMM 패널 카드와 연결하는 방법

공급업체 카탈로그와 패널 진열을 분리해야 하는 이유

공급업체 API는 보통 기술적 카탈로그를 반환합니다: 외부 ID, 이름, 가격, 한도, 상태, 주문 파라미터 등입니다. SMM 패널에서는 동일한 항목이 고객이 이해할 수 있는 구조에 들어가야 합니다: 플랫폼, 프로모션 유형, 지역, 링크 형식, 오디언스 품질 또는 시작 속도 등입니다.

외부 카탈로그를 가공 없이 그대로 노출하면 진열에 기술적인 이름, 중복, 사용할 수 없는 항목이 나타납니다. 매핑은 구매 로직과 고객용 카드를 분리합니다. 공급업체 서비스 하나가 반드시 패널의 개별 서비스가 되어야 하는 것은 아닙니다.

API를 통해 받아야 하는 데이터

공급업체의 원본 데이터는 진열 설정과 별도로 저장하세요. 외부 ID를 패널의 내부 식별자로 대체해서는 안 됩니다. 주문 생성, 상태 조회, 취소, 오류 분석에 필요하기 때문입니다. 마지막 동기화 시간과 전체 API 응답 또는 그 스냅샷을 저장하는 것도 유용합니다.

  • 공급업체 식별자와 서비스 외부 ID.
  • 이름, 설명, 외부 카테고리.
  • 구매 가격, 통화, 계산 단위.
  • 최소·최대 수량과 수량 단위.
  • 이용 가능 상태, 잔여량, 일시 중지 표시.
  • 링크, 로그인, 게시물, 댓글, 지역에 대한 요구사항.
  • 수동 시작, 취소, 재시작, 부분 이행 표시.

자동 가져오기의 단점은 공급업체마다 동일한 필드를 다르게 부르고 때로는 불완전한 데이터를 전달한다는 점입니다. 서비스 이름은 안정적인 연결에 적합하지 않습니다. 외부 ID 변경 없이 이름이 바뀔 수 있기 때문입니다.

서비스 카탈로그 요청 및 응답 예시

API 형식은 공급업체에 따라 다르지만 로직은 보통 동일합니다: 패널이 액세스 키와 페이지 파라미터를 전달하고, 응답으로 서비스 배열을 받습니다. 예를 들어 커서를 사용하는 카탈로그 요청은 다음과 같을 수 있습니다:

GET /api/services?cursor=eyJwYWdlIjoyfQ

가상의 API 응답:

{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }

응답 필드를 진열 카드에 바로 기록해서는 안 됩니다. 먼저 검증하고, 공급업체 카탈로그에 저장하고, 내부 규칙과 매핑해야 합니다. 완성된 카드만 다루는 방식의 단점은 가져오기가 고객용 이름, 설명 또는 수동으로 선택한 카테고리를 덮어쓸 수 있다는 것입니다.

먼저 패널의 카테고리 구조를 정의하세요

가져오기 전에 패널의 분류 체계를 정하세요. 최상위 수준은 보통 플랫폼을 설명하고, 다음은 액션입니다: 팔로워, 조회수, 반응, 댓글, 방송 시청자 또는 다른 형식입니다. 내부에서는 서비스를 지역, 오디언스 유형, 속도, 보상 조건으로 나눌 수 있습니다.

각 카테고리에 필수 속성을 지정하세요. 조회수의 경우 링크 유형과 콘텐츠 형식일 수 있고, 팔로워의 경우 플랫폼, 지역, 허용되는 프로필 유형입니다. 구조가 너무 세분화된 경우의 단점은 카탈로그 유지 관리가 더 어려워지고 유사한 서비스가 내부적인 차이만으로 구분되기 시작한다는 것입니다.

공급업체와 진열의 연결을 별도로 저장하세요

공급업체 서비스와 패널 카드 간의 연결은 별도 테이블이나 엔티티에 저장해야 합니다. 여기에는 공급업체, 외부 ID, 내부 카드, 카테고리, 가격 규칙, 라우트 우선순위, 게시 상태, 마지막 성공 확인 날짜가 필요합니다.

이러한 구조는 카드 URL 변경 없이, 주문 이력 손실 없이 공급업체를 교체할 수 있게 합니다. JSON 형식의 매핑 행 예시:

{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

공급업체 서비스 ID와 SMM 패널 카테고리 및 진열 카드의 연결 다이어그램

연결은 다양할 수 있지만 각각에 대해 업데이트 규칙을 미리 정의하세요.

  • 공급업체 서비스 하나 — 고유한 파라미터와 주문 형식이 있는 경우 카드 하나.
  • 여러 공급업체의 서비스 여러 개 — 요구사항과 조건이 호환되는 경우 카드 하나.
  • 공급업체 서비스 하나 — 진열이 언어, 세그먼트 또는 판매 방식으로 분리하는 경우 카드 여러 개.

여러 공급업체를 하나의 카드로 통합하는 것의 단점은 속도, 가용성, 실제 이행 조건이 다를 수 있다는 것입니다. 링크 형식, 한도, 필수 필드가 다른 라우트는 통합하지 마세요.

카탈로그를 페이지별로 가져오세요

공급업체는 번호, 오프셋 또는 커서를 통해 카탈로그를 페이지로 나누어 제공할 수 있습니다. 첫 번째 응답에 모든 서비스가 반드시 포함되는 것은 아닙니다. API가 커서, 계속 링크 또는 데이터 존재를 나타내는 다른 명확한 신호를 전달하는 동안 다음 페이지를 요청하세요.

커서 페이지네이션의 경우 처리 과정은 다음과 같습니다: 패널이 페이지를 받고, 모든 서비스를 저장하고, 현재 주기에서 발견된 것으로 기록한 다음에만 다음 커서로 넘어갑니다. next_cursor 필드가 없으면 순회가 완료된 것으로 간주합니다.

  1. 현재 동기화 주기의 식별자를 생성합니다.
  2. 첫 페이지를 요청하고 받은 서비스를 저장합니다.
  3. 각 서비스의 last_seen_sync 필드를 주기 식별자로 업데이트합니다.
  4. 다음 요청을 실행하기 전에 다음 페이지의 커서를 저장합니다.
  5. 모든 페이지 순회가 성공한 후 카탈로그를 현재 주기와 비교합니다.

페이지를 순차적으로 로드하는 것의 단점은 전체 가져오기가 더 오래 걸릴 수 있다는 것입니다. 병렬 요청은 프로세스를 가속화하지만 API 제한에 부딪히거나 서로 다른 카탈로그 상태의 페이지를 받을 위험이 높아집니다.

재동기화 시 중복을 생성하지 마세요

기존 서비스를 찾으려면 복합 키를 사용하세요: 공급업체 식별자와 서비스 외부 ID입니다. 매번 다시 가져올 때 먼저 이 쌍으로 레코드를 검색한 다음 기술적 필드를 업데이트하세요. 새 레코드는 이러한 키가 없을 때만 생성하세요.

중복 제거에 이름, 가격, 카테고리를 사용하지 마세요. 서로 다른 두 서비스가 이러한 값을 공유할 수 있고, 공급업체가 외부 ID 변경 없이 항목 이름을 바꿀 수 있습니다. 진열과의 연결에도 고유한 제어가 필요합니다: 작업을 다시 실행한 후 동일한 라우트가 두 번 나타나서는 안 됩니다.

데이터베이스 수준에서 고유성을 제한하는 것이 유용합니다: 공급업체 카탈로그의 경우 supplier_id + external_service_id, 매핑의 경우 supplier_id + external_service_id + showcase_card_id입니다. 엄격한 제한의 단점은 기존 연결에 오류가 있는 경우 새 레코드를 그 위에 생성하는 대신 명시적으로 수정해야 한다는 것입니다.

삭제되고 사라진 서비스를 찾는 방법

서비스는 모든 페이지 순회가 완전히 성공한 후에만 사라진 것으로 간주할 수 있습니다. 동기화가 오류, 요청 한도 또는 API 접근 불가로 중단된 경우, 이미 로드된 카탈로그 부분에 없는 항목을 삭제된 것으로 표시할 수 없습니다.

가져오기가 완료된 후 해당 공급업체의 서비스 중 last_seen_sync가 현재 주기 식별자와 같지 않은 것을 찾으세요. 이들에게 '찾을 수 없음' 또는 '아카이브됨' 상태를 부여하고, 새 주문에서 비활성화하고, 검토를 위해 보냅니다. 외부 ID, 변경 이력, 주문과의 연결은 보존합니다.

사라진 서비스는 삭제하지 말고 아카이브해야 합니다. 공급업체가 나중에 카탈로그에 다시 반환하거나, 응답 필터를 변경하거나, 항목을 일시적으로 숨길 수 있습니다. 동일한 외부 ID가 다시 나타나면 다음 가져오기 시 아카이브 연결을 복원할 수 있습니다.

서비스 외부 ID가 변경될 때 해야 할 일

공급업체가 기존 서비스 대신 새 서비스를 생성한 경우, 새 외부 ID를 이전 것의 연속으로 자동 간주할 수 없습니다. 이름과 가격이 동일하더라도 항목의 주문 요구사항, 지역, 오디언스 유형 또는 보상 조건이 변경될 수 있습니다.

기존 연결을 아카이브로 전환하고, 판매에서 라우트를 제거하고, 기존 주문을 위해 보존하세요. 새 서비스는 별도 레코드로 가져오세요. 그런 다음 기술적 파라미터가 완전히 호환되는 경우 수동으로 또는 안전한 규칙에 따라 새 매핑을 생성하세요.

이름으로 자동 매칭하면 작업을 가속화할 수 있지만, 그 단점은 부적합한 조건의 다른 서비스로 주문을 보낼 위험입니다. ID 변경에는 라우트를 조용히 교체하는 대신 '검토 필요' 상태를 사용하는 것이 좋습니다.

안정적인 기술적 필드로 매핑을 설정하세요

서비스의 자동 분배는 필드 집합을 기반으로 구축하는 것이 좋습니다: 플랫폼, 서비스 유형, 지역, 링크 형식, 최소 수량, 추가 파라미터, 상태 등입니다. 예를 들어 API가 호환되는 플랫폼, 프로모션 유형, 국가 값을 전달하면 서비스가 지역별 조회수 카테고리에 들어갈 수 있습니다.

공급업체가 댓글, 프로필 목록 또는 수동 시작을 요구하는 경우 표준 주문 양식에 라우트를 게시하지 마세요. 필요한 필드가 있는 별도 카드를 사용하거나 통합 개선 전까지 서비스를 숨김 상태로 두세요.

이름은 추가 속성으로만 사용하는 것이 허용됩니다. 이러한 규칙의 단점은 공급업체가 표현을 변경하거나, 약어를 추가하거나, 다른 표기를 사용할 수 있다는 것입니다. 중요한 라우트는 외부 ID와 검증 가능한 응답 파라미터에 연결하세요.

API 데이터와 카드 설정을 분리하세요

가져오기가 진열 카드를 완전히 덮어써서는 안 됩니다. 구매 가격, 한도, 가용성, 기술적 파라미터는 보통 공급업체로부터 업데이트됩니다. 고객용 이름, 설명, 가시성, 표시 순서, 마크업 규칙은 패널의 내부 설정으로 남습니다.

각 필드에 대해 진실의 원천을 지정하세요. 예를 들어 최소 수량은 API에서 가져오고, 고객용 이름은 패널에서 가져오며, 진열 가격은 구매 원가를 기반으로 내부 규칙에 따라 계산됩니다. 이러한 분리 없이는 동기화가 수동으로 편집한 설명을 지우거나 외부 이름에 따라 카테고리를 변경할 수 있습니다.

가격 및 파라미터 변경을 확인하세요

공급업체가 가격을 변경한 경우 카드 규칙에 따라 진열 가격을 재계산하고 통화, 수수료, 허용 마진을 확인하세요. 가격이 없거나, 통화를 알 수 없거나, 조건이 눈에 띄게 변경된 경우 라우트를 검토 상태로 전환하는 것이 좋습니다.

최소, 최대 또는 수량 단위가 변경되면 주문 양식을 업데이트하세요. 양식이 새로운 제한을 지원하지 않으면 판매에서 라우트를 제거하세요. 그렇지 않으면 고객이 주문을 완료하고 공급업체가 전송 후 거부하게 됩니다.

링크 형식, 필수 필드, 서비스 유형 또는 시작 방식이 변경된 경우 수동 검토 전까지 새 주문을 차단하세요. 엄격한 차단의 단점은 일부 카드가 진열에서 일시적으로 사라진다는 것이지만, 호환되지 않는 주문을 받는 것보다 안전합니다.

API 오류 및 요청 제한을 처리하세요

하나의 요청 오류가 전체 카탈로그를 자동으로 비활성화해서는 안 됩니다. 인증 오류, 잘못된 요청, 일시적 접근 불가, 요청 빈도 제한을 구분하세요. 각 그룹에는 별도의 시나리오가 필요합니다.

  • 인증 오류 시 해당 공급업체에 대한 새 주문을 중단하고 액세스를 확인하세요.
  • 요청 형식 오류 시 API 응답을 저장하고 무한 반복 없이 통합을 수정하세요.
  • 일시적 오류 시 증가하는 대기 시간으로 요청을 재시도하세요.
  • 빈도 제한 시 현재 커서를 저장하고 작업을 재시도로 이동하세요.

지연된 동기화가 성공적으로 완료될 때까지 서비스를 사라진 것으로 표시하지 마세요. 공격적인 재시도의 단점은 요청 한도를 더 빨리 소진하고 카탈로그를 더 오랜 기간 오래된 상태로 남길 수 있다는 것입니다.

활성 주문을 위한 라우트를 보존하세요

서비스 상태와 주문 상태는 서로 다른 엔티티입니다. 서비스가 신규 고객을 위한 카탈로그에서 사라질 수 있지만, 해당 서비스의 기존 주문은 여전히 이행 중일 수 있습니다. 카드 또는 라우트의 아카이빙이 이미 생성된 주문의 상태 조회를 중단해서는 안 됩니다.

각 주문에 대해 서비스 외부 ID, 주문 외부 ID, 전송된 파라미터, 시작 시점의 구매 비용, 상태 이력을 저장하세요. 공급업체가 부분 이행, 취소 또는 오류를 보고하면 패널 규칙에 따라 상황을 처리하세요: 환불, 보상, 재시작 또는 수동 검토.

주문 파라미터 스냅샷 저장의 단점은 더 많은 공간과 신중한 데이터 스키마가 필요하다는 것입니다. 이러한 스냅샷 없이는 공급업체가 나중에 서비스를 변경한 경우 주문이 어떤 조건으로 전송되었는지 확인할 수 없습니다.

카드 게시 전에 매핑을 테스트하세요

설정 후 전체 경로를 확인하세요: 패널에서 주문 생성, 라우트 선택, 공급업체로 전송, 외부 ID 저장, 상태 수신, 취소, 부분 이행 처리 등입니다. 한도, 링크, 필수 필드가 다른 서비스 그룹을 테스트하세요.

별도로 재가져오기, 가격 변경, 성공적인 전체 순회 후 서비스 사라짐, 페이지네이션 중간 오류, 요청 빈도 제한을 시뮬레이션하세요. 이를 통해 패널이 불완전한 카탈로그 로드로 인해 작동 중인 라우트를 아카이브하지 않는지 확인할 수 있습니다.

수동 서비스와 댓글이 있는 항목에 특별히 주의하세요. 이들의 단점은 표준 패널 양식이 공급업체가 기대하는 모든 데이터를 전송하지 못하는 경우가 많다는 것입니다. 이들에게는 별도 주문 템플릿 또는 API 통합 개선 전까지 숨김 상태가 필요합니다.

Last Articles

새로운 사이트 디자인

디자인과 기능에서 변경된 사항 사이트를 더 빠르고 편리하게 사용할 수 있도록 업데이트했습니다. 주요 변경 사항은 인터페이스, 개인 계정 및 주문 관리와 관련이 있습니다. 데이터베이스 쿼리 최적화 덕분에 페이지 로딩 속도가 평균 3분의 1 빨라졌습니다. 내비게이션 메..

2026-08-15 신규

News SP

Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..

2026-04-08 업데이트

01.01.2026까지 진행 중인 모든 프로모션과 추첨을 여러분을 위해 모았습니다

1. 모든 시청자분들께 15% 할인을 드리는 프로모션 코드 "December2025"를 사용하세요2. 1월 1일까지 당사 구성 도구와 가장 저렴한 시청자 카테고리의 기준 가격을 25% 인하했습니다3. 당사 채널에서 3개의 추첨이 진행 중입니다! - 당사 구매 ..

2025-12-26 종료

분대 및 리셀러와의 협력

트위치 서비스는 안정적으로 일해서,그래서 우리는 분대,전매자와 협력하게 준비되어 있습니다, 서비스 소유자,봇 소유자 및 기타 많은 사람들.개별 용어는 전보에서 관리자와 논의 할 수 있습니다...

2025-10-22 파트너 대상

트 위치 시청자는 안정적이지만 약간의 뉘앙스가 있습니다.

우리 완전히 우리의 트 뷰어 서비스를 업데이트 한,그들은 지금 안정적으로 일. 우리는 시청자에 대한 높은 품질의 아이피 주소를 사용합니다.뉘앙스는 최대 150 명의 시청자를 위한 주문에 있습니다. 전체 시청자 수가 200 명에 도달하면 떨어집니다.에 대한 예..

2025-10-22 업데이트

Twitch Viewer Configurator

Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..

2025-06-15 신규

If YouTube is blocked, where to stream now?

Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..

2022-03-16 중요

API SP

We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..

2021-09-02 파트너 대상

파트너 및 추천: 새로운 약관!

파트너십 서비스와 추천 프로그램의 엄청난 인기로 인해, 우리는 협력 테이블을 만들었습니다. 요점은 매우 간단합니다. 더 많은 라이브 청중 - 우리의 더 많은 광고.프로그램 약관을 다운로드하거나 확인하세요파트너에게 설정된 내용을 다운로드하려면 (소개 + 로고)스트리머의 ..

2020-08-12 파트너 대상

시청자 관리 패널 [Twitch | Kick | YouTube | VK Video Live]

나만의 맞춤 요금제를 만드세요
잔액 충전, 원클릭 주문, 할인 및 보너스는 회원만 이용할 수 있습니다. 회원가입.
원하는 서비스를 찾지 못했거나 더 저렴한 곳을 찾으셨다면 텔레그램 고객지원 또는 채팅으로 문의하세요. 무엇이든 해결해 드립니다.
신규

Telegram 봇 @BOT_SP_RU_BOT

1분 만에 주문·재주문, 잔액과 주문 상태 확인 — Telegram에서 바로

주문 반복주문 상태잔액 충전프로모션 코드