API REST de la marketplace marocaine d’influence Wassit. Recherchez les créateurs, créez des commandes, gérez les livrables, les paiements en escrow et les webhooks. Tous les montants sont en MAD par défaut ; la conversion EUR/USD/GBP/CAD est exposée via `/v1/fx`.
Every call must be signed via a private API key sent in the X-API-Key header, or via a bearer token Authorization: Bearer sk_live_*. An OAuth 2.0 flow will be offered for multi-user integrations.
# En-tête X-API-Keycurl https://api.wassit.ma/v1/account/me \ -H "X-API-Key: sk_live_REPLACE_ME" # En-tête Authorization Bearercurl https://api.wassit.ma/v1/account/me \ -H "Authorization: Bearer sk_live_REPLACE_ME"Profils publics des créateurs vérifiés.
/v1/creatorsRenvoie la liste paginée des créateurs publics, filtrable par niche, ville et seuil d’abonnés.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| cursor | query | string | no | Curseur de pagination renvoyé par la réponse précédente. cur_eyJpZCI6Im9yZF83SzJNOVAifQ |
| limit | query | integer | no | Nombre maximum d’éléments par page (1 à 100). 20 |
| niche | query | string | no | Filtrer par niche (fashion, beauty, food, tech...). fashion |
| city | query | string | no | Filtrer par ville marocaine. Casablanca |
| minFollowers | query | integer | no | Nombre minimum d’abonnés. 10000 |
| Status | Schema | Description |
|---|---|---|
200 | Pagination & object | Liste paginée de créateurs. |
401 | ApiError | Jeton manquant, expiré ou révoqué. |
{ "object": "list", "hasMore": true, "nextCursor": "cur_eyJpZCI6InNhbG1hZWxpZHJpc3NpIn0", "data": [ { "handle": "salmaelidrissi", "displayName": "Salma El Idrissi", "avatarUrl": "https://cdn.wassit.ma/creators/salmaelidrissi.jpg", "bio": "Créatrice mode & lifestyle basée à Casablanca. Bilingue FR/AR.", "city": "Casablanca", "niches": [ "fashion", "lifestyle", "beauty" ], "followers": 184200, "engagementRate": 4.7, "languages": [ "fr", "ar", "en" ], "verified": true, "address": { "line1": "12 rue Ibn Khaldoun", "city": "Casablanca", "region": "Casablanca-Settat", "postalCode": "20000", "country": "MA" } } ]}Langage : json/v1/creators/{handle}Renvoie le profil public détaillé d’un créateur via son handle.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| handle | path | string | yes | Identifiant public du créateur. salmaelidrissi |
| Status | Schema | Description |
|---|---|---|
200 | Creator | Profil créateur. |
404 | ApiError | Ressource introuvable. |
{ "handle": "salmaelidrissi", "displayName": "Salma El Idrissi", "avatarUrl": "https://cdn.wassit.ma/creators/salmaelidrissi.jpg", "bio": "Créatrice mode & lifestyle basée à Casablanca. Bilingue FR/AR.", "city": "Casablanca", "niches": [ "fashion", "lifestyle", "beauty" ], "followers": 184200, "engagementRate": 4.7, "languages": [ "fr", "ar", "en" ], "verified": true, "address": { "line1": "12 rue Ibn Khaldoun", "city": "Casablanca", "region": "Casablanca-Settat", "postalCode": "20000", "country": "MA" }}Langage : jsonOffres publiées par les créateurs.
/v1/packagesListe les offres publiées, filtrable par créateur, niche et fourchette de budget en MAD.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| cursor | query | string | no | Curseur de pagination renvoyé par la réponse précédente. cur_eyJpZCI6Im9yZF83SzJNOVAifQ |
| limit | query | integer | no | Nombre maximum d’éléments par page (1 à 100). 20 |
| creatorHandle | query | string | no | Restreindre aux packages d’un créateur donné. salmaelidrissi |
| niche | query | string | no | Filtrer par niche. fashion |
| minPriceMad | query | integer | no | Prix plancher en MAD. 2000 |
| maxPriceMad | query | integer | no | Prix plafond en MAD. 15000 |
| Status | Schema | Description |
|---|---|---|
200 | Pagination & object | Liste paginée de packages. |
401 | ApiError | Jeton manquant, expiré ou révoqué. |
{ "object": "list", "hasMore": false, "nextCursor": null, "data": [ { "id": "pkg_reel_30s_salma", "creatorHandle": "salmaelidrissi", "title": "Reel Instagram 30 secondes", "description": "Vidéo Reel verticale de 30s avec montage, voix-off et hashtags proposés.", "format": "reel", "deliveryDays": 7, "revisionsIncluded": 2, "price": { "amount": 8500, "currency": "MAD" }, "priceMad": 8500, "niche": "fashion", "active": true } ]}Langage : jsonCycle de vie des commandes : création, paiement, livraison, litige.
/v1/ordersCrée une commande pour le compte d’une marque. Le paiement est capturé en escrow lors de l’appel à `/pay`.
{ "packageId": "pkg_reel_30s_salma", "brief": "Lancement du parfum Atlas N°7 : ambiance rosée, plan large sur la bouteille, mention #AtlasN7.", "deliveryDate": "2026-06-04", "hashtags": [ "#AtlasN7", "#MadeInMorocco" ]}Langage : json| Status | Schema | Description |
|---|---|---|
201 | Order | Commande créée, en attente de paiement. |
400 | ApiError | Le corps de requête est invalide. |
401 | ApiError | Jeton manquant, expiré ou révoqué. |
{ "id": "ord_7K2M9P", "reference": "WST-2026-00042", "packageId": "pkg_reel_30s_salma", "creatorHandle": "salmaelidrissi", "brandId": "org_atlas_cosmetics", "status": "pending_payment", "amount": { "amount": 8500, "currency": "MAD" }, "platformFee": { "amount": 1275, "currency": "MAD" }, "brief": "Lancement du parfum Atlas N°7 : ambiance rosée, plan large sur la bouteille, mention #AtlasN7.", "proofUrl": null, "createdAt": "2026-05-18T10:24:00Z", "updatedAt": "2026-05-21T08:00:00Z", "escrowReleaseAt": "2026-06-04T12:00:00Z"}Langage : json/v1/orders/{id}Renvoie l’état détaillé, le brief et la timeline d’une commande.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Identifiant de la commande (`ord_*`). ord_7K2M9P |
| Status | Schema | Description |
|---|---|---|
200 | Order | Détail de la commande. |
404 | ApiError | Ressource introuvable. |
{ "id": "ord_7K2M9P", "reference": "WST-2026-00042", "packageId": "pkg_reel_30s_salma", "creatorHandle": "salmaelidrissi", "brandId": "org_atlas_cosmetics", "status": "paid", "amount": { "amount": 8500, "currency": "MAD" }, "platformFee": { "amount": 1275, "currency": "MAD" }, "brief": "Lancement du parfum Atlas N°7 : ambiance rosée, plan large sur la bouteille, mention #AtlasN7.", "proofUrl": null, "createdAt": "2026-05-18T10:24:00Z", "updatedAt": "2026-05-21T08:00:00Z", "escrowReleaseAt": "2026-06-04T12:00:00Z"}Langage : json/v1/orders/{id}/payCapture le paiement en escrow. Cet endpoint est mocké en bac à sable : aucune carte n’est débitée réellement.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Identifiant de la commande (`ord_*`). ord_7K2M9P |
{ "method": "cmi", "paymentMethodId": "pm_cmi_demo"}Langage : json| Status | Schema | Description |
|---|---|---|
200 | Order | Paiement capturé, commande passée à `paid`. |
400 | ApiError | Le corps de requête est invalide. |
404 | ApiError | Ressource introuvable. |
{ "id": "ord_7K2M9P", "reference": "WST-2026-00042", "packageId": "pkg_reel_30s_salma", "creatorHandle": "salmaelidrissi", "brandId": "org_atlas_cosmetics", "status": "paid", "amount": { "amount": 8500, "currency": "MAD" }, "platformFee": { "amount": 1275, "currency": "MAD" }, "brief": "Lancement du parfum Atlas N°7 : ambiance rosée, plan large sur la bouteille, mention #AtlasN7.", "proofUrl": null, "createdAt": "2026-05-18T10:24:00Z", "updatedAt": "2026-05-21T08:00:00Z", "escrowReleaseAt": "2026-06-04T12:00:00Z"}Langage : json/v1/orders/{id}/proofLe créateur transmet l’URL publique de la publication et les métriques associées.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Identifiant de la commande (`ord_*`). ord_7K2M9P |
{ "proofUrl": "https://www.instagram.com/reel/Cxy_demo/", "metrics": { "views": 18400, "likes": 1320, "saves": 86 }, "note": "Publié ce matin 9h. Engagement initial conforme aux estimations."}Langage : json| Status | Schema | Description |
|---|---|---|
200 | Order | Preuve enregistrée, commande passée à `proof_submitted`. |
404 | ApiError | Ressource introuvable. |
{ "id": "ord_7K2M9P", "reference": "WST-2026-00042", "packageId": "pkg_reel_30s_salma", "creatorHandle": "salmaelidrissi", "brandId": "org_atlas_cosmetics", "status": "proof_submitted", "amount": { "amount": 8500, "currency": "MAD" }, "platformFee": { "amount": 1275, "currency": "MAD" }, "brief": "Lancement du parfum Atlas N°7 : ambiance rosée, plan large sur la bouteille, mention #AtlasN7.", "proofUrl": "https://www.instagram.com/reel/Cxy_demo/", "createdAt": "2026-05-18T10:24:00Z", "updatedAt": "2026-05-21T08:00:00Z", "escrowReleaseAt": "2026-06-04T12:00:00Z"}Langage : json/v1/orders/{id}/approveLa marque valide la livraison ; le paiement est libéré au créateur sous 24h ouvrées.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Identifiant de la commande (`ord_*`). ord_7K2M9P |
| Status | Schema | Description |
|---|---|---|
200 | Order | Commande passée à `completed`. |
404 | ApiError | Ressource introuvable. |
{ "id": "ord_7K2M9P", "reference": "WST-2026-00042", "packageId": "pkg_reel_30s_salma", "creatorHandle": "salmaelidrissi", "brandId": "org_atlas_cosmetics", "status": "completed", "amount": { "amount": 8500, "currency": "MAD" }, "platformFee": { "amount": 1275, "currency": "MAD" }, "brief": "Lancement du parfum Atlas N°7 : ambiance rosée, plan large sur la bouteille, mention #AtlasN7.", "proofUrl": null, "createdAt": "2026-05-18T10:24:00Z", "updatedAt": "2026-05-21T08:00:00Z", "escrowReleaseAt": "2026-06-04T12:00:00Z"}Langage : json/v1/orders/{id}/revisionLa marque demande une révision du livrable selon les quotas du package.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Identifiant de la commande (`ord_*`). ord_7K2M9P |
{ "note": "Merci de retravailler le cadrage final pour mieux faire apparaitre le flacon."}Langage : json| Status | Schema | Description |
|---|---|---|
200 | Order | Commande passée à `revision_requested`. |
404 | ApiError | Ressource introuvable. |
{ "id": "ord_7K2M9P", "reference": "WST-2026-00042", "packageId": "pkg_reel_30s_salma", "creatorHandle": "salmaelidrissi", "brandId": "org_atlas_cosmetics", "status": "revision_requested", "amount": { "amount": 8500, "currency": "MAD" }, "platformFee": { "amount": 1275, "currency": "MAD" }, "brief": "Lancement du parfum Atlas N°7 : ambiance rosée, plan large sur la bouteille, mention #AtlasN7.", "proofUrl": null, "createdAt": "2026-05-18T10:24:00Z", "updatedAt": "2026-05-21T08:00:00Z", "escrowReleaseAt": "2026-06-04T12:00:00Z"}Langage : json/v1/orders/{id}/disputeOuvre un litige formel : un médiateur Wassit prend le dossier sous 48h ouvrées.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Identifiant de la commande (`ord_*`). ord_7K2M9P |
{ "reason": "content_off_brief", "description": "Le brief mentionnait un fond clair, la vidéo est tournée de nuit."}Langage : json| Status | Schema | Description |
|---|---|---|
200 | Order | Litige enregistré, commande passée à `disputed`. |
404 | ApiError | Ressource introuvable. |
{ "id": "ord_7K2M9P", "reference": "WST-2026-00042", "packageId": "pkg_reel_30s_salma", "creatorHandle": "salmaelidrissi", "brandId": "org_atlas_cosmetics", "status": "disputed", "amount": { "amount": 8500, "currency": "MAD" }, "platformFee": { "amount": 1275, "currency": "MAD" }, "brief": "Lancement du parfum Atlas N°7 : ambiance rosée, plan large sur la bouteille, mention #AtlasN7.", "proofUrl": null, "createdAt": "2026-05-18T10:24:00Z", "updatedAt": "2026-05-21T08:00:00Z", "escrowReleaseAt": "2026-06-04T12:00:00Z"}Langage : jsonAbonnements aux événements asynchrones.
/v1/webhooksRenvoie tous les abonnements webhook actifs pour l’organisation.
| Status | Schema | Description |
|---|---|---|
200 | Pagination & object | Liste d’abonnements. |
401 | ApiError | Jeton manquant, expiré ou révoqué. |
{ "object": "list", "hasMore": false, "nextCursor": null, "data": [ { "id": "whk_01HQRB1C7N", "url": "https://hooks.atlas-cosmetics.ma/wassit", "events": [ "order.created", "order.completed" ], "secret": "whsec_HxJpQ8R2zT...", "active": true, "createdAt": "2026-05-10T09:00:00Z" } ]}Langage : json/v1/webhooksCrée un nouvel abonnement webhook. Un `secret` HMAC est renvoyé une seule fois.
{ "url": "https://hooks.atlas-cosmetics.ma/wassit", "events": [ "order.created", "order.completed", "order.disputed" ]}Langage : json| Status | Schema | Description |
|---|---|---|
201 | WebhookSubscription | Abonnement créé. |
400 | ApiError | Le corps de requête est invalide. |
401 | ApiError | Jeton manquant, expiré ou révoqué. |
{ "id": "whk_01HQRB1C7N", "url": "https://hooks.atlas-cosmetics.ma/wassit", "events": [ "order.created", "order.completed", "order.disputed" ], "secret": "whsec_HxJpQ8R2zT...", "active": true, "createdAt": "2026-05-21T12:00:00Z"}Langage : json/v1/webhooks/{id}Supprime un abonnement webhook. Opération irréversible.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Identifiant de l’abonnement webhook (`whk_*`). whk_01HQRB1C7N |
| Status | Schema | Description |
|---|---|---|
204 | — | Webhook supprimé. |
404 | ApiError | Ressource introuvable. |
Informations sur l’organisation appelante.
/v1/account/meRenvoie l’organisation appelante, les scopes accordés et le quota de rate-limit.
| Status | Schema | Description |
|---|---|---|
200 | Account | Informations sur le compte appelant. |
401 | ApiError | Jeton manquant, expiré ou révoqué. |
{ "organization": "atlas-cosmetics", "scopes": [ "creators.read", "orders.write", "webhooks.manage" ], "rateLimit": 600, "environment": "live", "contactEmail": "[email protected]"}Langage : jsonTransactions, payouts et factures.
/v1/transactionsRenvoie la liste paginée des transactions comptables (charges, payouts, frais).
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| cursor | query | string | no | Curseur de pagination renvoyé par la réponse précédente. cur_eyJpZCI6Im9yZF83SzJNOVAifQ |
| limit | query | integer | no | Nombre maximum d’éléments par page (1 à 100). 20 |
| orderId | query | string | no | Filtrer par commande. ord_7K2M9P |
| type | query | string | no | Filtrer par type de transaction. payout |
| Status | Schema | Description |
|---|---|---|
200 | Pagination & object | Liste de transactions. |
401 | ApiError | Jeton manquant, expiré ou révoqué. |
{ "object": "list", "hasMore": false, "nextCursor": null, "data": [ { "id": "tx_01HQR9X4F2", "orderId": "ord_7K2M9P", "type": "charge", "amount": { "amount": 8500, "currency": "MAD" }, "method": "cmi", "createdAt": "2026-05-18T10:25:11Z", "invoiceUrl": "https://api.wassit.ma/v1/invoices/inv_01HQR9X4F2.pdf" } ]}Langage : jsonRecherche plein texte.
/v1/search/creatorsRecherche plein texte sur le nom, le handle et la biographie des créateurs.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | yes | Texte de recherche (au moins 2 caractères). salma |
| limit | query | integer | no | Nombre maximum d’éléments par page (1 à 100). 20 |
| Status | Schema | Description |
|---|---|---|
200 | Pagination & object | Résultats de recherche. |
400 | ApiError | Le corps de requête est invalide. |
{ "object": "list", "hasMore": false, "nextCursor": null, "data": [ { "handle": "salmaelidrissi", "displayName": "Salma El Idrissi", "avatarUrl": "https://cdn.wassit.ma/creators/salmaelidrissi.jpg", "bio": "Créatrice mode & lifestyle basée à Casablanca. Bilingue FR/AR.", "city": "Casablanca", "niches": [ "fashion", "lifestyle", "beauty" ], "followers": 184200, "engagementRate": 4.7, "languages": [ "fr", "ar", "en" ], "verified": true, "address": { "line1": "12 rue Ibn Khaldoun", "city": "Casablanca", "region": "Casablanca-Settat", "postalCode": "20000", "country": "MA" } } ]}Langage : jsonTaux de change indicatifs MAD.
/v1/fxRenvoie la table des taux indicatifs MAD vers EUR/USD/GBP/CAD. Mise à jour quotidienne.
| Status | Schema | Description |
|---|---|---|
200 | FxRates | Taux indicatifs. |
{ "baseCurrency": "MAD", "rates": { "EUR": 0.0918, "USD": 0.0996, "GBP": 0.0782, "CAD": 0.1358 }, "updatedAt": "2026-05-21T06:00:00Z"}Langage : jsonObjects returned or expected by the API. $ref references point to these definitions.
Montant monétaire avec devise ISO-4217.
| Field | Type | Required | Description |
|---|---|---|---|
| amount | integer | yes | Montant en unité mineure (centimes) ou entier MAD. 8500 |
| currency | enum(5) | yes | Code devise ISO-4217. MAD |
Adresse postale marocaine.
| Field | Type | Required | Description |
|---|---|---|---|
| line1 | string | no | 12 rue Ibn Khaldoun |
| line2 | string | no | Résidence Al Andalous, Apt 4B |
| city | string | yes | Casablanca |
| region | string | no | Casablanca-Settat |
| postalCode | string | no | 20000 |
| country | string | yes | Code pays ISO-3166 alpha-2. MA |
Cycle de vie d’une commande Wassit.
pending_paymentpaidin_productionproof_submittedrevision_requestedcompleteddisputedcancelledrefundedpaidLangage : jsonProfil public d’un créateur vérifié sur Wassit.
| Field | Type | Required | Description |
|---|---|---|---|
| handle | string | yes | Identifiant unique (slug) du créateur. salmaelidrissi |
| displayName | string | yes | Salma El Idrissi |
| avatarUrl | string<uri> | no | https://cdn.wassit.ma/creators/salmaelidrissi.jpg |
| bio | string | no | Créatrice mode & lifestyle basée à Casablanca. Bilingue FR/AR. |
| city | string | yes | Casablanca |
| niches | string[] | yes | ["fashion","lifestyle","beauty"] |
| followers | integer | yes | 184200 |
| engagementRate | number<float> | no | Taux d’engagement moyen sur 30 jours (pourcentage). 4.7 |
| languages | string[] | no | ["fr","ar","en"] |
| verified | boolean | no | true |
| address | Address | no |
Offre publiée par un créateur (story, reel, post UGC...).
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | yes | pkg_reel_30s_salma |
| creatorHandle | string | yes | salmaelidrissi |
| title | string | yes | Reel Instagram 30 secondes |
| description | string | no | Vidéo Reel verticale de 30s avec montage, voix-off et hashtags proposés. |
| format | enum(6) | yes | reel |
| deliveryDays | integer | no | 7 |
| revisionsIncluded | integer | no | 2 |
| price | Money | yes | |
| priceMad | integer | no | Prix en MAD (raccourci, sans objet Money). 8500 |
| niche | string | no | fashion |
| active | boolean | no | true |
Commande passée par une marque auprès d’un créateur.
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | yes | ord_7K2M9P |
| reference | string | yes | Référence humaine pour la facturation. WST-2026-00042 |
| packageId | string | yes | pkg_reel_30s_salma |
| creatorHandle | string | no | salmaelidrissi |
| brandId | string | no | org_atlas_cosmetics |
| status | OrderStatus | yes | |
| amount | Money | yes | |
| platformFee | Money | no | |
| brief | string | no | Lancement du parfum Atlas N°7 : ambiance rosée, plan large sur la bouteille, mention #AtlasN7. |
| proofUrl | string<uri> | no | https://www.instagram.com/reel/Cxy_demo/ |
| createdAt | string<date-time> | no | 2026-05-18T10:24:00Z |
| updatedAt | string<date-time> | no | 2026-05-21T08:00:00Z |
| escrowReleaseAt | string<date-time> | no | 2026-06-04T12:00:00Z |
Mouvement comptable lié à une commande.
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | yes | tx_01HQR9X4F2 |
| orderId | string | yes | ord_7K2M9P |
| type | enum(5) | yes | charge |
| amount | Money | yes | |
| method | enum(5) | no | cmi |
| createdAt | string<date-time> | yes | 2026-05-18T10:25:11Z |
| invoiceUrl | string<uri> | no | https://api.wassit.ma/v1/invoices/inv_01HQR9X4F2.pdf |
Format unifié des erreurs renvoyées par l’API.
| Field | Type | Required | Description |
|---|---|---|---|
| error | object | yes |
Enveloppe de pagination par curseur.
| Field | Type | Required | Description |
|---|---|---|---|
| object | enum(1) | yes | list |
| data | object[] | yes | |
| hasMore | boolean | yes | true |
| nextCursor | string | no | cur_eyJpZCI6Im9yZF83SzJNOVAifQ |
| total | integer | no | 312 |
Abonnement à un ou plusieurs événements webhook.
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | yes | whk_01HQRB1C7N |
| url | string<uri> | yes | https://hooks.atlas-cosmetics.ma/wassit |
| events | string[] | yes | ["order.created","order.completed","order.disputed"] |
| secret | string | no | Clé partagée pour signer les payloads (HMAC-SHA256). whsec_HxJpQ8R2zT... |
| active | boolean | no | true |
| createdAt | string<date-time> | no | 2026-05-10T09:00:00Z |
Compte appelant : organisation, scopes et quotas.
| Field | Type | Required | Description |
|---|---|---|---|
| organization | string | yes | atlas-cosmetics |
| scopes | string[] | yes | ["creators.read","orders.write","webhooks.manage"] |
| rateLimit | integer | yes | 600 |
| environment | enum(2) | yes | live |
| contactEmail | string<email> | no | [email protected] |
Table des taux indicatifs depuis MAD.
| Field | Type | Required | Description |
|---|---|---|---|
| baseCurrency | enum(1) | yes | MAD |
| rates | object | yes | {"EUR":0.0918,"USD":0.0996,"GBP":0.0782,"CAD":0.1358} |
| updatedAt | string<date-time> | yes | 2026-05-21T06:00:00Z |
The playground executes real requests with your sandbox keys and hands you the cURL ready to paste. Unsure about a schema? The engineering team answers on WhatsApp.