jintaeyeong / My-Develop-Project

for software development
1 stars 0 forks source link

[Design] e약은요 API Restful Get #25

Open jintaeyeong opened 1 month ago

jintaeyeong commented 1 month ago

API 서버에 데이터 전달 시 어떤 데이터를 보내서 Get/Post 할 것인지 설계

jintaeyeong commented 1 month ago

image

Rest Get으로 요청

jintaeyeong commented 1 month ago

문서에 작성되어 있는 REST(URI) 예제

image

개인으로 발급받은 인증키를 넣어서 API 호출해봄 image XML 형식으로 Return 됨

Get 요청 시 전달해야 되는 Data

serviceKey : 공공데이터포털에서 발급받은 인증키(개인) trustEntpName : 업체명 , (EntpName으로 key를 써도 정상적으로 처리함) pageNo : 페이지 번호 numOfRows : 한 페이지 결과 수

jintaeyeong commented 1 month ago

image

header Data 
<resultCode>00</resultCode>
<resultMsg>NORMAL SERVICE.</resultMsg>

body Data
<numOfRows>3</numOfRows>
<pageNo>1</pageNo>
<totalCount>4794</totalCount>
<items>
   <item>
      <entpName>동화약품(주)</entpName> (업체명)

      <itemName>활명수</itemName> (제품명)

      <itemSeq>195700020</itemSeq> (품목 기준 코드)

      <efcyQesitm> 
          이 약은 식욕감퇴(식욕부진), 위부팽만감, 소화불량, 과식, 체함, 구역, 구토에 사용합니다. 
      </efcyQesitm> (효능)

      <useMethodQesitm> (사용법)
           만 15세 이상 및 성인은 1회 1병(75 mL), 만 11세이상~만 15세미만은 1회 2/3병(50 mL), 만 8세 이상~만 11세 미만은 1회 1/2병(37.5 mL), 만 5세 이상~만 8세 미만은 1회 1/3병(25 mL), 만 3세 이상~만 5세 미만은 1회 1/4병(18.75 mL), 만 1세 이상~만 3세 미만은 1회 1/5병(15 mL), 1일 3회 식후에 복용합니다. 복용간격은 4시간 이상으로 합니다. 
       </useMethodQesitm>

       <atpnWarnQesitm/> (주의사항 경고)

       <atpnQesitm> (주의사항)
              만 3개월 미만의 젖먹이는 이 약을 복용하지 마십시오. 이 약을 복용하기 전에 만 1세 미만의 젖먹이, 임부 또는 임신하고 있을 가능성이 있는 여성, 카라멜에 과민증 환자 또는 경험자, 나트륨 제한 식이를 하는 사람은 의사 또는 약사와 상의하십시오. 정해진 용법과 용량을 잘 지키십시오. 어린이에게 투여할 경우 보호자의 지도 감독하에 투여하십시오. 1개월 정도 복용하여도 증상의 개선이 없을 경우 복용을 즉각 중지하고 의사 또는 약사와 상의하십시오. 
       </atpnQesitm>

       <intrcQesitm/> (상호작용)
       <seQesitm/> (부작용)

       <depositMethodQesitm>
            습기와 빛을 피해 실온에서 보관하십시오. 어린이의 손이 닿지 않는 곳에 보관하십시오. 
       </depositMethodQesitm> (보관법)

       <openDe>2021-01-29 00:00:00</openDe> (공개일자)

       <updateDe>2024-05-09</updateDe> (수정일자)

       <itemImage/> (낱알이미지)

       <bizrno>1108100102</bizrno> (정보 없음,, 모르겠다) 
    </item>
</items>
jintaeyeong commented 1 month ago

image

에러코드 조치방안

jintaeyeong commented 1 month ago
  1. Flutter App에서 http 패키지 사용할 수 있도록 패키지 설정 및 Import

  2. Interface 설계 Service 클래스를 제작하여 API 통신을 관리하도록 설계 비동기로 받을 수 있도록 할 것

  3. 서버에서 받은 Json 데이터를 Data Class로 Response

jongfeel commented 1 month ago

json으로도 받을 수 있다면 json으로 하는게 좋을 것 같습니다.