API (추출작업 상태, 결제정보)

API (추출작업 상태, 결제정보)

본 문서에 포함된 API Endpoint 들은 실험 목적으로 개발, 운영 중입니다.

API 기본 사용법은 API (추출데이터)에서 확인해주세요.

API (추출작업 상태, 결제정보) 종류

• 결제정보 (Billing): 구독 중인 상품에 대한 결제 정보를 보여줍니다.

• 싱글추출 상태 (SingleTask Status): 추출작업의 상태 (wait, doing, success, fail) 를 보여줍니다.

• 그룹추출 상태 (GroupTask Status): 추출작업의 상태 (wait, doing, success, fail) 를 보여줍니다.

API Endpoint & Response

Billing (결제정보) API

종류	URI	요청방식
Billing	https://listly.io/api/billing	GET
	다음 정보들을 반환합니다. plan: 구독 중인 플랜 reset: 다음 달 구독 갱신일 expire: (연간구독일 경우) 구독 만료일 usage: 사용가능한 URL 개수 proxy: 자동결제로 추가구매할 프록시서버 url: 자동결제로 추가구매할 URL autopay: 다음 달 자동결제 여부

{
    "plan": "business",
    "reset": "2023-04-17T19:00:00+09:00",
    "expire": "2023-09-05T13:48:39.443+09:00",
    "usage": {
        "available": 8738,
        "total": 9000
    },
    "addon": {
        "proxy": {
            "currency": "KRW",
            "price": 0
        },
        "url": {
            "currency": "KRW",
            "price": 0
        }
    },
    "autopay": false
}

SingleTask (싱글추출 상태) API

종류	URI	요청방식
SingleTask Status	https://listly.io/api/single/status?key=<singlekey>	GET
	다음 정보들을 반환합니다. key: 싱글추출의 taskkey type: whole 또는 part (전체 또는 부분추출) status: 추출상태 (wait, doing, success, fail) updated: 추출작업 최근 변경일 created: 추출작업 최초 생성일

{
    "key": "SGzSoRqJ",
    "type": "part",
    "status": "success",
    "updated": "2023-04-11T08:45:01.109+09:00",
    "created": "2022-12-02T17:23:46.108+09:00"
}

GroupTask (그룹추출 상태) API

종류	URI	요청방식
Group info. & GroupTask Status	https://listly.io/api/group/status?key=<groupkey>	GET
	다음 정보들을 반환합니다. key: 그룹추출의 taskkey type: whole 또는 part (전체 또는 부분추출) name: 그룹 이름 status: 추출상태 (wait, doing, success, fail) updated: 추출작업 최근 변경일 created: 추출작업 최초 생성일 tasks: 등록된 그룹추출 작업들 정보 및 추출상태

{
    "key": "vk9q2sJQ",
    "type": "part",
    "name": "www.youtube.com",
    "status": {
        "success": 246,
        "total": 246
    },
    "updated": "2022-09-29T00:19:33.794+09:00",
    "created": "2022-09-28T23:47:16.708+09:00",
    "tasks": [
        {
            "url": "https://www.youtube.com/watch?v=0KnUyy6pH-U",
            "status": "success",
            "updated": "2022-09-29T00:08:13.905059+09:00",
            "created": "2022-09-28T23:47:17.102288+09:00"
        },
        {
            "url": "https://www.youtube.com/watch?v=bGpzWPUbP3s",
            "status": "success",
            "updated": "2022-09-28T23:47:20.634761+09:00",
            "created": "2022-09-28T23:47:17.102359+09:00"
        },
        
				...,

        {
            "url": "https://www.youtube.com/watch?v=QD0by6q-9Go",
            "status": "success",
            "updated": "2022-09-28T23:58:49.095977+09:00",
            "created": "2022-09-28T23:47:17.116181+09:00"
        }
    ]
}