κΈ°λ³Έ Callback

κ°œμš”

Kollus μ„œλΉ„μŠ€λ₯Ό 이용 쀑 진행 상황은 직접 CMSλ₯Ό ν†΅ν•΄μ„œ 확인할 수 μžˆμŠ΅λ‹ˆλ‹€. λ‹€λ§Œ, 편의λ₯Ό μœ„ν•΄ 각 진행 μƒν™©λ§ˆλ‹€ 사전에 μ„€μ •λœ κ³ κ°μ‚¬μ˜ Web URL둜 진행 상황을 μ „μ†‘ν•˜κ³  μžˆμŠ΅λ‹ˆλ‹€.

이것을 Kollus Callback μ„œλΉ„μŠ€λΌκ³  λΆ€λ¦…λ‹ˆλ‹€. λ˜ν•œ, κ³ κ°μ‚¬μ˜ Web URL둜 Callback 전솑이 μ‹€νŒ¨ν–ˆμ„ λ•Œ μž¬μ‹œλ„ν•©λ‹ˆλ‹€.

각 μž¬μ‹œλ„ λ§ˆλ‹€ λ‚΄λΆ€μ μœΌλ‘œ 둜그λ₯Ό κΈ°λ‘ν•˜μ—¬ λͺ¨λ“  μž¬μ‹œλ„κ°€ μ‹€νŒ¨ν•  λ•Œμ—λŠ” λ¬Έμ œκ°€ 된 Callback μ „μ†‘μ˜ 원인을 νŒŒμ•…ν•˜κ³  μ •μƒμ μœΌλ‘œ Callback을 전솑할 수 μžˆλ„λ‘ ν•˜κ³  μžˆμŠ΅λ‹ˆλ‹€.

λ³Έ λ¬Έμ„œλŠ” Callback 전솑과 μž¬μ‹œλ„μ— κ΄€ν•œ Kollus Callback μ „μ†‘μ„œλ²„μ˜ 처리 과정에 λŒ€ν•΄μ„œ μ„€λͺ…ν•©λ‹ˆλ‹€.

Callback μ„€μ •

Callback 섀정은 채널과 κ΄€λ ¨λœ λΆ€λΆ„μ˜ 섀정은 κ΄€λ¦¬μž κΆŒν•œμ„ 가진 μ‚¬μš©μžκ°€ ν•΄λ‹Ή μ±„λ„μ˜ μš΄μ˜μ •μ±… μ„€μ • ν™”λ©΄μ—μ„œ 지정할 수 있으며,

기타 Callback은 Kollus μ„œλΉ„μŠ€ λ‹΄λ‹Ήμžμ—κ²Œ 섀정을 μš”μ²­ν•˜μ—¬μ•Ό ν•©λ‹ˆλ‹€.

채널 Callback μ„€μ • (채널 컨텐츠 μΆ”κ°€, μ‚­μ œ)

  • μ™Όμͺ½ λ©”λ‰΄μ—μ„œ 채널을 μ„ νƒν•©λ‹ˆλ‹€.

    image-20250108-003249.png

    Β 

    Β 

    Β 

μƒμ„ λœ μ±„λ„μ˜ 속성 μˆ˜μ •μ„ μ„ νƒν•©λ‹ˆλ‹€.

  • 채널 속성 νŽΈμ§‘ν™”λ©΄μ—μ„œ 채널 운영 정책을 μ„ νƒν•©λ‹ˆλ‹€.

    image-20250108-004245.png

    Β 

    Β 

  • μ½œλ°±μ„€μ •μœΌλ‘œ μ΄λ™ν•©λ‹ˆλ‹€.

    Β 

    Β 

  • ν•„μš”ν•œ 채널 μ½œλ°±μ„ λ“±λ‘ν•©λ‹ˆλ‹€.

    Β 

기타 Callback μ„€μ • (μ—…λ‘œλ“œ μ™„λ£Œ, νŠΈλžœμŠ€μ½”λ”© μ™„λ£Œ, 컨텐츠 μ—…λ°μ΄νŠΈ)

Kollus μ„œλΉ„μŠ€ λ‹΄λ‹Ήμžμ—κ²Œ 별도 μš”μ²­ν•΄ μ£Όμ‹­μ‹œμ˜€.

Callback 전솑 처리

전솑방법

  1. λͺ¨λ“  Callback은 고객사가 μ„€μ •ν•œ Web URL의 POST 방식을 μ‚¬μš©ν•˜μ—¬ μ „λ‹¬ν•©λ‹ˆλ‹€.

  2. λͺ¨λ“  Callback은 전솑 μ‹œμ μ΄ 되면 μ¦‰μ‹œ μ „λ‹¬ν•˜λŠ” 것을 μ›μΉ™μœΌλ‘œ ν•©λ‹ˆλ‹€. (λ‹€λ§Œ, Callback을 μ²˜λ¦¬ν•˜λŠ” μ„œλ²„μ˜ 상황이 λͺΉμ‹œ λΆ„μ£Όν•œ 경우 지연될 수 μžˆμŠ΅λ‹ˆλ‹€.)

  3. 고객사 μ›Ήμ„œλ²„λŠ” Callback을 μ„±κ³΅μ μœΌλ‘œ 전달 λ°›μ•˜μ„ 경우 200 HTTP Status Code둜 응닡해야 ν•©λ‹ˆλ‹€. μ΄λ•Œ HTTP body 뢀뢄은 ν™•μΈν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€. (200이 μ•„λ‹Œ μ½”λ“œλ‘œ 응닡할 경우 전솑 μ‹€νŒ¨λ‘œ κ°„μ£Όν•˜κ³  μ§€μ •λœ μ‹œκ°„ 후에 μž¬μ‹œλ„ ν•©λ‹ˆλ‹€.)

μœ μ˜μ‚¬ν•­

고객사 μ„œλ²„λŠ” Kollus의 Callback 전솑 μš”μ²­μ— λŒ€ν•΄ 2초 이내 연결이 μˆ˜λ¦½λ˜μ–΄μ•Ό ν•˜λ©°, 연결이 수립된 이후 3초 내에 응닡해야 ν•©λ‹ˆλ‹€. 이 μ‹œκ°„ 내에 연결이 μˆ˜λ¦½λ˜μ§€ μ•Šκ±°λ‚˜ μ‘λ‹΅ν•˜μ§€ μ•ŠλŠ”λ‹€λ©΄,

Kollus Callback μ „μ†‘μ„œλ²„λŠ” 전솑 μ‹€νŒ¨λ‘œ κ°„μ£Όν•˜κ³  μ§€μ •λœ μ‹œκ°„ 후에 μž¬μ‹œλ„ ν•©λ‹ˆλ‹€. (Connect TimeΒ­out 2초, Response TimeΒ­out 3초)

μ‹œλ‚˜λ¦¬μ˜€

Callback 전솑 μž¬μ‹œλ„ 처리

전솑방법

  1. 기본적인 전솑 방법은 β€œCallback 전솑 μ²˜λ¦¬β€ ν•­λͺ©κ³Ό λ™μΌν•©λ‹ˆλ‹€.

  2. μž¬μ‹œλ„λŠ” 5λΆ„ κ°„κ²©μœΌλ‘œ μ΅œλŒ€ 3λ²ˆκΉŒμ§€ μ‹œλ„ν•©λ‹ˆλ‹€.

μœ μ˜μ‚¬ν•­

고객사 μ„œλ²„λŠ” Kollus의 Callback을 정상 μ²˜λ¦¬ν–ˆλ‹€κ³  κ°„μ£Όν•˜μ—¬ 200 HTTP Status Code둜 μ‘λ‹΅ν–ˆλ‹€κ³  ν•˜μ—¬λ„, Connect/Response TimeΒ­out을 λ„˜κ²¨μ„œ 이미 Kollus Callback 전솑 μ„œλ²„κ°€ μš”μ²­μ„ μ‹€νŒ¨λ‘œ μ²˜λ¦¬ν•˜μ˜€λ‹€λ©΄, Callback μš”μ²­μ΄ μž¬μ‹œλ„λ  수 μžˆμŠ΅λ‹ˆλ‹€. 즉, TimeΒ­out으둜 μΈν•œ λ™μΌν•œ Callback이 μš”μ²­λ  수 μžˆμœΌλ‹ˆ Callback URL κ°œλ°œμ‹œ λŒ€λΉ„ν•΄μ•Ό ν•©λ‹ˆλ‹€.

μ‹œλ‚˜λ¦¬μ˜€

Callback 전솑 νŒŒλΌλ―Έν„°

μ—…λ‘œλ“œ μ™„λ£Œ Callback

POST

Data type

λΉ„κ³ 

POST

Data type

λΉ„κ³ 

content_provider_key

string

κ³ κ°μ‚¬μ˜ μ„œλΉ„μŠ€ 계정 ν‚€ μž…λ‹ˆλ‹€.

full_filename

string

폴더λ₯Ό ν¬ν•¨ν•œ μ—…λ‘œλ“œλœ 파일λͺ…μž…λ‹ˆλ‹€.

filename

string

μ—…λ‘œλ“œ 된 파일λͺ…μž…λ‹ˆλ‹€.

upload_file_key

string

μ—…λ‘œλ“œ 파일 ν‚€



νŠΈλžœμŠ€μ½”λ”© μ™„λ£Œ Callback

POST

Data type

λΉ„κ³ 

POST

Data type

λΉ„κ³ 

content_provider_key

string

κ³ κ°μ‚¬μ˜ μ„œλΉ„μŠ€ 계정 ν‚€ μž…λ‹ˆλ‹€.

filename

string

폴더λ₯Ό ν¬ν•¨ν•œ μ—…λ‘œλ“œλœ 파일λͺ…μž…λ‹ˆλ‹€.

upload_file_key

string

μ—…λ‘œλ“œ 파일 ν‚€

transcoding_result

string

νŠΈλžœμŠ€μ½”λ”© κ²°κ³Ό (success, fail)

채널 컨텐츠 μΆ”κ°€ μ™„λ£Œ Callback

POST

Data type

λΉ„κ³ 

POST

Data type

λΉ„κ³ 

content_provider_key

string

κ³ κ°μ‚¬μ˜ μ„œλΉ„μŠ€ 계정 ν‚€ μž…λ‹ˆλ‹€.

full_filename

string

폴더λ₯Ό ν¬ν•¨ν•œ μ—…λ‘œλ“œ 된 파일λͺ…μž…λ‹ˆλ‹€.

filename

string

μ—…λ‘œλ“œ 된 파일λͺ…μž…λ‹ˆλ‹€.

upload_file_key

string

μ—…λ‘œλ“œ 파일 ν‚€

media_content_key

string

λ―Έλ””μ–΄ 컨텐츠 ν‚€. λ™μ˜μƒ μž¬μƒμ„ μœ„ν•΄ 채널에 ν• λ‹Ήλœ 컨텐츠λ₯Ό μ‹λ³„ν•˜κΈ° μœ„ν•œ ν‚€.

channel_key

string

μ½˜ν…μΈ κ°€ ν• λ‹Ήλœ μ±„λ„μ˜ 식별 ν‚€

channel_name

string

μ½˜ν…μΈ κ°€ ν• λ‹Ήλœ μ±„λ„μ˜ 이름

profile_key

string

μ½˜ν…μΈ κ°€ νŠΈλžœμŠ€μ½”λ”©λœ ν”„λ‘œνŒŒμΌ λͺ…. ν•˜λ‚˜ 이상일 κ²½μš°λŠ” β€˜|’λ₯Ό κ΅¬λΆ„μžλ‘œ ν•˜μ—¬ ν‘œν˜„ν•©λ‹ˆλ‹€.

update_type

string

μ—…λ°μ΄νŠΈ μ’…λ₯˜

채널 컨텐츠 μ‚­μ œ μ™„λ£Œ Callback

POST

Data type

λΉ„κ³ 

POST

Data type

λΉ„κ³ 

content_provider_key

string

κ³ κ°μ‚¬μ˜ μ„œλΉ„μŠ€ 계정 ν‚€ μž…λ‹ˆλ‹€.

full_filename

string

폴더λ₯Ό ν¬ν•¨ν•œ μ—…λ‘œλ“œ 된 파일λͺ…μž…λ‹ˆλ‹€.

filename

string

μ—…λ‘œλ“œ 된 파일λͺ…μž…λ‹ˆλ‹€.

upload_file_key

string

μ—…λ‘œλ“œ 파일 ν‚€

media_content_key

string

λ―Έλ””μ–΄ 컨텐츠 ν‚€. λ™μ˜μƒ μž¬μƒμ„ μœ„ν•΄ 채널에 ν• λ‹Ήλœ 컨텐츠λ₯Ό μ‹λ³„ν•˜κΈ° μœ„ν•œ ν‚€.

channel_key

string

μ½˜ν…μΈ κ°€ ν• λ‹Ήλœ μ±„λ„μ˜ 식별 ν‚€

channel_name

string

μ½˜ν…μΈ κ°€ ν• λ‹Ήλœ μ±„λ„μ˜ 이름

update_type

string

μ—…λ°μ΄νŠΈ μ’…λ₯˜

컨텐츠 μ—…λ°μ΄νŠΈ Callback

POST

Data type

λΉ„κ³ 

POST

Data type

λΉ„κ³ 

content_provider_key

string

κ³ κ°μ‚¬μ˜ μ„œλΉ„μŠ€ 계정 ν‚€ μž…λ‹ˆλ‹€.

full_filename

string

폴더λ₯Ό ν¬ν•¨ν•œ μ—…λ‘œλ“œ 된 파일λͺ…μž…λ‹ˆλ‹€.

filename

string

μ—…λ‘œλ“œ 된 파일λͺ…μž…λ‹ˆλ‹€.

upload_file_key

string

μ—…λ‘œλ“œ 파일 ν‚€

update_type

string

μ—…λ°μ΄νŠΈ μ’…λ₯˜

Related pages

Copyright Β© CATENOID, lnc. All Rights Reserved.
E-mail. support@catenoid.net | Tel. 1544-4367