{
  "openapi": "3.1.0",
  "info": {
    "title": "Photolike read-only photography reference",
    "version": "1.0.0",
    "description": "Free public reference. No rendering, private account access or payments. See /agents.md for fidelity, source date and measurement limits."
  },
  "servers": [
    {
      "url": "https://photolike-nine.vercel.app"
    }
  ],
  "paths": {
    "/api/resources/v1": {
      "get": {
        "summary": "Read sourced bodies/lenses and list creative recipes",
        "operationId": "catalog",
        "parameters": [
          {
            "name": "X-Photolike-Agent",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            },
            "description": "Optional unverified agent declaration"
          },
          {
            "name": "X-Photolike-Test",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            },
            "description": "Set for all internal/synthetic QA; excluded from adoption goal"
          },
          {
            "name": "X-Photolike-Channel",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "photolike-skill"
              ]
            },
            "description": "Optional unverified integration label; unknown values are unspecified, no identity is stored."
          }
        ],
        "responses": {
          "200": {
            "description": "Public reference result; look descriptions are creative interpretations, not measured hardware tests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Catalog"
                }
              }
            }
          }
        }
      }
    },
    "/api/resources/v1/kit": {
      "get": {
        "summary": "Check native body/lens compatibility",
        "operationId": "checkKit",
        "parameters": [
          {
            "name": "X-Photolike-Agent",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            },
            "description": "Optional unverified agent declaration"
          },
          {
            "name": "X-Photolike-Test",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            },
            "description": "Set for all internal/synthetic QA; excluded from adoption goal"
          },
          {
            "name": "bodyId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lensId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Photolike-Channel",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "photolike-skill"
              ]
            },
            "description": "Optional unverified integration label; unknown values are unspecified, no identity is stored."
          }
        ],
        "responses": {
          "200": {
            "description": "Public reference result; look descriptions are creative interpretations, not measured hardware tests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KitResult"
                }
              }
            }
          },
          "400": {
            "description": "Unknown or missing IDs"
          }
        }
      }
    },
    "/api/resources/v1/recipes/{id}": {
      "get": {
        "summary": "Read a creative photography recipe",
        "operationId": "readRecipe",
        "parameters": [
          {
            "name": "X-Photolike-Agent",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            },
            "description": "Optional unverified agent declaration"
          },
          {
            "name": "X-Photolike-Test",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            },
            "description": "Set for all internal/synthetic QA; excluded from adoption goal"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Photolike-Channel",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "photolike-skill"
              ]
            },
            "description": "Optional unverified integration label; unknown values are unspecified, no identity is stored."
          }
        ],
        "responses": {
          "200": {
            "description": "Public reference result; look descriptions are creative interpretations, not measured hardware tests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Recipe"
                }
              }
            }
          },
          "404": {
            "description": "Unknown recipe ID"
          }
        }
      }
    },
    "/api/resources/v1/visit": {
      "get": {
        "summary": "Request a fixed redirect to the human landing page",
        "operationId": "visitStudio",
        "parameters": [
          {
            "name": "X-Photolike-Agent",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            },
            "description": "Optional unverified agent declaration"
          },
          {
            "name": "X-Photolike-Test",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            },
            "description": "Set for all internal/synthetic QA; excluded from adoption goal"
          },
          {
            "name": "X-Photolike-Channel",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "photolike-skill"
              ]
            },
            "description": "Optional unverified integration label; unknown values are unspecified, no identity is stored."
          }
        ],
        "responses": {
          "302": {
            "description": "Redirect to landing page; a request is not proof a human arrived",
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "KitResult": {
        "type": "object",
        "required": [
          "compatible",
          "bodyId",
          "lensId",
          "basis",
          "caveat",
          "checkedAt",
          "visit"
        ],
        "properties": {
          "compatible": {
            "type": "boolean"
          },
          "bodyId": {
            "type": "string"
          },
          "lensId": {
            "type": "string"
          },
          "basis": {
            "type": "string"
          },
          "caveat": {
            "type": "string"
          },
          "checkedAt": {
            "type": "string"
          },
          "visit": {
            "type": "string"
          },
          "source": {
            "type": "string"
          }
        }
      },
      "Catalog": {
        "type": "object",
        "required": [
          "version",
          "bodies",
          "lenses",
          "recipes",
          "caveat",
          "capabilities"
        ],
        "properties": {
          "version": {
            "type": "integer"
          },
          "caveat": {
            "type": "string"
          },
          "bodies": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "lenses": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "recipes": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "capabilities": {
            "type": "object"
          }
        }
      },
      "Recipe": {
        "type": "object",
        "required": [
          "id",
          "name",
          "bodyId",
          "lensId",
          "aperture",
          "caveat",
          "citation",
          "visit"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "bodyId": {
            "type": "string"
          },
          "lensId": {
            "type": "string"
          },
          "aperture": {
            "type": "string"
          },
          "caveat": {
            "type": "string"
          },
          "citation": {
            "type": "string"
          },
          "visit": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "fieldTip": {
            "type": "string"
          },
          "fieldPractice": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "type": "object",
                "required": [
                  "category",
                  "purpose",
                  "try",
                  "inspect",
                  "watchFor",
                  "source",
                  "authoredBy",
                  "reviewedAt",
                  "sourcePublicationDate"
                ],
                "properties": {
                  "category": {
                    "type": "string"
                  },
                  "purpose": {
                    "type": "string"
                  },
                  "try": {
                    "type": "string"
                  },
                  "inspect": {
                    "type": "string"
                  },
                  "watchFor": {
                    "type": "string"
                  },
                  "source": {
                    "type": "string"
                  },
                  "authoredBy": {
                    "type": "string"
                  },
                  "reviewedAt": {
                    "type": "string"
                  },
                  "sourcePublicationDate": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              }
            ],
            "description": "Photolike teaching adaptation for a future photograph, distinct from the creative simulated look."
          }
        }
      }
    }
  }
}
