Passer au contenu principal
PUT
cURL

Autorisations

Authorization
string
header
requis

Comment les applications StockShift se connectent. L'application ouvre /apps/authorize dans le navigateur système avec un défi PKCE S256 et l'empreinte de sa clé d'appareil. Le membre s'y connecte, avec toutes les vérifications qu'applique le Web. Le navigateur renvoie un code à l'application, qui l'échange à POST /apps/token avec le vérificateur PKCE et une preuve DPoP (RFC 9449) signée par la clé d'appareil. La réponse contient un jeton d'accès d'une heure, envoyé comme jeton de type Bearer à chaque appel, et un jeton d'actualisation rotatif de 30 jours. Une actualisation exige une preuve DPoP avec le dernier nonce du serveur, si bien qu'un jeton d'actualisation volé est inutile sans la clé d'appareil. Une session prend fin 180 jours après la connexion au plus tard. Chaque requête d'application porte StockShift-Client: / (), par exemple ios/1.4.2 (311). Sous le minimum de GET /apps/version-policy, un appel reçoit la réponse 426 client_upgrade_required avec le minimum et le lien de la boutique. Sous la version deprecated-below, l'appel fonctionne et la réponse ajoute StockShift-Client-Deprecated: sunset=; minimum=. La connexion et la déconnexion, l'état de l'appareil, le reçu d'effacement, les appels de verrouillage par NIP et la politique de version répondent pour toutes les versions.

Corps

application/json

Le jeton de notification push qu'une application a obtenu d'APNs ou de FCM.

token
string
requis

Le jeton d'appareil d'APNs (hexadécimal) ou le jeton d'enregistrement de FCM, tel que la plateforme l'a donné.

Maximum string length: 4096
Pattern: ^[A-Za-z0-9_:\-]+$
Exemple:

"7d1c2a4f0b6e9c3d8a5f2e1b4c7d0a9e6f3b8c5d2a1e4f7b0c3d6e9a2f5b8c1d"

environment
enum<string> | null

Quels serveurs APNs connaissent le jeton : sandbox pour une application iOS ou macOS compilée depuis Xcode, sinon production, la valeur par défaut.

Options disponibles:
production,
sandbox

Réponse

Aucun contenu