SDK

상자를 열면 이미 잘려 있어요

서비스에 요청 한 번을 보내려면 손이 꽤 가요. 주소를 정확히 적고, 열쇠를 규격대로 붙이고, 보낼 내용을 정해진 모양으로 싸고, 돌아온 답 덩어리에서 필요한 부분만 꺼내야 해요. 여기에 답이 길어질 때 이어 받는 처리, 실패했을 때 다시 보내는 처리까지 붙으면 일이 더 늘어요.

꾸러미는 이 과정을 부품 하나로 미리 묶어 둬요. 설치를 한 번 하고 부품 이름을 부르면, 안에서 요청을 꾸려 보내고 답을 다듬어 돌려줘요. 처음 연결하는 데 걸리던 시간이 반나절에서 몇 분으로 줄어드는 셈이에요.

잔일을 대신해 준다는 점이 특히 커요. 잠깐 끊겼을 때 다시 시도하기, 순서대로 도착하지 않은 조각 맞추기 같은 일은 직접 짜면 실수가 나기 쉬운데, 꾸러미에는 이미 검증된 방식으로 들어 있어요.

상자마다 설명서가 들어 있어요

꾸러미에는 부품만 있는 게 아니에요. 어떤 부품을 어떤 순서로 끼우는지 적어 둔 문서와, 그대로 따라 하면 돌아가는 예제가 함께 들어 있어요. 처음 붙이는 사람은 예제 하나를 복사해 자기 내용만 바꿔 넣는 식으로 시작해요.

부품이 다 필요하지도 않아요. 대화 기능만 쓰는 사람에게 이미지나 음성 부품은 상자 안에 그대로 남아요. 남는 부품이 있다고 문제가 되지는 않지만, 프로그램이 무거워지는 게 부담이면 필요한 부분만 골라 넣을 수 있는 꾸러미를 고르기도 해요.

나무 종류마다 상자가 달라요

같은 책장이라도 원목용과 합판용 부품이 다르듯, 꾸러미도 프로그램을 만드는 언어마다 따로 나와요. 겉으로 하는 일은 같지만 부품 이름과 끼우는 방식은 언어의 습관을 따라가요.

그래서 같은 서비스를 쓰더라도 팀이 쓰는 언어에 맞는 상자를 골라야 해요. 상자가 없는 언어라면 규격에 맞춰 직접 요청을 만들거나, 다른 사람이 만들어 둔 비공식 꾸러미를 쓰게 돼요. 비공식 꾸러미는 서비스가 바뀔 때 함께 손보아 주는 사람이 없을 수 있어서, 고르기 전에 최근에도 손질되고 있는지 살펴보는 게 좋아요.

상자에 없는 모양은 직접 잘라야 해요

새 기능이 나오면 규격에는 먼저 열리고 꾸러미에는 조금 늦게 들어오는 일이 흔해요. 이럴 때는 꾸러미를 쓰면서도 그 기능만큼은 규격에 맞춰 직접 요청을 보내요. 꾸러미가 규격을 감싼 껍데기라는 걸 알고 있으면 이런 우회가 어렵지 않아요.

판을 올리는 일도 잊으면 안 돼요. 오래된 꾸러미를 그대로 두면 새 기능을 못 쓸 뿐 아니라, 서비스 쪽에서 옛 방식을 닫아 버렸을 때 어느 날 갑자기 연결이 끊기기도 해요. 판을 올릴 때 부품 이름이 바뀌는 경우도 있어서, 바뀐 내용을 적어 둔 안내문을 먼저 읽고 옮기는 편이 안전해요.