서비스 소개

Weibo 플랫폼 구독 서비스는 Weibo 데이터 획득 시 애플리케이션의 효율성을 향상시킵니다. 키워드, 사용자, 도메인 이름 등 애플리케이션이 지정한 가입 조건에 따라 플랫폼은 새로 생성된 데이터를 실시간으로 애플리케이션에 적극적으로 푸시하며 애플리케이션은 요청 인터페이스를 폴링할 필요가 없습니다.

구독 서비스의 장점은 다음과 같습니다.

2. 네트워크 오버헤드를 절감합니다.

4. 애플리케이션 액세스 인터페이스의 효율성 ;

구독 조건

구독자:

개발자는 최대 10,000명의 사용자를 지정할 수 있습니다. 웨이보를 구독할 때 지정된 사용자가 웨이보를 게시하면 푸시됩니다. 댓글을 구독할 경우 지정되지 않은 경우 지정된 사용자가 웨이보에 게시한 댓글(지정된 사용자가 게시한 댓글이 아님)이 푸시됩니다. , 그러한 제한은 없습니다.

구독 키워드:

개발자는 최대 20,000개의 키워드를 지정할 수 있습니다. 웨이보를 구독할 때 웨이보에 지정된 키워드가 포함되어 있으면 푸시됩니다. 댓글을 구독할 때 댓글에 해당하는 웨이보에 이 키워드가 포함되어 있거나 댓글 자체에 이 키워드가 포함되어 있으면 지정되지 않은 경우 푸시됩니다. , 그러한 제한은 없습니다. 참고: 전달된 Weibo 콘텐츠에는 이 키워드가 포함되어 있지 않지만 원본 Weibo에는 포함된 경우 이 경우 푸시되지 않습니다.

구독 도메인 이름:

개발자는 도메인 이름을 최대 20개까지 지정할 수 있습니다. 웨이보 구독 시 웨이보의 짧은 링크에 해당하는 원본 링크가 지정된 도메인 이름에 있는 경우 댓글을 구독하면 해당 짧은 링크가 포함된 웨이보에 해당하는 댓글과 해당 원본 링크가 푸시됩니다. 지정된 도메인 이름으로 푸시됩니다. 지정하지 않으면 그러한 제한이 없습니다.

구독 애플리케이션:

개발자는 구독을 생성한 애플리케이션에서 생성된 데이터만 푸시하도록 지정할 수 있습니다. 지정하지 않으면 모든 애플리케이션의 데이터가 푸시됩니다.

구독 미디어 유형:

이 조건은 Weibo를 구독할 때만 지정할 수 있습니다. 개발자는 원본, 전달, 비디오, 음악 또는 사진 유형을 지정할 수 있습니다. 그런 다음 지정된 유형의 Weibo를 푸시합니다. 지정되지 않은 경우 댓글을 구독할 때 그러한 제한이 없으며 그러한 필터링 조건이 없습니다.

구독 데이터 유형:

개발자는 Weibo 또는 댓글 데이터를 푸시하도록 지정할 수 있습니다. 지정하지 않으면 기본적으로 Weibo가 푸시됩니다.

구독 비율:

개발자는 위의 구독 조건을 충족하는 데이터의 비율을 지정할 수 있습니다. 지정하지 않으면 조건을 충족하는 데이터의 1%가 푸시됩니다.

구독 기간:

개발자는 푸시 시작 시간과 종료 시간을 지정할 수 있습니다. 푸시 서비스는 지정된 시작 시간에 준비되고 종료 시간에 종료됩니다. 지정하지 않으면 시작 시간은 기본적으로 구독 생성 시간으로 설정되며 항상 푸시됩니다. 푸시 서비스가 준비되면 개발자는 인터페이스를 호출하여 연결하고 데이터를 받을 수 있습니다.

사용 단계

구독 서비스 사용 단계는 다음과 같습니다.

① 구독 생성:

개발자는 오프라인으로 구독 서비스 신청서를 작성하고, 구독 조건 등의 정보를 입력하며, 플랫폼 담당자는 신청서에 기재된 정보를 바탕으로 구독을 생성합니다. 각 애플리케이션에는 여러 구독이 있을 수 있습니다. 구독 서비스를 이용하려는 개발자는 신청서를 작성하지 않고도 온라인으로 신청서를 제출할 수 있습니다(자세한 내용은 액세스 가이드 참조).

② 구독 키워드 및 사용자 설정:

구독 서비스 신청 양식에서 "구독 키워드" 및 "구독 사용자"를 아니요로 선택한 경우 이 단계를 무시하세요. 예를 선택하는 경우 키워드 구독 목록과 사용자 구독 목록이 비어 있지 않은지 확인해야 합니다. 키워드 및 사용자 구독(이미 키워드 및 사용자를 구독한 경우 이 단계를 무시할 수 있음), 인터페이스 요청: subscribe/update_subscribe

이 인터페이스에 요청된 IP는 구독 중에 지정된 IP 목록에 있는 IP 주소여야 합니다. 그렇지 않으면 오류 메시지가 반환됩니다: IP가 제한되어 있습니다. subid만 전달되면 구독 키워드 목록과 사용자 목록을 포함하여 구독의 구독 정보가 반환됩니다.

각 키워드는 쉼표로 구분되며, 쉼표로 구분된 키워드 사이에는 논리적인 'OR' 관계가 있습니다.

각 키워드의 길이는 한자 36자를 초과할 수 없습니다.

각 키워드는 내부적으로 "AND" 및 "NOT" 논리를 지원합니다. 논리 "AND"는 "공백"으로 구분됩니다. 예를 들어 A B는 "공백 -"으로 구분됩니다. 키워드 양쪽에 큰따옴표가 있으면 키워드의 내용이 절대적으로 일치하고 논리 연산이 유효하지 않음을 의미합니다. 예를 들어 "A B"는 더 이상 논리 A와 B를 나타내지 않습니다.

각 키워드 내에서 논리 연산자로 구분된 하위 키워드의 총 개수는 1,000개를 초과할 수 없으며, 각 구독의 논리 연산자 개수는 500개를 초과할 수 없습니다.

인터페이스가 호출될 때마다 구독하는 키워드는 20개를 초과할 수 없습니다. 인터페이스에 대한 각 호출에 가입한 사용자 수는 50명을 초과할 수 없습니다. 각 구독별 키워드 및 사용자의 총합은 20,000명을 초과할 수 없으며, 반복 구독은 허용되지 않습니다.

Weibo 플랫폼은 특정 키워드와 사용자를 보호 상태로 설정하며 보호된 키워드와 사용자는 구독할 수 없습니다. 키워드를 보호한 후에는 해당 키워드가 포함된 단어를 구독할 수 없습니다. 구독 키워드와 키워드로 필터링된 데이터는 대소문자를 구분하지 않으며 단순화되거나 전통적입니다.

3 푸시 서비스 준비됨:

개발자가 신청서에 푸시 시작 시간을 지정하면 구독의 푸시 서비스가 지정되지 않은 경우 지정된 시작 시간에 푸시 서비스가 준비됩니다. 구독이 생성된 후.

4 애플리케이션 연결 및 푸시 시작:

구독이 생성되었지만 푸시 서비스가 준비되지 않은 경우 개발자 구독 관리 배경의 푸시 상태는 다음과 같이 표시됩니다. 푸시 서비스가 준비되면 준비 중입니다. 표시됨: Ready . 준비 상태에서만 애플리케이션이 인터페이스를 호출하여 데이터를 연결하고 수신할 수 있습니다. 그렇지 않으면 인터페이스를 호출할 때 오류가 보고됩니다.

통화 인터페이스는 다음과 같습니다.

● Weibo를 구독하려면 인터페이스를 호출하세요: datapush/status

● 댓글을 구독하려면 호출 인터페이스: datapush/comment

java 호출, 샘플 코드를 참조하세요.

⑤ 애플리케이션 수신 데이터:

연결에 성공하면 인터페이스는 Weibo 또는 댓글 데이터를 개발자의 연결 주소로 푸시합니다. 각각의 완전한 Weibo 또는 댓글 데이터는 json 형식으로 반환되며 UTF-8 인코딩이 기본적으로 사용되며 rn으로 구분됩니다. 각 데이터 메시지의 최대 길이는 4096바이트입니다.

반환 데이터 참조: 예.

⑥ 푸시 종료:

개발자가 푸시 종료 시간을 지정하지 않으면 푸시가 계속 푸시되고, 종료 시간을 지정하면 지정된 푸시 종료 시간에 푸시가 종료됩니다. 이는 이 구독이 만료되는 것과 동일하며 다시 시작되지 않습니다.

사용 지침

애플리케이션은 HTTP 긴 연결 요청 인터페이스 /datapush/status 또는 /datapush/comment를 통해 데이터를 수신합니다. 푸시할 구독 데이터를 플랫폼에 알리려면 매개변수 subid(구독 ID)를 전달해야 합니다. 요청이 정확하면 해당 데이터 결과가 반환됩니다. 요청이 비정상적인 경우 해당 오류 메시지가 반환됩니다.

서버에 대한 부담을 완화하기 위해 플랫폼 푸시 데이터는 10분마다 연결이 끊어지고 애플리케이션은 호환되어야 하며 재HTTP 긴 연결 요청 인터페이스가 필요하며 마지막 연결 해제의 ID 값을 매개변수 Since_id의 값을 입력합니다(예: /datapush/status?subid=xxx&since_id=XXX). 애플리케이션은 연결이 끊긴 지점에서 지속적으로 데이터를 얻을 수 있습니다. 따라서 애플리케이션은 서비스 연결이 끊어질 때 다음 요청의 매개변수 값으로 ID를 유지해야 합니다.

구독 서비스에서 푸시하는 데이터는 실시간이기 때문에 플랫폼은 5분 동안만 연결이 끊어지면 이후_id 매개변수가 더 이상 지원되지 않습니다. 오류 메시지가 반환됩니다: Illegal param Since_id (since_id Illegal, extras timelimit). Since_id가 전달되지 않으면 플랫폼은 현재 시점의 처음 50,000개 데이터 중 조건에 맞는 데이터를 필터링하여 사용자에게 푸시한다.

애플리케이션에서 불법 운영이나 기타 이유가 발견되면 플랫폼은 구독의 데이터 푸시 기능을 일시 중지합니다. 즉, 더 이상 데이터를 푸시하지 않습니다. 문제가 해결될 때까지 플랫폼은 푸시 기능을 다시 시작할 수 있습니다. 인터페이스를 다시 요청하려면 애플리케이션에 HTTP 긴 연결이 필요합니다.

또한 애플리케이션 요청 인터페이스의 IP는 구독 시 지정한 IP 목록의 IP 주소여야 합니다. 그렇지 않으면 다음과 같은 오류 메시지가 반환됩니다: IP가 제한됩니다(ip가 제한됩니다).

상태 설명

개발자 관리 센터에서는 아래 빨간색 박스와 같이 서비스의 다양한 표시 상태를 확인할 수 있습니다.

서비스 상태에는 준비 중, 준비됨, 활성화됨, 일시 중지됨, 종료됨 등 5가지가 있습니다.

1) 준비 중:

구독이 생성되었지만 개발자가 지정한 푸시 시작 시간에 도달하지 않았으며 준비 중 상태입니다(현재 개발자는 연결하여 데이터를 받을 수 없습니다). 개발자가 푸시 시작 시간을 지정하지 않으면 구독이 생성된 후 준비 상태가 없으며 바로 준비 상태로 진입합니다.

2) 준비:

구독이 생성되고 푸시 시작 시간이 도래했지만 개발자가 데이터를 수신할 수 있도록 연결되지 않아 준비 상태입니다. 또는 구독이 생성될 때 개발자가 푸시 시작 시간을 지정하지 않고 개발자가 데이터 수신을 위해 연결되지 않은 경우 서비스도 준비 상태입니다.

3) 활성화됨:

준비된 상태에서 개발자는 데이터를 수신하기 위해 연결하고 서비스는 활성화된 상태로 들어갑니다.

4) 일시 중지:

애플리케이션에 불법적인 운영이 있거나 기타 사유로 인해 플랫폼에서 구독의 푸시 기능을 일시 중지하면 서비스가 일시 중지 상태로 전환됩니다.

5) 종료됨:

개발자가 푸시 종료 시간을 지정하지 않으면 푸시가 계속 푸시되고, 종료 시간을 지정하면 지정된 푸시 종료 시간에 푸시가 종료됩니다. 이는 이 구독이 만료되는 것과 동일하며 다시 시작되지 않습니다. 현재 서비스가 종료되었습니다.