{"openapi":"3.1.1","info":{"title":"Digital Kitchen Updates API","version":"1.0.0","description":"当社編集の更新案内のみを提供します。第三者の投稿、カタログ全件、社内調査記録は含みません。原則1時間以上の取得間隔、同時接続1、ETagによる条件付きGETをご利用ください。","termsOfService":"https://digital-kitchen.co.jp/terms/","contact":{"url":"https://digital-kitchen.co.jp/contact/"}},"servers":[{"url":"https://digital-kitchen.co.jp"}],"paths":{"/api/public/v1/updates":{"get":{"operationId":"readPublicUpdates","summary":"更新案内を取得する","description":"最大50件。パラメータなし。認証不要。提供フィード内のタイトル・要約は、出典名とリンクを付けて紹介・検索・通知に利用できます（商用を含む）。その他の条件はtermsURL参照。","parameters":[{"name":"If-None-Match","in":"header","schema":{"type":"string"},"description":"前回のETag"}],"responses":{"200":{"description":"更新案内","headers":{"ETag":{"schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Updates"}}}},"304":{"description":"変更なし。本文なし。"},"400":{"description":"取得条件・方法・頻度を確認してください。","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"retryAfterSeconds":{"type":"integer"},"help":{"type":"string"}}}}}},"405":{"description":"取得条件・方法・頻度を確認してください。","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"retryAfterSeconds":{"type":"integer"},"help":{"type":"string"}}}}}},"429":{"description":"アクセス集中。Retry-After秒以上待機して再試行してください。","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"retryAfterSeconds":{"type":"integer"},"help":{"type":"string"}}}}},"headers":{"Retry-After":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"Updates":{"type":"object","required":["schemaVersion","items","recommendedIntervalSeconds","termsURL"],"properties":{"schemaVersion":{"const":1},"title":{"type":"string"},"description":{"type":"string"},"homeURL":{"type":"string","format":"uri"},"feedURL":{"type":"string","format":"uri"},"apiURL":{"type":"string","format":"uri"},"termsURL":{"type":"string","format":"uri"},"recommendedIntervalSeconds":{"type":"integer","const":3600},"items":{"type":"array","maxItems":50,"items":{"type":"object","required":["id","title","summary","url","publishedAt","attribution","rightsURL"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"url":{"type":"string","format":"uri"},"publishedAt":{"type":"string","format":"date-time"},"attribution":{"type":"string"},"rightsURL":{"type":"string","format":"uri"}}}}}}}}}