728x90 반응형 API4 [구글 엔지니어는 이렇게 일한다] 하이럼의 법칙, Hyrum's Law 하이럼의 법칙, Hyrum's LawAPI의 명시적 계약 외에도, 외부 사용자들은API가 제공하는 모든 관찰 가능한 동작에 의존하게 될 것이다. 구글의 소프트웨어 엔지니어 하이럼 라이트(Hyrum Wright)가 제시한 개념으로, API나 인터페이스에서 의도적으로 문서화되지 않거나, 내부적으로만 사용할 것으로 설계된 동작이라 하더라도 사용자(특히, 외부 사용자)는 이를 활용하게 되고, 결국 해당 동작이 사실상의 계약(작동할 수 있는 모든 행위에 대한 정의)처럼 작용하게 됩니다.하이럼의 법칙이 중요한 이유API 안정성의 필요성사용자들이 의존하는 동작이 예상치 못한 방식으로 사용될 가능성을 인정해야 합니다.이를 통해, 안정적인 API 설계가 이루어질 수 있습니다.버전 관리와 하위 호환성의 중요성API의 관찰.. 2024. 11. 24. [OpenAI] GPT Response JSON Schema로 관리하기 서론OpenAI 응답을 받아 처리하는 과정에서 단순 string 기반을 개선하고자 한다.제공하는 Structureed Outputs 기능을 활용하여, 안전하게 관리하는 방법을 정리해본다.Structured Outputs이란?OpenAI 모델 버전gpt-4o-2024-08-06 이후 버전부터 사용 가능안정적인 타입 보장올바른 데이터 형식을 자동으로 유지해 검증이나 수정이 필요하지 않음명확한 거부 응답모델이 특정 요청을 거부하는 경우를 명시적으로 확인 가능간편한 프롬프트 구성일관된 데이터 구조를 위해 강한 문구를 사용할 필요 없음구현pydantic - BaseModelStructured Outputs의 구조를 설계일반적인 RestAPI에서 Request, Response 구조를 관리하는 것과 유사하게 구현.. 2024. 11. 7. [OpenAI] 1.0.0 Migration 관련 Function 변경 v1.0.0 Migration Guide · openai openai-python · Discussion #742We have released a new major version of our SDK, and we recommend upgrading promptly. It's a total rewrite of the library, so many things have changed, but we've made upgrading easy with a code mig...github.com초기화, Initializationopenai.OpenAIapi_keys : OpenAI API Key 세팅 및 dafault OS 환경변수 지정# oldimport openaiopenai.api_key = os.enviro.. 2024. 11. 5. [설계] 웹앱 서비스 계좌/입금이체 기능 추가의 건 서론운영하고 있는 웹앱 서비스에서 특정 인원에 대한 간편 계좌 이체 기능을 추가하려고 한다.고도화 단계를 나누어 단순 클립보드 형태의 이체 지원(Level 1), 입금이체 API 연동(Level 2)으로 구상하였다.요구사항 분석웹앱 페이지 상에서의 계좌이체 기능 (결제 X)레퍼런스 : 축의금 계좌이체 기능고객 1 : 계좌정보 1웹앱으로 표출되는 정보에는 고객 정보와 계좌 정보(은행코드, 계좌번호, 예금주)가 포함된다.기존 시스템에는 금융결제원 연동에 필요한 계좌 OAuth 정보가 존재하지 않는다.간편한 UX간편함에 대한 필자의 기준은 기능 A to Z의 Depth가 가장 적은 부분을 의미한다.금융결제원 OpenAPI 활용 시, 계좌 등록에 대한 정보 동의 여부를 OAuth 2.0을 기준으로 관리하기 때문.. 2024. 5. 22. 이전 1 다음 728x90 반응형
