Trecerea în producție
Cheile de producție se deschid după ce integrarea ta demonstrează, în sandbox, că face lucrurile corect. Nu printr-un formular și nu printr-o discuție — ci prin ce a făcut efectiv codul tău.
Toate cele zece verificări sunt scrise mai jos. Le publicăm înainte să începi, pentru că o verificare ascunsă este o capcană, iar o capcană produce integrări făcute pentru test, nu pentru clienți.
Cum funcționează
Creezi o cheie de sandbox, îți construiești integrarea normal, și lista din Setări → API se colorează pe măsură. Când toate zece sunt verzi, apare butonul de cerere. Ne uităm peste ea și îți răspundem — de obicei în aceeași zi.
Cele zece verificări
| # | Verificare | Ce o trece |
|---|---|---|
| 1 | Cheia funcționează | Un GET /v1/me cu răspuns 200. |
| 2 | Ai validat coduri reale | Cel puțin 5 validări reușite, pe cel puțin 3 coduri diferite. |
| 3 | Ai tratat un cod inexistent | O validare care întoarce valid:false, reason:not_found, fără ca apoi să reîncerci în buclă. Clienții scriu greșit coduri toată ziua. |
| 4 | Înregistrezi cu Idempotency-Key | Cel puțin 3 comenzi, fiecare cu propria cheie de idempotență. |
| 5 | O reîncercare nu dublează comanda | Ai retrimis o cerere cu aceeași Idempotency-Key și ai primit înapoi comanda originală, cu replayed: true. |
| 6 | Tratezi ciclul de viață al validării | Ai primit validation_expired sau validation_already_used și nu ai reîncercat identic. Folosește SANDBOXSTALE. |
| 7 | Retururile se întorc | Cel puțin un void. |
| 8 | Tratezi diferit erorile diferite | Ai primit cel puțin două coduri de eroare 4xx distincte și ai reacționat altfel la fiecare. |
| 9 | Raportul e rezonabil | Cel puțin o cincime dintre validările reușite au devenit comenzi. |
| 10 | Cheia nu a plecat de pe server | Niciun apel cu antet Origin sau Referer. |
Despre a zecea
Este singura la care oamenii pică fără să înțeleagă de ce, și cea care salvează cei mai mulți bani.
Orice apel făcut dintr-un browser vine cu un antet Origin. Un apel de pe server nu vine niciodată cu unul. Deci dacă vedem Origin pe o cheie secretă, cheia aceea este în sursa paginii — și oricine o poate citi poate înregistra comenzi în contul tău, poate vedea ce coduri ai și cât a câștigat fiecare colaborator.
Dacă ai nevoie de validare în pagină, fă un endpoint pe serverul tău care apelează Recoma. Cheia rămâne unde îi e locul, iar pagina vorbește cu tine, nu cu noi.
După aprobare
Primești chei rk_live_… imediat. Primele 30 de zile sunt o perioadă de observație: pragurile de alertă sunt mai strânse, pentru că acolo apar hook-urile legate greșit — și tot atunci sunt cel mai ieftin de reparat.
Codurile din sandbox nu se mută în producție, și nici invers. Codurile reale se creează din aplicație sau prin API, cu o cheie live.
Dacă cererea e respinsă
Primești motivul scris, în cont. Repari, și ceri din nou — nu există o limită de încercări și nici o coadă de așteptare între ele.