2.1 JSON-LD

Activity Streams 2.0 문서의 직렬화된 JSON 형태는 표준 JSON-LD 1.0 처리 알고리즘 및 API [JSON-LD-API]의 컴팩션 알고리즘을 이용해 생산되는 것과 일치해야 합니다(MUST). 이때 적어도 여기에서 제공하는 규범적 JSON-LD @context 정의를 사용해야 합니다. 구현체는 제공된 @context에 추가적인 @context 정의를 추가할 수 있지만(MAY), 규범적 context를 덮어쓰거나 변경해서는 안 됩니다(MUST NOT). 또한 구현체는 JSON-LD @context에 정의되지 않은 추가 속성과 값을 사용할 수 있지만(MAY), 이러한 속성은 표준 JSON-LD 알고리즘을 사용하는 구현에서는 지원되지 않을 수 있고 무시될 수 있음을 이해해야 합니다. 확장 처리 방식에 대한 추가 정보는 확장성 절을 참고하세요.

JSON-LD는 @context라는 특수 속성을 사용하여 처리 컨텍스트를 정의합니다. @context 속성의 값은 [JSON-LD] 명세에 의해 정의됩니다. Activity Streams 2.0 문서를 생성하는 구현체는 SHOULD @context 속성을 포함시켜야 하며, 그 값에 " https://www.w3.org/ns/activitystreams"를 포함해야 합니다. 대안으로 " http://www.w3.org/ns/activitystreams" URL도 사용할 수 있습니다(MAY). 이 작업은 문자열, 객체, 배열을 사용해 구현할 수 있습니다.

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "summary": "A note",
  "type": "Note",
  "content": "My dog has fleas."
}

{
  "@context": {
     "@vocab": "https://www.w3.org/ns/activitystreams",
     "ext": "https://canine-extension.example/terms/",
     "@language": "en"
  },
  "summary": "A note",
  "type": "Note",
  "content": "My dog has fleas.",
  "ext:nose": 0,
  "ext:smell": "terrible"
}

{
  "@context": [
     "https://www.w3.org/ns/activitystreams",
     {
      "css": "http://www.w3.org/ns/oa#styledBy"
     }
  ],
  "summary": "A note",
  "type": "Note",
  "content": "My dog has fleas.",
  "css": "http://www.csszengarden.com/217/217.css?v=8may2013"
}

JSON-LD가 활성화된 Activity Streams 2.0 구현체가 "application/activity+json" MIME 미디어 타입으로 식별되는 JSON 문서를 만났는데, 해당 문서에 규범적 Activity Streams 2.0 JSON-LD @context 정의에 대한 참조가 포함된 @context 속성이 없다면, 구현체는 여전히 규범적 @context 정의가 적용된다고 간주해야 합니다(MUST).

2.2 IRI 및 URL

이 명세서는 IRI [RFC3987]를 사용합니다. 모든 URI [RFC3986] 역시 IRI이므로, IRI가 명시된 곳엔 URI도 사용할 수 있습니다. 특이사항은 두 가지가 있습니다: (1) URI가 아닌 IRI를 역참조를 위해 제공할 때에는 [RFC3987] 3.1장의 단계에 따라 반드시 URI로 변환해야 하며(MUST), (2) IRI가 "id" 값으로 사용될 때에는 변환하면 안 됩니다(MUST NOT).

상대 IRI(및 URL) 참조는 많은 JSON 파서 구현체들이 상대 참조를 올바르게 해석하는 데 필요한 base 컨텍스트를 안정적으로 보존하지 못하므로, Activity Streams 2.0 문서 내에서는 사용되지 않아야 합니다(SHOULD NOT).

2.3 날짜 및 시간

날짜 및 시간 값을 가진 모든 속성은 반드시 [RFC3339]의 "date-time" production을 따라야 하며(MUST), 한 가지 예외로 초(seconds)는 생략할 수 있습니다(MAY). 날짜와 시간 구분에는 반드시 대문자 "T"를, 숫자형 타임존 오프셋이 없으면 반드시 대문자 "Z"를 사용해야 합니다(MUST).

이것은 다음 [ABNF] 구문 설명으로 명시되어 있습니다. "time-hour", "time-minute", "time-second", "time-secfrac", "time-offset", "full-date" 구문들은 [ RFC3339]에 정의되어 있습니다.

as2-partial-time = time-hour ":" time-minute [":" time-second]
                   [time-secfrac]
as2-full-time    = as2-partial-time time-offset
as2-date-time    = full-date "T" as2-full-time

`time-offset` 구성요소는 타임존과 일치하지 않으며, `time-offset`이 포함된 시간 값은 타임스탬프로는 잘 작동하지만 추가적인 정보와 처리가 없이는 지역 "벽시계 시간(wall times)"으로 신뢰할 수 있게 변환할 수 없음을 주의해야 합니다.

4.1 Object

Object는 Activity Streams 어휘의 기본 타입입니다.

글로벌 식별자( id 속성, 절대 IRI로 표현)와 "object type"( type 속성으로 표현)을 갖는 것 외에도, 모든 Object 타입 인스턴스는 Activity Vocabulary에서 표준적으로 정의한 공통 속성 집합을 공유합니다. 여기에는 다음이 포함됩니다: attachment | attributedTo | audience | content | context | contentMap | name | nameMap | endTime | generator | icon | image | inReplyTo | location | preview | published | replies | startTime | summary | summaryMap | tag | updated | url | to | bto | cc | bcc | mediaType | duration

모든 속성은 선택 사항입니다(id와 type 포함).

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "id": "http://example.org/foo",
  "type": "Note",
  "name": "My favourite stew recipe",
  "attributedTo": {
    "id": "http://joe.website.example/",
    "type": "Person",
    "name": "Joe Smith"
  },
  "published": "2014-08-21T12:34:56Z"
}

Activity Vocabulary는 여러 사회적 웹 애플리케이션에서 일반적으로 사용되는 다양한 Object 타입도 정의합니다. 이 명세는 이러한 객체들 대부분에 대해 의미적으로 구체적인 속성을 정의하지 않습니다. Activity Vocabulary에 포함되지 않은 추가적인 세부 정보는 외부 어휘를 사용하여 표현할 수 있습니다.

또한 구현체들은 Activity Vocabulary에서 정의된 것 외에 새로운 Object 타입을 자유롭게 도입할 수 있지만, 다른 구현체에서 인식하지 못하는 확장 타입에 지나치게 의존하면 상호운용성 문제가 발생할 수 있습니다. 기존 Object 타입과 과도하게 겹치거나 중복되지 않도록 주의해야 합니다.

만약 구현체가 핵심 어휘 타입과 중복되는 확장 타입을 사용할 경우, 반드시(MUST) 핵심 어휘 타입도 명시해야 합니다. 예를 들어, Good Relations Vocabulary와 같이 특정 위치를 설명하는 자체 타입을 정의하는 어휘들이 있습니다. 구현체가 만약 http://purl.org/goodrelations/v1#Location을 객체 타입으로 사용하고자 한다면, 아래와 같이 Place임을 반드시 함께 지정해야 합니다:

{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    {
      "gr": "http://purl.org/goodrelations/v1#"
    }
  ],
  "type": ["Place", "gr:Location"],
  "name": "Sally's Restaurant",
  "longitude": 12.34,
  "latitude": 56.78,
  "gr:category": "restaurants/french_restaurants"
}

외부 어휘에서 정의된 특정 속성이 Activity Vocabulary의 속성과 겹치거나 중복될 수 있습니다. 이런 중복이 있을 때는 일관된 상호운용성을 위해 반드시(MUST) Activity Vocabulary에서 정의한 속성을 우선 사용해야 합니다.

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "type": "Note",
  "id": "http://example.org/note/123",
  "name": "Our Weather Is Fine",
  "content": "I feel that the weather is appropriate to our season and location."
}

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "type": "Note",
  "id": "http://example.org/note/124",
  "summary": "A note by Sally",
  "content": "Everything is OK here."
}

4.2 Link

Link는 [RFC5988]에서 설정한 링크의 개념적 모델과 밀접하게 연관된, 또 다른 리소스에 대한 자격이 부여된 간접 참조를 설명합니다. Link 객체의 속성은 참조된 리소스의 속성이 아니며, 렌더링 에이전트가 해당 리소스를 어떻게 사용할지 이해할 수 있게 힌트를 제공합니다. 예를 들어, height와 width는 참조된 이미지의 실제 픽셀 크기가 아니라, 렌더링 시 원하는 크기를 나타낼 수 있습니다.

Link의 타겟 URI는 필수 href 속성으로 표현됩니다. 모든 Link 인스턴스는 Activity Vocabulary에서 표준적으로 정의된 다음과 같은 공통 선택 속성을 공유합니다: id | name | hreflang | mediaType | rel | height | width

예를 들어, 모든 Objects는 해당 객체의 그래픽 표현을 나타내는 값을 가진 image 속성을 가질 수 있습니다. 이 속성은 일반적으로 사용자가 볼 수 있는 이미지(JPEG, GIF, PNG 등) 리소스의 URL을 제공하는 데 사용됩니다. 하나의 객체에 여러 시각적 표현(예: 여러 스크린샷 또는 다양한 해상도의 동일 이미지)이 있을 수 있습니다. Activity Streams 2.0에서 이러한 참조를 기술하는 방법은 본질적으로 세 가지가 있습니다.

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "type": "Application",
  "id": "http://example.org/application/123",
  "name": "Exampletron 3000",
  "image": "http://example.org/application/123.png"
}

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "type": "Application",
  "id": "http://example.org/application/123",
  "name": "Exampletron 3000",
  "image": {
    "type": "Link",
    "href": "http://example.org/application/123.png",
    "mediaType": "image/png"
  }
}

형식적으로, 첫 번째 예시는 이미지 리소스와의 자격 없는 직접 관계를 설정하고, 두 번째는 관계에 대한 추가 속성을 명시할 수 있는 자격이 부여된 간접 관계를 설정합니다.

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "type": "Application",
  "id": "http://example.org/application/123",
  "name": "Exampletron 3000",
  "image": [
    "http://example.org/application/abc.gif",
    {
      "type": "Link",
      "href": "http://example.org/application/123.png",
      "mediaType": "image/png"
    }
  ]
}

이러한 배열에 포함된 각각의 항목은 서로 독립적이며, 순서에는 아무런 의미가 부여되지 않습니다.

RFC 5988에 따르면 모든 Link는 링크의 맥락 목적을 설명하는 "link relation"을 가집니다. Link 내에서는 rel 속성으로 link relation 값을 설정합니다. rel 속성이 없는 경우, 링크 관계는 미지정 상태로 간주합니다. 하나의 Link에 여러 link relation 값을 가질 수 있으며, JSON 직렬화에서는 하나의 문자열 또는 여러 값을 배열로 표현할 수 있습니다.

링크 관계의 적용 범위는 해당 Link가 즉시 포함된 객체입니다.

아래 예시에서는 두 개의 참조가 있습니다. 첫 번째의 link relation은 미지정 상태이며, 두 번째는 "thumbnail"입니다.

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "type": "Application",
  "id": "http://example.org/application/123",
  "name": "Exampletron 3000",
  "image": [
    "http://example.org/application/abc.gif",
    {
      "type": "Link",
      "href": "http://example.org/application/123.png",
      "mediaType": "image/png",
      "rel": "thumbnail"
    }
  ]
}

[HTML5] 명세는 "link relation"을 다소 다르게 정의합니다. HTML5 정의에서는 "space" U+0020, "tab" (U+0009), "LF" (U+000A), "FF" (U+000C), "CR" (U+000D), "," (U+002C) 문자가 포함되지 않은 문자열은 유효한 link relation이 될 수 있습니다. 상호운용성을 위해, Activity Streams 2.0 구현체는 [RFC5988] 및 [HTML5] 모두에 구문적으로 유효한 link relation 만을 사용해야 합니다(MUST). 등록되지 않은 link relation 값도 사용할 수 있습니다(MAY).

Link와 Object 타입은 서로 겹치지 않음을 유의하세요. 즉, 하나의 Object가 동시에 Link일 수 없습니다.

4.3 Actor

Actor 객체는 행동(Activity)을 수행할 수 있는 주체(엔터티)를 나타내는 기본 Object 타입의 특수화된 형태입니다. Activity Vocabulary에서는 5가지 Actor 타입을 표준적으로 정의합니다: Application | Group | Organization | Person | Service.

본 명세는 Actor를 가장 일반적인 차원에서만 규정하며, 각각의 Actor에 대한 의미적으로 구체적인 속성들은 정의하지 않습니다. 모든 Actor 객체는 Object를 특수화한 것이며, Object의 모든 핵심 속성을 상속받습니다. Activity Vocabulary에 포함되지 않은 세부 정보 표현에는 외부 어휘를 사용할 수 있습니다. 예를 들어 VCard [ vcard-rdf]는 Person, Group, Organization 인스턴스의 부가 메타데이터를 제공하는 데 사용해야 합니다(SHOULD).

{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    {"vcard": "http://www.w3.org/2006/vcard/ns#"}
  ],
  "summary": "Sally created a note",
  "type": "Create",
  "actor": {
    "type": ["Person", "vcard:Individual"],
    "id": "http://sally.example.org",
    "name": "Sally Smith",
    "vcard:given-name": "Sally",
    "vcard:family-name": "Smith"
  },
  "object": {
    "type": "Note",
    "content": "This is a simple note"
  }
}

구현체는 Activity Vocabulary에서 정의된 Actor 타입 이외에 새 타입을 도입할 수 있으나, 다른 구현이 인식하지 못하는 확장 타입에 대한 과도한 의존은 상호운용성 문제를 야기할 수 있습니다. 기존 Actor 타입과 불필요하게 중복되거나 겹치지 않도록 주의해야 합니다.

만약 구현체가 핵심 어휘 타입과 중복되는 확장 타입을 사용할 경우, 반드시(MUST) 핵심 어휘 타입도 명시해야 합니다. 예를 들어 일부 어휘(VCard 등)에서는 사람을 설명하는 자체 타입을 정의합니다. 구현체가 vcard:Individual을 Actor로 사용하고자 할 경우, 위 예시처럼 Person임도 함께 명시해야 합니다.

4.4 Activity

Activity 객체는 이미 발생했거나 현재 진행 중이거나 앞으로 발생할 수 있는 행동에 대한 정보를 제공하는 기본 Object 타입의 특수화 모델입니다.

Object의 공통 속성 외에,Activity 객체는 다음과 같은 추가 속성을 지원합니다(Vocabulary 참고): actor | object | target | origin | result | instrument

type 속성은 Activity Statement가 나타내는 동작의 유형을 식별하는 데 사용됩니다.

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "summary": "Joe liked a note",
  "type": "Like",
  "id": "http://www.test.example/activity/1",
  "actor": "http://example.org/profiles/joe",
  "object": "http://example.com/notes/1",
  "published": "2014-09-30T12:34:56Z"
}

Activity Vocabulary는 여러 소셜 웹 애플리케이션에서 공통적으로 사용하는 소수의 Activity 타입을 정의합니다. 본 명세는 그중 다수의 Activity에 대해 의미적으로 구체적인 속성을 정의하지 않습니다. Activity Vocabulary에 포함되지 않은 추가 세부정보를 표현할 때 외부 어휘를 사용할 수 있습니다.

구현체는 Activity Vocabulary에 정의된 타입 이외에 새로운 Activity 타입을 자유롭게 도입할 수 있지만, 다른 구현에서 인식하지 못하는 확장 타입에 과도하게 의존하면 상호운용성 문제가 발생할 수 있습니다. 기존 Activity 타입과 불필요하게 중복되거나 겹치지 않도록 주의해야 합니다.

구현체가 핵심 어휘 타입과 중복되는 확장 타입을 사용할 경우 반드시(MUST) 핵심 어휘 타입도 지정해야 합니다. 예를 들어 일부 어휘(Schema.org 등)는 동작을 설명하는 고유 타입을 정의합니다. 구현체가 http://schema.org/LikeAction을 Activity로 사용하려면, 아래 예시처럼 Like임도 함께 지정해야 합니다.

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "summary": "Joe liked a note",
  "type": ["Like", "http://schema.org/LikeAction"],
  "id": "http://www.test.example/activity/1",
  "actor": "http://example.org/profiles/joe",
  "object": "http://example.com/notes/1",
  "published": "2014-09-30T12:34:56Z"
}

구현체는 Activity 객체를 수동적인 용도(활동이 발생했거나 발생 중임을 기록) 또는 명령형 용도(애플리케이션이 명시된 동작을 일관되게 수행하도록 상태를 수정)로 자유롭게 사용할 수 있습니다. 하지만 이 명세는 포맷 사용 방식에 제약을 두는 표준 처리 모델을 정의하지 않으므로, Activity 문장이 수동 알림인지, 명령형 명령으로 해석되는지는 구현체마다 다를 수 있습니다.

4.5 IntransitiveActivity

IntransitiveActivity 객체는 목적어 없는 행동(비타동적 행동)을 나타내는 Activity 타입의 특수화입니다. IntransitiveActivity 객체에는 object 속성이 존재하지 않습니다.

4.6 Collection

Collection 객체는 다른 Object 또는 Link를 담는 컨테이너 역할을 하는 기본 Object의 특수화입니다.

모든 Object에서 상속받는 속성 외에도, Collection 타입은 다음 추가 속성을 가집니다: items | totalItems | first | last | current

Collection 내부의 항목들은 정렬되어 있을 수도 있고 아닐 수도 있습니다. OrderedCollection 타입을 사용하면 항상 정렬된 Collection임을 명시할 수 있습니다(MAY). JSON 직렬화에서 정렬되지 않은 항목은 items 속성을, 정렬된 항목은 orderedItems 속성을 통해 나타냅니다.

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "summary": "Object history",
  "type": "Collection",
  "totalItems": 2,
  "items": [
    {
      "type": "Create",
      "actor": "http://www.test.example/sally",
      "object": "http://example.org/foo"
    },
    {
      "type": "Like",
      "actor": "http://www.test.example/joe",
      "object": "http://example.org/foo"
    }
  ]
}

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "summary": "Object history",
  "type": "OrderedCollection",
  "totalItems": 2,
  "orderedItems": [
    {
      "type": "Create",
      "actor": "http://www.test.example/sally",
      "object": "http://example.org/foo"
    },
    {
      "type": "Like",
      "actor": "http://www.test.example/joe",
      "object": "http://example.org/foo"
    }
  ]
}

4.6.1 컬렉션 페이징

하나의 Collection에 많은 항목이 포함될 수 있습니다. Collection의 모든 항목을 items (또는 orderedItems) 속성으로만 직렬화하는 것은 비현실적일 수 있습니다. 이 경우 Collection 내 항목들을 여러 부분 집합 또는 "페이지(page)"로 나눌 수 있습니다. 페이지는 CollectionPage 타입으로 식별합니다.

CollectionPage 타입은 기본 Collection 타입을 확장하며 모든 속성을 상속받습니다. 다음 추가 속성도 지정될 수 있습니다: partOf | next | prev |

partOf 속성은 Collection 중 해당 CollectionPage의 항목들이 속하는 컬렉션을 식별합니다.

first, next, prev, last, current 속성은 부모 컬렉션에서 추가 항목 부분 집합을 담은 CollectionPage 를 참조하는 데 사용됩니다.

Collection 객체와 마찬가지로, CollectionPage의 항목들도 정렬되어 있을 수도, 아닐 수도 있습니다. OrderedCollectionPage 타입으로 페이지 내 항목이 항상 엄격하게 정렬됨을 명시할 수 있습니다(MAY).

OrderedCollectionPage 타입은 CollectionPage 와 OrderedCollection 모두를 확장합니다. 해당 페이지에 포함된 첫 항목이 전체 OrderedCollection에서 차지하는 상대 인덱스 위치는 startIndex 속성 값으로 표시할 수 있습니다.

정렬 여부와 무관하게, Collection의 페이지는 일반적으로 단일 또는 이중 연결 리스트 형태로 순서대로 배치됩니다. first 속성은 이 순서에서 첫 페이지를, last 속성은 마지막 페이지를 식별합니다. prev와 next 속성은 각각 바로 앞/뒤 페이지를 참조합니다.

current 속성은 Collection에서 최근 생성 또는 업데이트된 항목 부분집합을 담은 페이지를 식별합니다.

first, last, next, prev, current의 값은 단일 CollectionPage 이거나, Link를 통해 별도 리소스의 CollectionPage 를 참조할 수도 있습니다.

Example 20

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "summary": "Sally's recent activities",
  "type": "Collection",
  "id": "http://example.org/foo",
  "totalItems": 10,
  "first": {
    "type": "CollectionPage",
    "id": "http://example.org/foo?page=1",
    "partOf": "http://example.org/foo",
    "next": "http://example.org/foo?page=2",
    "items": [
      {
        "type": "Create",
        "actor": "http://www.test.example/sally",
        "object": "http://example.org/foo"
      }
    ]
  }
}

OrderedCollection에 페이징을 사용할 경우, 구현체가 각 페이지의 순서를 예측 가능한 방식으로 처리하리란 보장이 없기 때문에 까다로울 수 있습니다. 논리적 컬렉션의 전체 항목 순서를 복원하고자 하는 구현체는, 시퀀스에서 첫(또는 마지막) 페이지로 이동한 뒤 next (또는 prev) 링크를 재귀적으로 따라가며 모든 페이지를 처리해야 합니다. OrderedCollection의 페이지들은 OrderedCollectionPage 인스턴스가 되어야 하며(SHOULD), 그렇지 않으면 소비자는 올바른 순서를 신뢰성 있게 복원할 수 없습니다.

4.7 자연어 값

어휘(Vocabulary)에서 정의된 여러 속성들은 자연어 값을 사용하도록 정의되어 있습니다. 이러한 값은 한 가지 또는 그 이상의 언어로 제공되는 사람이 읽을 수 있는 문자열입니다. JSON 직렬화에서는 (1) 단일 JSON 문자열 또는 (2) 잘 형성된 [BCP47] 언어 태그를 로컬라이즈된 번역 값에 매핑하는 JSON 객체로 표현할 수 있습니다. 직렬화된 JSON에서, 이 두 가지 형태는 간단한 속성 명명 규칙으로 구분됩니다. 예를 들어 "name"은 name 속성의 JSON 문자열 형태를, "nameMap"은 객체 형태를 나타냅니다.

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "type": "Object",
  "name": "This is the title"
}

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "type": "Object",
  "nameMap": {
    "en": "This is the title",
    "fr": "C'est le titre",
    "es": "Este es el título"
  }
}

객체 형태의 각 키는 반드시(MUST) 잘 형성된 [BCP47] 언어 태그이어야 하며, 연관된 값은 반드시(MUST) 문자열이어야 합니다.

Activity Vocabulary는 자연어 값을 사용하는 세 가지 속성을 정의합니다: name, summary, content입니다. 이에 따라 JSON 직렬화에서 "name", "summary", "content"는 문자열 형태이고, "nameMap", "summaryMap", "contentMap"는 객체 형태를 나타냅니다.

언어를 알 수 없거나 결정할 수 없는 값을 명확하게 나타내기 위해 객체 형태에서 특수 언어 태그 "und"를 사용할 수 있습니다.

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "type": "Object",
  "nameMap": {
    "und": "This is the title"
  }
}

{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    {
      "@language": "en"
    }],
  "type": "Object",
  "name": "This is the title"
}

4.8 언어 표기

알고 있는 경우, Activity Streams 2.0 발행자는 명시적으로 자연어 속성의 언어를 나타내야 하며, map 속성이나 기본 언어 태그를 사용할 수 있습니다.

5.1 Compact URI 지원

JSON-LD 구문은 "Compact URI"의 사용을 지원합니다. Compact URI는 정의된 prefix를 이용하여 URI를 간략하게 직렬화하는 대체 형식입니다. 예를 들어, URI http://example.org/term은 ex: prefix를 http://example.org/에 할당하면 ex:term으로 표현할 수 있습니다.

JSON-LD에서 Compact URI 접두사는 JSON-LD @context 정의 내에서 정의합니다. 예시:

{
"@context": {
"ex": "http://example.org/",
"term": {
  "@type": "id",
  "@id": "ex:term"
}
},
"term": "ex:Foo"
}

이 예시에서 속성 이름 term과 값 ex:Foo 모두 Compact URI입니다. 속성 이름 term은 http://example.org/term으로 확장되고, 값 ex:Foo는 http://example.org/Foo로 확장됩니다.

JSON-LD에서 Compact URI 형태의 값 확장은 @context 정의에서 해당 속성이 명시적으로 "type": "id"로 정의된 경우에 적용됩니다. 즉, Compact URI는 IRI(또는 URI) 값이 예상되는 곳이면 어디든 사용할 수 있습니다.

Activity Streams 2.0 구현체가 확장 지원을 완전히 하려면, JSON-LD 명세에서 정의한 Compact URI 확장을 반드시(MUST) 지원해야 합니다. 이 확장은 모든 속성 이름과, JSON-LD @context에서 타입이 @id로 명시된 모든 속성 값에 적용됩니다.

Compact URI 형식에 과도하게 의존하면 구현체 간 모호성 및 상호운용성 문제가 발생할 수 있습니다. 그러므로 Compact URI는 속성명과 type 속성의 값 외에는 가능하면 사용을피해야 합니다(SHOULD).

5.2 확장의 재직렬화(Re-serialization)

확장 속성을 포함하는 Activity Streams 2.0 문서를 JSON-LD 메커니즘으로 파싱 후 재직렬화할 때, 구현체는 원본 문서 내 확장 속성이 올바르게 보존되고 직렬화되는지 신중하게 확인해야 합니다(SHOULD).

예를 들어, 다음은 가상의 foo와 bar 확장 속성이 들어있는 Activity Stream 객체입니다. foo 확장은 JSON-LD @context 내에 정의되어 있고, bar 확장 속성은 아닙니다.

{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    {"foo": "http://example.org/foo"}
  ],
  "type": "Note",
  "content": "This is a simple note",
  "foo": 123,
  "bar": 321
}

이 Note 객체를 받은 구현체는 단순히 일반 JSON 객체로 파싱할 수도, 표준 JSON-LD Expand 알고리즘을 사용할 수도 있습니다.

객체를 일반 JSON으로 파싱 후 재직렬화(예: 저장 또는 재배포)하는 경우, @context와 foo, bar 속성 값을 그대로 보존하여 재직렬화된 출력에 포함시키면 됩니다.

하지만 JSON-LD Expand 알고리즘을 쓴다면 @context는 펼쳐진 결과에서 제거되며, bar 속성은 "blank node" _:bar로 매핑됩니다. 이후 이 문서를 규범적 Activity Streams 2.0 context로 재직렬화하면, JSON-LD compacted 형태는 아래와 같습니다:

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "type": "Note",
  "content": "This is a simple note",
  "http://example.org/foo": 123,
  "bar": 321
}

이 결과는 원본과 유사하지만, foo 속성이 완전히 확장된 URI 라벨로 바뀌는 것은 바람직하지 않을 수 있습니다. 수신 문서의 JSON-LD 확장을 처리하는 구현체가 재직렬화 시 객체가 잘 직렬화되도록 하려면, JSON-LD 확장 과정에서 사용된 원본 @context를 보존하여 JSON-LD compacted 형태로 재직렬화할 때 재사용해야 합니다(SHOULD).

8.1 application/activity+json 미디어 타입

본 명세는 Activity Streams 2.0 형식을 준수하는 문서를 식별하기 위해 application/activity+json MIME 미디어 타입을 등록합니다.

profile-param = "profile=" profile-value
profile-value = <"> profile-URI 0*( 1*SP profile-URI ) <">
profile-URI   = URI

Activity Streams 2.0 형식은 JSON-LD 관례를 사용하지만, Activity Streams 2.0 구현에 추가 요구 사항과 제약이 있기 때문에 별도 미디어 타입을 사용합니다.

Activity Streams 2.0은 제한된 JSON-LD 프로파일로 볼 수 있으므로, 구현체는 `application/ld+json; profile="https://www.w3.org/ns/activitystreams"` 미디어 타입을 `application/activity+json`과 동등하게 취급하는 것이 권장됩니다.

9.1 문서

적합한(conforming) 문서는 문서를 위한 모든 적합성 기준을 준수하는 문서입니다. 가독성을 위해 일부 적합성 요구사항은 발행자에 대한 요구처럼 기술되지만, 그런 요구들은 암묵적으로 문서 자체에 적용됩니다. 모든 문서는 발행자를 가진다고 가정합니다.

적합 문서는 Activity Streams 1.0의 폐기/구식 문법을 포함해서는 안 됩니다. 적합 문서는 Activity Vocabulary의 속성과 타입을 포함해야 합니다. 다른 어휘를 사용하는 적합 문서는 C절의 예시처럼 동등한 Activity Vocabulary 속성과 타입도 포함해야 합니다. 적합 문서는 2절에 명시된 대로 JSON-LD 또는 기타 직렬화 형식에서 본 사양이 허용하지 않은 기능을 사용해서는 안 됩니다. 적합 문서가 Activity Streams 2.0 Vocabulary에서 정의한 것 외의 타입/속성을 포함하는 경우 5절의 확장성 기능을 사용해야 합니다.

문서의 예시(포괄적 목록 아님):

• actor를 나타내는 문서
• 객체(Object)를 나타내는 문서
• 활동(Activity)을 나타내는 문서
• actor가 한 활동들의 집합(Collection)을 나타내는 문서
• 객체에 대해 일어난 활동들의 집합을 나타내는 문서
• 특정 actor 또는 객체를 대상으로 한 활동들의 집합을 나타내는 문서

9.2 구현체

적합한 구현체란 적합 문서를 발행, 저장, 분석, 소비 혹은 기타 방식으로 처리하는 소프트웨어를 말합니다. 구현체는 크게 발행자와 소비자의 두 종류가 있습니다.