Skip to main content

Endpoint

GET /api/projects/{id}

Authentication

This endpoint does not require authentication. It is publicly accessible.

Description

Retrieves a specific photography project by its unique identifier, including all associated detail images.

Path Parameters

id
string (GUID)
required
The unique identifier of the project to retrieve.Format: 3fa85f64-5717-4562-b3fc-2c963f66afa6

Response

id
string (GUID)
Unique identifier for the project.
title
string
Project title.
description
string
Project description.
imageUrl
string
URL of the main project image/cover.
isActive
boolean
Indicates if the project is currently active.
createDate
string (datetime)
ISO 8601 timestamp when the project was created.
details
array
Array of project detail objects containing additional images.

Example Request

curl -X GET http://localhost:5000/api/projects/3fa85f64-5717-4562-b3fc-2c963f66afa6

Example Response

Success (200 OK)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "title": "Wedding Photography 2024",
  "description": "Elegant wedding photography collection featuring romantic moments",
  "imageUrl": "https://example.com/images/wedding-cover.jpg",
  "isActive": true,
  "createDate": "2024-10-16T12:00:00Z",
  "details": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "imageUrl": "https://example.com/images/wedding-1.jpg",
      "isActive": true
    },
    {
      "id": "8d0e7680-8536-51ef-a55c-f18gd2g01bf8",
      "imageUrl": "https://example.com/images/wedding-2.jpg",
      "isActive": true
    },
    {
      "id": "9e1f8791-9647-62fg-b66d-g29he3h12cg9",
      "imageUrl": "https://example.com/images/wedding-3.jpg",
      "isActive": true
    }
  ]
}

Error (404 Not Found)

Returned when no project exists with the specified ID:
{
  "message": "No se encontró el proyecto con Id 3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Error (400 Bad Request)

Returned when the ID format is invalid (not a valid GUID):
{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": {
    "id": [
      "The value 'invalid-id' is not valid."
    ]
  }
}

Notes

  • The ID must be a valid GUID format
  • Returns the project regardless of its isActive status
  • Includes all associated detail images in the response
  • No authentication required - this is a public endpoint

Build docs developers (and LLMs) love