관계

URI(Uniform Resource Identifiers)

정의

인터넷 자원을 나타내는 고유 식별자 이다. URI는 유일해야한다.

구조

• Protocol
  http는 프로토콜이다. 브라우저가 어떤 프로토콜을 사용해야 하는지를 나타낸다.

• Domain Name
  www.example.com은 도메인 이름이다. 직접 IP address를 사용하는 것도 가능하다.

• Port
  웹서버가 자원의 접근 하기 위해 표준 HTTP 포트(HTTP : 80, HTTPS : 443)를 사용한다면, 보통 생략한다. 이 외에는 포트 번호는 필수이다.

• Path to the file
  자원에 대한 경로이다. 초기에는 물리적인 파일 위치를 나타냈으나, 요새는 실제 물리적 경로가 아닌 웹 서버에서 추상화하여 보여준다.

• Prameters
  웹서버에 제공하는 추가 파라미터이다. &기호로 구분된 키/값으로 짝을 이룬 리스트이다.

URL(Uniform Resource Locator)

정의

네트워크 상에서 자원의 위치를 알려주기 위한 프로토콜이다.

일관성

인간은 URL을 쉽게 읽고 구성할 수 있어야한다.

잘 구성된 URL의 예는 다음과 같다.
https://api.contoso.com/v1.0/people/jdoe@contoso.com/inbox

친절하지 않은 URL의 예는 다음과 같다.

https://api.contoso.com/EWS/OData/Users('jdoe@microsoft.com')/Folders('AAMkADdiYzI1MjUzLTk4MjQtNDQ1Yy05YjJkLWNlMzMzYmIzNTY0MwAuAAAAAACzMsPHYH6HQoSwfdpDx-2bAQCXhUk6PC1dS7AERFluCgBfAAABo58UAAA=')

참고

https://developer.mozilla.org/ko/docs/Learn/Common_questions/What_is_a_URL
Microsoft REST API 지침 : https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#1-abstract