Documentazione
Lista d'attesa
Invia la registrazione alla lista d'attesa tramite l'API dell'applicazione locale.
Tradotto automaticamente dall'inglese. Vedi l'originale in inglese
Invia queste richieste al tuo sidecar in corsa. I valori rimangono in questo browser.
Come funziona
Il sidecar resta in ascolto su una porta di loopback scelta all'avvio e la stampa nel suo file ready linea; usa quell'URL e il file CADCAMFUN_TOKEN è stato iniziato con. Le richieste vanno direttamente da questa pagina a quell'indirizzo.
Il sidecar invia intestazioni CORS solo alle origini Tauri e a http://localhost o http://127.0.0.1 su qualsiasi porto. Dai documenti ospitati il browser blocca la risposta, quindi esegui i documenti localmente (bun run dev in packages/web) per utilizzare il parco giochi, oppure copiare la richiesta come ricciolo. Per sperimentare senza toccare i dati reali, avvia il sidecar con CADCAMFUN_DATA_DIR indicato in una directory usa e getta - vedi la procedura dettagliata dell'API.
Operazioni
1 endpoint nel waitlist gruppo, generato da quello del sidecar Documento OpenAPI. Le operazioni protette richiedono Authorization: Bearer $CADCAMFUN_TOKEN; vedere autenticazione. Comportamenti e limiti sono entrati la guida del sottosistema.
| inviare | /api/waitlist | waitlist.join |
/api/waitlist
waitlist.join Richiede Authorization: Bearer <token>.
{ email: string }
201 oggetto application/json
{ success: true message: string }
400 WaitlistBadRequestEncoded application/json
WaitlistBadRequestEncoded
401 UnauthorizedEncoded application/json
UnauthorizedEncoded
409 WaitlistConflictEncoded application/json
WaitlistConflictEncoded
500 WaitlistInternalEncoded application/json
WaitlistInternalEncoded
Esempio dell'SDK
import { CadCam } from "@cadcamfun/api/sdk"
const client = CadCam.make({
baseUrl: process.env.CADCAMFUN_URL!,
headers: { authorization: `Bearer ${process.env.CADCAMFUN_TOKEN}` },
})
// WaitlistJoinInput
const result = await client.waitlist.join({
email: ""
}) curl
curl --request POST "${CADCAMFUN_URL}/api/waitlist" \
--header "Authorization: Bearer ${CADCAMFUN_TOKEN}" \
--header "Content-Type: application/json" \
--data-binary @request.json Provalo
Schemi
Schemi denominati raggiungibili dai parametri, dai corpi e dalle risposte di questo gruppo. UN ? contrassegna un campo facoltativo; | null contrassegna un campo che può essere presente con un valore nullo.
WaitlistBadRequestEncoded{ _tag: "WaitlistBadRequest" success: false message: string }
WaitlistConflictEncoded{ _tag: "WaitlistConflict" success: false message: string }
WaitlistInternalEncoded{ _tag: "WaitlistInternal" success: false message: string }
Chiamando questo gruppo
Gli ID operazione hanno il formato waitlist.<name>. L'SDK Promise generato (@cadcamfun/api/sdk) ne espone la maggior parte come client.<namespace>.<method>(input), dove input è un oggetto piatto di parametri di percorso e campi del corpo; l'esempio dell'SDK di ciascuna scheda mostra l'esatto accessor e il tipo di input. Non vengono generati caricamenti in più parti, risposte binarie o JavaScript e webhook grezzi; quelle carte mostrano fetch invece.
import { CadCam, ClientError } from "@cadcamfun/api/sdk"
const client = CadCam.make({
baseUrl: process.env.CADCAMFUN_URL!,
headers: { authorization: `Bearer ${process.env.CADCAMFUN_TOKEN}` },
})
try {
await client.projects.list()
} catch (error) {
if (error instanceof ClientError) {
// Transport | UnexpectedStatus | UnsupportedContentType | MalformedResponse | SseEventTooLarge
} else {
// a declared error body: switch on error._tag
}
} Risoluzione dei problemi
| Sintomo | Probabile causa | Aggiustare |
|---|---|---|
| 401 a ogni chiamata | Token di un lancio precedente o mancante Bearer prefisso | Inviare Authorization: Bearer <token> con il gettone con cui è stato avviato il sidecar. |
| 400 prima che accada qualcosa | Il corpo o il parametro non corrisponde allo schema | Confronta il payload con lo schema di richiesta sulla carta. |
| 403 o 404 su un record visibile altrove | Il resoconto della recitazione è diverso | Invia il diritto x-session-tokenoppure utilizzare il profilo locale proprietario del record. |
| 409 | Stato in conflitto, ad esempio un nome duplicato o una testa di ramo obsoleta | Rileggere la risorsa e riprovare con i dati correnti. |
| Prova, dice "bloccato da CORS" | I documenti vengono serviti da un'origine non di loopback | Esegui i documenti localmente o copia la richiesta come curl. |
| Connessione rifiutata | Il sidecar è ripartito su una nuova porta | Leggi il porto dal nuovo ready riga. |