계란 개수 API

귀하의 시스템에서 직접 난관, 차단 및 현장 방문 데이터를 참조하고 보내십시오. 이 페이지에는 사용 가능한 모든 공용 및 개인 끝점이 설명되어 있습니다.

/ko-kr/apiAPI 키 요청

API 정보

이 API에는 엔드포인트가 있습니다. 공개 및 비공개. 공개 API는 인증 없이 시간 경과에 따라 각 참여 지방자치단체의 위도, 경도, 알 수에 대한 데이터를 반환합니다. 비공개 API는 중요한 데이터를 노출하고 기록을 삽입, 변경 및 제거할 수 있도록 허용하므로 Conta Ovos와 협력하여 작동하는 애플리케이션에만 권장됩니다.

인증 및 키

프라이빗 API를 사용하려면 액세스 키가 필요합니다. (key). 구매하시려면 이메일로 보내주세요 contaovosdengue@gmail.com 말하다:

  • API 액세스가 필요한 이유는 무엇입니까?
  • 필요한 액세스 수준(자치단체, 지역, 주 또는 국가)
  • 귀하가 속한 지역은 어디입니까?

열쇠는 다음과 같이 구성됩니다. 무작위 문자 45개 매개변수로 전송되어야 합니다. key 각 개인 요청의 키와 연결된 지리적 범위 및 계획 (api_access_municipality_id, state_id, region_id, country_id, plan) 읽거나 변경할 수 있는 레코드를 자동으로 정의합니다. 예를 들어 자치체 키는 자치단체 자체의 데이터만 읽거나 수정할 수 있습니다.

쪽수 매기기: 매개변수 page 페이징을 지원하는 엔드포인트에서는 최대 100개를 허용합니다. 유효하지 않거나 누락된 값은 1페이지를 차지합니다.

응답 코드

모든 엔드포인트는 동일한 HTTP 상태 패턴을 따릅니다.

암호의미
200요청이 성공적으로 처리되었습니다.
400필수 매개변수가 누락되었거나 형식이 잘못되었습니다.
403통보된 리소스는 사용된 키의 범위(시/도/지역)에 속하지 않습니다.
404잘못된 키 (Wrong key) 또는 리소스를 찾을 수 없습니다.
409이 식별자, 연도, 주 조합에 대한 기록이 이미 존재합니다.
500요청을 처리하는 중 내부 오류가 발생했습니다.

공개 엔드포인트

GET/api/lastcountingpublic공공의

최근 출시된 수

알 수 및 난관 데이터와 함께 위치(도시, 주 또는 국가)별로 발표된 최신 개수를 반환합니다.

매개변수

이름유형설명
statestring주 코드. 예: state=RJ.
municipalitystring지방자치단체의 이름입니다. 예: municipality=Ponta Pora
countrystring국가 이름. 예: country=Brasil. 생략하면 "브라질"로 간주됩니다.
pageint페이지 매김 페이지(기본값 1, 최대 100)
idint지정된 ID의 항목만 표시합니다. 예: id=7876.
datedate포함된 날짜부터 발생 횟수를 표시합니다. 예: date=2025-01-01.
date_collectdate수집일 이후의 발생을 표시합니다. 예: date_collect=2024-12-12.
date_startdate개수를 필터링할 시작 날짜입니다. 예: date_start=2025-01-01.
date_enddate집계를 필터링할 종료 날짜입니다. 예: date_end=2025-12-31.

메모: 위치 매개변수가 전송되지 않으면 엔드포인트는 브라질의 최신 개수를 반환합니다.

요청 예시

curl -G -d "municipality=Ponta%20Pora" \ /ko-kr/api/lastcountingpubliccurl -G -d "state=MG" \ /ko-kr/api/lastcountingpublic

샘플 답변

[ { "state_name": "Minas Gerais", "state_code": "MG", "municipality": "Ponta Pora", "municipality_code": "5006606", "eggs": 42, "week": 3, "year": 2025, "time": "2025-01-20 14:32:10", "counting_id": 118342, "ovitrap_website_id": 981, "ovitrap_id": "97", "latitude": -7.000000, "longitude": -8.000000, "date": "2025-01-20", "date_collect": "2025-01-27" }]
GET/api/getmunicipalityblockspublic공공의

블록의 최신 작업

블록 단위로 수행된 작업(치료 방문)에 대한 데이터를 반환합니다.

매개변수

이름유형설명
statestring주 코드. 예: state=RJ.
municipalitystring지방자치단체의 이름입니다. 예: municipality=Ponta Pora
countrystring국가 이름. 예: country=Brasil. 생략하면 "브라질"로 간주됩니다.
pageint페이지 매김 페이지(기본값 1, 최대 100)

요청 예시

curl -G -d "municipality=Vista%20Alegre" \ /ko-kr/api/getmunicipalityblockspubliccurl -G -d "state=MS" \ /ko-kr/api/getmunicipalityblockspublic

샘플 답변

[ { "block_id": 4521, "block_actions_mean": 3.4, "block_coordinates": "[[-7.123, -34.845], [-7.124, -34.846]]", "municipality": "Vista Alegre", "municipality_code": "5007117", "state_name": "Mato Grosso do Sul", "state_code": "MS", "action_land_total_total": 21, "action_land_residence_total": 10, "action_land_commercial_total": 5, "action_land_empty_total": 3, "action_land_strategy_total": 1, "action_land_another_total": 2, "action_address_district": "Centro", "action_address_sector": "Setor 04", "action_deposit_a1_quantity": 4, "action_deposit_a2_quantity": 2, "action_deposit_b_quantity": 5, "action_deposit_c_quantity": 1, "action_deposit_d1_quantity": 0, "action_deposit_d2_quantity": 3, "action_deposit_e_quantity": 0, "action_observation": "Foco encontrado em pneus nos fundos do imovel.", "latitude": -7.123456, "longitude": -34.845678 }]

프라이빗 엔드포인트

아래의 모든 엔드포인트에는 매개변수가 필요합니다. key API 키로.

GET/api/lastcounting사적인

최근 출시된 수

알 수, 난관 데이터 및 책임 있는 사용자와 함께 키 범위 내에서 해제된 마지막 개수를 반환합니다.

매개변수

이름유형설명
keystring귀하의 API 키. 반환된 개수의 범위를 정의합니다.
pageint페이지 매김 페이지(기본값 1, 최대 100)
date_startdate개수를 필터링할 시작 날짜입니다. 예: date_start=2025-01-01.
date_enddate집계를 필터링할 종료 날짜입니다. 예: date_end=2025-12-31.

요청 예시

curl -G -d "key=KEY&page=1" \ /ko-kr/api/lastcounting

샘플 답변

[ { "state_name": "Minas Gerais", "state_code": "MG", "municipality": "Ponta Pora", "municipality_code": "5006606", "eggs": 42, "week": 3, "year": 2025, "time": "2025-01-20 14:32:10", "user": "Joao da Silva", "counting_id": 118342, "ovitrap_website_id": 981, "ovitrap_id": "97", "district": "Centro", "street": "Rua das Flores", "number": "123", "complement": "", "loc_inst": "", "sector": "Setor 04", "latitude": -7.000000, "longitude": -8.000000, "date": "2025-01-20", "date_collect": "2025-01-27" }]
POST/api/postcounting사적인

제출물 읽기

난관의 판독값을 보냅니다. 기존의 오비트랩에 데이터를 보내거나, 데이터를 보내고 새로운 오비트랩을 동시에 설치하는 것도 가능합니다.

매개변수

이름유형설명
keystring귀하의 API 키. 제출 범위를 정의합니다.

요청 예시

curl -X POST -d "key=KEY" \ /ko-kr/api/postcounting

새로운 난낭 트랩을 설치할 필요가 없는 표준 배송의 경우 다음 필드를 보내십시오. (모두 필수) 요청 본문에 (form):

{ "ovitrap_group_id": 97, "ovitrap_lat": -7.000000, "ovitrap_lng": -8.000000, "date": "2025-01-20", "counting_observation_id": 1, "counting_observation": "caso o counting_observation_id seja 9", "counting_eggs": 5}

각 관찰 유형의 ID가 포함된 표 (counting_observation_id):

ID의미
1관찰 없음
2설치부터 수집까지의 간격이 예상보다 길어짐
3Ovitrap 또는 누락된 팔레트
4Ovitrap 또는 깨진 팔레트
5Ovitrap 또는 팔레트가 제거됨
6건조 난관
7닫힌 집
8물로 채워진 난관
9물이 거의 없는 난관
10또 다른 관찰

배송물 옆에 새 수란 트랩을 설치하려면, 필수적인 필드: ovitrap_lat, ovitrap_lng, ovitrap_group_id

{ "ovitrap_group_id": 96, "ovitrap_address_district": "Distrito", "ovitrap_address_street": "Rua", "ovitrap_address_number": "Numero", "ovitrap_address_complement": "Complemento", "ovitrap_address_loc_inst": "", "ovitrap_lat": -7.000000, "ovitrap_lng": -8.000000, "ovitrap_address_sector": "Setor", "ovitrap_responsable": "Responsavel", "ovitrap_block_id": "Quarteirao", "date": "2025-01-20", "counting_date_collect": "2025-01-27", "counting_observation_id": 1, "counting_observation": "caso o counting_observation_id seja 9", "counting_eggs": 5}
구체적인 답변:
  • 400 — 필수 필드 중 하나라도 전송되지 않은 경우: ovitrap_lat, ovitrap_lng, ovitrap_group_id
  • 404 — 이 난관, 연도 및 주에 대한 카운트가 이미 있습니다.
POST/api/postdeletecounting사적인

읽은 내용 삭제

난관에서 판독을 제거합니다.

매개변수

이름유형설명
keystring귀하의 API 키. 제거 범위를 정의합니다.

요청 예시

curl -X POST -d "key=KEY" \ /ko-kr/api/postdeletecounting

요청 본문에 필요한 데이터 (form):

{ "ovitrap_group_id": 97, "date": "2025-01-20"}
POST/api/postdeleteovitrap사적인

난관 삭제

난소 트랩을 제거합니다.

매개변수

이름유형설명
keystring귀하의 API 키.

요청 예시

curl -X POST -d "key=KEY" \ /ko-kr/api/postdeleteovitrap

요청 본문에 필요한 데이터 (form):

{ "ovitrap_group_id": 97}
POST/api/postaction사적인

방문 삽입

블록에 방문/행동을 등록합니다. 기존 블록에 방문을 추가하려면 필드를 보내십시오. block_id. 존재하지 않는 경우 사용하십시오. block_group_id — 시스템이 자동으로 블록을 생성합니다. 이 엔드포인트는 신청자의 지방자치단체 내에 있는 블록의 삽입만 허용합니다.

매개변수

이름유형설명
keystring귀하의 API 키.

요청 예시

curl -X POST -d "key=KEY" \ /ko-kr/api/postaction

전송된 데이터 form 또는 쿼리 매개변수를 사용하여 block_id:

{ "block_id": 97, "date": "2025-01-20", "block_land_residence": 10, "action_land_residence_out": 2, "action_land_residence_breedings": 1, "action_land_residence_treated": 1, "block_land_commercial": 5, "action_land_commercial_out": 0, "action_land_commercial_breedings": 0, "action_land_commercial_treated": 0, "block_land_empty": 3, "action_land_empty_out": 1, "action_land_empty_breedings": 2, "action_land_empty_treated": 1, "block_land_strategy": 1, "action_land_strategy_out": 0, "action_land_strategy_breedings": 0, "action_land_strategy_treated": 0, "block_land_special": 0, "action_land_special_out": 0, "action_land_special_breedings": 0, "action_land_special_treated": 0, "block_land_another": 2, "action_land_another_out": 0, "action_land_another_breedings": 0, "action_land_another_treated": 0, "action_deposit_a1_quantity": 4, "action_deposit_a1_eliminated": 2, "action_deposit_a1_treated": 1, "action_deposit_a1_larvicid": 10, "action_deposit_a2_quantity": 2, "action_deposit_a2_eliminated": 1, "action_deposit_a2_treated": 0, "action_deposit_a2_larvicid": 0, "action_deposit_b_quantity": 5, "action_deposit_b_eliminated": 5, "action_deposit_b_treated": 0, "action_deposit_b_larvicid": 0, "action_deposit_c_quantity": 1, "action_deposit_c_eliminated": 0, "action_deposit_c_treated": 1, "action_deposit_c_larvicid": 5, "action_deposit_d1_quantity": 0, "action_deposit_d1_eliminated": 0, "action_deposit_d1_treated": 0, "action_deposit_d1_larvicid": 0, "action_deposit_d2_quantity": 3, "action_deposit_d2_eliminated": 1, "action_deposit_d2_treated": 2, "action_deposit_d2_larvicid": 15, "action_deposit_e_quantity": 0, "action_deposit_e_eliminated": 0, "action_deposit_e_treated": 0, "action_deposit_e_larvicid": 0, "action_observation": "Visita realizada conforme cronograma. Foco encontrado em pneus nos fundos do imovel."}

선택하다 block_group_id (아직 등록되지 않은 블록), 블록 자체의 데이터도 보냅니다.

{ "block_group_id": 97, "date": "2025-01-20", "block_address_district": "Centro Historico", "block_address_sector": "Setor 04 - Norte", "block_coordinates": "[[-7.123, -34.845], [-7.124, -34.846]]", "block_lat": -7.123456, "block_lng": -34.845678, "block_responsable": "Joao da Silva", "block_land_residence": 10, "action_land_residence_out": 2, "action_land_residence_breedings": 1, "action_land_residence_treated": 1, "block_land_commercial": 5, "action_land_commercial_out": 0, "action_land_commercial_breedings": 0, "action_land_commercial_treated": 0, "block_land_empty": 3, "action_land_empty_out": 1, "action_land_empty_breedings": 2, "action_land_empty_treated": 1, "block_land_strategy": 1, "action_land_strategy_out": 0, "action_land_strategy_breedings": 0, "action_land_strategy_treated": 0, "block_land_special": 0, "action_land_special_out": 0, "action_land_special_breedings": 0, "action_land_special_treated": 0, "block_land_another": 2, "action_land_another_out": 0, "action_land_another_breedings": 0, "action_land_another_treated": 0, "action_deposit_a1_quantity": 4, "action_deposit_a1_eliminated": 2, "action_deposit_a1_treated": 1, "action_deposit_a1_larvicid": 10, "action_deposit_a2_quantity": 2, "action_deposit_a2_eliminated": 1, "action_deposit_a2_treated": 0, "action_deposit_a2_larvicid": 0, "action_deposit_b_quantity": 5, "action_deposit_b_eliminated": 5, "action_deposit_b_treated": 0, "action_deposit_b_larvicid": 0, "action_deposit_c_quantity": 1, "action_deposit_c_eliminated": 0, "action_deposit_c_treated": 1, "action_deposit_c_larvicid": 5, "action_deposit_d1_quantity": 0, "action_deposit_d1_eliminated": 0, "action_deposit_d1_treated": 0, "action_deposit_d1_larvicid": 0, "action_deposit_d2_quantity": 3, "action_deposit_d2_eliminated": 1, "action_deposit_d2_treated": 2, "action_deposit_d2_larvicid": 15, "action_deposit_e_quantity": 0, "action_deposit_e_eliminated": 0, "action_deposit_e_treated": 0, "action_deposit_e_larvicid": 0, "action_observation": "Area com alta densidade de recipientes descartaveis."}
구체적인 답변:
  • 400 — 언제 date 전송되지 않거나 숫자 필드 중 하나가 유효한 숫자가 아닌 경우.
  • 400 — 언제 block_group_id 새 블록을 생성할 때 전송되지 않습니다.
  • 403 — 언제 block_id 정보는 주요 자치단체에 속하지 않습니다.
  • 409 — 해당 블록, 연도, 주에 대한 방문이 이미 있는 경우.
POST/api/postdeleteaction사적인

방문 삭제

한 블록에서 방문을 제거합니다.

매개변수

이름유형설명
keystring귀하의 API 키.

요청 예시

curl -X POST -d "key=KEY" \ /ko-kr/api/postdeleteaction

요청 본문에 필요한 데이터 (form):

{ "block_group_id": 97, "date": "2025-01-20"}
POST/api/postdeleteblock사적인

블록 삭제

블록을 제거합니다.

매개변수

이름유형설명
keystring귀하의 API 키.

요청 예시

curl -X POST -d "key=KEY" \ /ko-kr/api/postdeleteblock

요청 본문에 필요한 데이터 (form):

{ "block_group_id": 97}