Create an access sheet

Beyond plan quota, returns 402 for overage (0.50 USDC Agent / 0.25 Fleet). Retry with PAYMENT-SIGNATURE. Write the guest flip-book in instructions (Markdown). Full playbook: /llms.txt.

post/api/agent/fiches

Request

  • Base URL: https://sesapp.fr
  • URL: https://sesapp.fr/api/agent/fiches
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Replay-safe POST. Same key + same agent returns the cached 2xx body (process-local, up to 24 h). CORS: send this header; response may include Idempotency-Replayed.

Request body

namestring required
formattedAddressstring required
instructionsstring

Markdown flip-book shown to the guest (this field). Cover (map, name, formattedAddress, accessCode) is generated — do not repeat it here. Split pages with a line containing only --- . Supported: # ## ### headings, paragraphs, bold, italic, - / 1. lists, label, alt. Photos: https URLs (GCS via the host app, or your own CDN). Agents send URLs, no file upload. Never put wifiPassword in Markdown; it is unlocked only within 150 m via GPS. Intent hrefs: sesapp:wifi (needs wifiName + wifiPassword) and sesapp:contact (needs phoneNumber). Guest-facing labels: [Ajouter le WiFi] / [Ajouter le contact]. If you omit those links but set the fields, SesApp appends WiFi/contact pages. Example:

Bienvenue

Parking au fond à gauche.

Façade

Arrivée

Sonnette à gauche.

Itinéraire

Ajouter le WiFi

Ajouter le contact

latnumber

Latitude for the cover map and WiFi geofence.

lonnumber

Longitude for the cover map and WiFi geofence.

wifiNamestring

SSID. Required for sesapp:wifi. Hidden until the guest is within 150 m if wifiPassword is set.

wifiPasswordstring

Never put this in instructions. Unlocked on the guest link within 150 m of lat/lon.

accessCodestring

Shown on the generated cover page.

phoneNumberstring

Required for sesapp:contact. E.164 preferred.

locale'fr' | 'en'

Guest chrome language. Markdown stays as written. Omit to follow Accept-Language / ?lang=.

Example request

{
  "instructions": "# Bienvenue\nParking au fond à gauche.\n\n![Façade](https://example.com/facade.jpg)\n\n---\n\n## Arrivée\nSonnette à gauche.\n\n[Itinéraire](https://maps.google.com/?q=48.8566,2.3522)\n\n---\n\n[Ajouter le WiFi](sesapp:wifi)\n\n---\n\n[Ajouter le contact](sesapp:contact)"
}

Response

Created

Changes

No recorded changes to this operation across all 1 revision of this API.