ziponia / lib

java open api client library - 미래의 내가 나에게 감사하기를...

써드파티 Rest Client Repository

개발하면서, 자주 쓸만한 Rest Client 를 정리 해 논 디펜던시 입니다.

Usage Example https://fe.ziponia.com

구현 예시 코드는 이곳에서 볼 수 있습니다.

https://github.com/ziponia/lib-server

Getting Start

이 Repository 사용하려면, 먼저 jitpack 레포지토리를 추가하세요.

maven

<project>
    <repositories>
        <repository>
            <id>jitpack.io</id>
            <url>https://jitpack.io</url>
        </repository>
    </repositories>
</project>

Gradle

allprojects {
    repositories {       
        maven { url 'https://jitpack.io' }
    }
}

모듈 추가

이 라이브러리는 최상위 lib 프로젝트의 각각의 독립성있는 submodule 로 이루어져 있습니다.

사용하고자 하는 Repository 를 추가하세요.

예를들어, google 에서 제공하는 library 를 사용한다면, 아래와같이 추가하세요.

maven

<dependency>
    <groupId>com.github.ziponia.lib</groupId>
    <artifactId>google</artifactId>
    <version>4b8ddcf00f</version>
</dependency>

Gradle

implementation 'com.github.ziponia.lib:google:4b8ddcf00f'

이 라이브러리는 아직 개발중입니다. version 레이블에 master-SNAPSHOT 을 버전으로 지정함으로써, 가장 최신의 커밋내용을 불러 올 수 있습니다.

예)

<dependency>
    <groupId>com.github.ziponia.lib</groupId>
    <artifactId>{library name}</artifactId>
    <version>master-SNAPSHOT</version>
</dependency>

더 많은 분기는 이곳 에서 확인 하세요.

현재 지원되는 모듈 리스트 참조 Docs

• 유틸리티
• kakao api 모듈
  • 웹 검색
  • 주소 검색
  • 좌표-행정구역정보-변환
  • 번역
  • 썸네일 생성
  • 동영상 검색
• 11번가 상품 모듈
  • 상품검색
  • 상품정보 조회
• Google api 모듈
  • maps
    • 주변 장소 찾기
    • 장소 사진
  • youtube
    • 동영상 검색
• 아임포트 결제 모듈
  • 간편결제
  • 구매자 빌링키 관리
  • 결제내역 조회
  • 아임포트 고유 거래번호로 결제내역 조회
• Naver api 모듈
  • 검색
    • 뉴스검색

lib's Issues

확률 유틸리티 추가

동영상 검색 API

@ref https://developers.kakao.com/docs/restapi/search#동영상-검색

Place Search Near optional parameter 구성이 누락됨

장기적 호환을 위해 프로젝트를 Gradle 로 변경하자

디펜던시 설정이 훨씬 깔끔해지고, 빌드 속도가 빨라진다고 한다.

잡코리아 api 구현 불가

http://company.jobkorea.co.kr/Network/Api.asp

내용 중

Q
기업이 아닌 개인 사업자 입니다. 잡코리아 XML을 사용할 수 있을까요?

A물론입니다. API 신청양식을 제출해 주실 때 관련 정보를 정확히 입력하여 주시면 검토 후 승인해드립니다. 하지만 사이트 정보와 목적이 불분명할 경우 승인이 어려우며 채용정보 활용과 무관한 개인 프로젝트 개발 목적으로는 사용이 불가합니다.

라고 한다.

문제의 여지가 있겠다고 판단하여, 구현하지 않는다.

결제내역 조회 Client 구성

add mavenCentral() repository

Place Photo API 구성

@ref https://developers.google.com/places/web-service/photos

오픈뱅킹 구현 기능 추가

썸네일 생성 API

@ref https://developers.kakao.com/docs/restapi/vision#썸네일-생성

Kakao ThumbnailCropRequest 는 constructor 가 있어야 한다.

@PostMapping(value = "/kakao/thumbnail-crop", produces = MediaType.MULTIPART_FORM_DATA_VALUE)
    public Mono<ThumbnailCropResponse> thumbnail(ThumbnailCropRequest request) {
        return kakaoService.thumbnail(request);
    }

이런식으로 RequsetParameter 에 ThumbnailCropRequest 를 바인딩 할때,
Jackson2JsonEncoder 는 안의 생성 자를 찾는 것 같다.

아래는 결과 값

{
    "message": "No primary or default constructor found for class com.ziponia.kakao.client.request.ThumbnailCropRequest"
}