«api-design» 태그된 질문

API 디자인은 데이터에 대한 프로그래밍 방식 액세스를 허용하기 위해 다른 개발자가 사용하기위한 일련의 일관된 메서드 서명, 반환 값 및 문서를 결정하고 노출하는 프로세스입니다.


7
REST 중첩 자원에 대한 모범 사례는 무엇입니까?
내가 말할 수있는 한, 개별 자원마다 하나의 표준 경로 만 있어야 합니다. 다음 예제에서 좋은 URL 패턴은 무엇입니까? 나머지 회사를 예로 들어 보겠습니다. 이 가상의 예에서 각 회사 는 0 개 이상의 부서를 소유 하고 각 부서 는 0 개 이상의 직원을 소유 합니다. 관련 회사 가 없는 부서 는 …
301 rest  api-design 

11
API 페이지 매김 모범 사례
나는 내가 만들고있는 페이지 매김 된 API로 이상한 경우를 처리하는 데 도움이되는 것을 좋아합니다. 많은 API와 마찬가지로이 API는 큰 결과를 매 깁니다. / foos를 쿼리하면 100 개의 결과 (예 : foo # 1-100)와 foo # 101-200을 반환하는 / foos? page = 2에 대한 링크가 표시됩니다. 불행히도 API 소비자가 다음 쿼리를하기 …

5
Java Streams가 왜 일회용입니까?
IEnumerable실행 파이프 라인을 원하는만큼 여러 번 실행할 수있는 C #과 달리 Java에서는 스트림을 한 번만 '반복'할 수 있습니다. 터미널 작업을 호출하면 스트림이 닫히고 사용할 수 없게됩니다. 이 '기능'은 많은 힘을 빼앗아갑니다. 나는 그 이유가 기술적 인 것이 아니라고 생각합니다 . 이 이상한 제한 뒤에 디자인 고려 사항은 무엇입니까? 편집 : …

8
RESTful 방식으로 자원에 대한 서버 측 메소드 호출
REST에 대한 기본적인 이해가 있습니다. 이 URL이 있다고 가정 해 봅시다. http://api.animals.com/v1/dogs/1/ 그리고 지금, 서버가 개 껍질을 만들게하고 싶습니다. 서버 만이이를 수행하는 방법을 알고 있습니다. 개가 나머지 영원 동안 10 분마다 짖는 CRON 작업을한다고 가정 해 봅시다. 그 전화는 어떤 모습입니까? 나는 이것을하고 싶다 : URL 요청 : ACTION http://api.animals.com/v1/dogs/1/ …

7
RESTful API에서 경로 매개 변수와 쿼리 매개 변수를 언제 사용합니까?
RESTful API를 매우 예측 가능하게 만들고 싶습니다. 쿼리 매개 변수를 사용하지 않고 URI를 사용하여 데이터를 분할 할시기를 결정하는 가장 좋은 방법은 무엇입니까? 페이지 매김, 정렬 및 그룹화를 지원하는 시스템 매개 변수는 '?'다음에 오는 것이 좋습니다. 그러나 '상태'및 '지역'또는 컬렉션을 분류하는 다른 속성과 같은 필드는 어떻습니까? 이것들이 쿼리 매개 변수가되어야한다면, 경로 …

4
String.valueOf (null)이 NullPointerException을 발생시키는 이유는 무엇입니까?
설명서에 따르면이 메서드 String.valueOf(Object obj)는 다음을 반환합니다. 인수가이면 null문자열과 "null"; 그렇지 않으면의 값 obj.toString()이 반환됩니다. 그러나 이것을 시도 할 때 어떻게됩니까? System.out.println("String.valueOf(null) = " + String.valueOf(null)); 대신 NPE를 던지나요? (믿지 않으면 직접 시도하십시오!) 스레드 "main"의 예외 java.lang.NullPointerException java.lang.String. (알 수없는 소스) java.lang.String.valueOf (알 수없는 소스) 어떻게 이런 일이 일어나고 있습니까? …


28
GB 영어 또는 미국 영어?
API가 있고 국제적인 독자를 보유한 영국 기반 개발자 인 경우 API가 setColour() 또는 setColor() (간단한 예로서 한 단어를 취하십시오.) 영국에 기반을 둔 엔지니어들은 종종 '올바른'철자에 대해 상당히 방어 적이지만 미국 철자가 국제 시장에서 더 '표준'이라고 주장 할 수 있습니다. 문제는 중요합니까? 다른 로케일의 개발자가 GB 철자에 어려움을 겪습니까, 아니면 일반적으로 …

3
토큰 만료-JSON REST API-오류 코드
JSON REST API가 있습니다. 15 분 동안 유효한 토큰을주는 핸드 셰이크가 있습니다. 15 분 이내에하는 모든 통화는 정상적으로 작동합니다. 15 분 후 오류 개체 (코드, 메시지, 성공 = false 포함)를 반환하지만 어떤 HTTP 오류 코드를 반환해야하는지 궁금합니다. 그리고 HTTP 오류 코드를 사용하면 특정 클라이언트가 엉망이 될까요? (HTML5, iPhone, Android). 이 …
당사 사이트를 사용함과 동시에 당사의 쿠키 정책개인정보 보호정책을 읽고 이해하였음을 인정하는 것으로 간주합니다.
Licensed under cc by-sa 3.0 with attribution required.