API

Upload service and syndication feeds for NEWPALMYRA

Upload service

JSON REST API at /api/v1/. In local development with Zola on port 4080, the browser calls the API service directly on port 18080.

Method	Path	Auth	Description
GET	/api/v1/health	None	Health check
POST	/api/v1/keys/request	None	Request an upload API key (queued for review)
POST	/api/v1/image-subscribe	None	Join the queue for a personalized NEWPALMYRA image
POST	/api/v1/upload	X-API-Key	Upload a reference photo or asset (multipart form)

Upload request

POST /api/v1/upload accepts multipart/form-data with fields file, title, description, and optional monument. Include header X-API-Key: YOUR_KEY. Submissions are stored under CC0.

Image subscribe request

POST /api/v1/image-subscribe accepts JSON {"email": "you@example.com"} and returns 202 Accepted when queued.

Admin console

Web UI at /admin on the API service (e.g. http://localhost:18080/admin in dev). Requires an admin API key created via make api-key-create EMAIL=you@example.com.

Admin endpoints under /api/v1/admin/* manage key requests, API keys, photo submissions, the image queue, and SMTP setup (saved to data/api/smtp.json). Contributor keys are issued from the admin console with the requester's email.

Feeds

Atom feeds for site archives. Subscribe in your feed reader or poll for updates.

Feed	Format	URL
News	Atom 1.0	/news/atom.xml
Press	Atom 1.0	/posts/atom.xml

Press articles are published under /posts/ and mirrored at /press/. The press feed includes all press entries sorted by date.

Contact

API key requests and questions: info@newpalmyra.org